alsk1992/CloddsBot

# Clodds Agent Integration Guide

**For agents:** This document explains how to integrate with Clodds APIs.

---

## Quick Start

```bash
# Fetch this document
curl https://www.cloddsbot.com/SKILL.md

# Check Clodds health
curl https://compute.cloddsbot.com/health

# ACP - Agent Commerce Protocol

Enable agent-to-agent commerce with on-chain escrow, cryptographic agreements, and service discovery.

## Quick Start

```bash
# Register as an agent
/acp register MyAgent --address <solana_address> --desc "My AI service"

# List a service
/acp list-service <agent_id> --name "LLM Inference" --category llm --price 0.001 --currency SOL

# Find and hire a service
/acp discover "I need image generation" --address <your_address>

# AgentBets

AI-native prediction markets on Solana, built for the Colosseum Agent Hackathon.

## Commands

```
/agentbets markets [query]    Search and list markets
/agentbets market <id>        Show detailed market information
/agentbets opportunities      Find +EV trading opportunities
/agentbets help               Show help
```

# AI Strategy

Convert natural language descriptions into executable trading strategies.

## Commands

```
/strategy "<description>"          Create strategy from natural language
/strategies                        List active strategies
/strategy status <id>              Check strategy status
/strategy cancel <id>              Cancel strategy
/strategy cancel all               Cancel all strategies
/strategy templates                List available templates
/strategy template <name>          Use a template

# Alerts Skill

Set up price alerts to get notified when markets move.

## Commands

### Create Alert
```
/alert "Trump 2028" above 0.50
/alert "Fed rate cut" below 0.30
/alert "Trump 2028" change 5%
```

### List Alerts

# Analytics - Complete API Reference

Analyze trading performance with attribution by edge source, time-of-day analysis, and optimization insights.

---

## Chat Commands

### Performance Overview

```
/analytics                          Performance summary
/analytics today                    Today's performance
/analytics week                     Weekly breakdown

# Arbitrage Service - Complete API Reference

Automated detection and monitoring of arbitrage opportunities across prediction market platforms.

## Supported Platforms

- Polymarket
- Kalshi
- Manifold
- Metaculus
- PredictIt
- Drift
- Betfair
- Smarkets

# Auto-Reply - Complete API Reference

Create rules for automatic responses based on patterns, keywords, and conditions.

---

## Chat Commands

### List Rules

```
/autoreply list                             List all rules
/autoreply active                           Show active rules only
/autoreply stats                            Rule statistics

# Automation - Cron Scheduler

Schedule recurring tasks using cron expressions with preset support.

## Commands

```
/auto list                            - List all scheduled jobs
/auto cron <schedule> <command>       - Create a cron job
/auto remove <id>                     - Remove a job
/auto enable <id>                     - Enable a job
/auto disable <id>                    - Disable a job
/auto trigger <id>                    - Manually run a job
/auto presets                         - Show available schedule presets

# Backtest - Complete API Reference

Validate trading strategies using historical data, walk-forward analysis, and Monte Carlo simulation.

---

## Chat Commands

### Run Backtest

```
/backtest momentum --from 2024-01-01 --to 2024-12-31
/backtest mean-reversion --market "Trump 2028" --days 90
/backtest my-strategy --capital 10000

# Bags.fm - Complete API Coverage

Bags.fm is a Solana token launchpad and trading platform with creator monetization. Creators earn 1% of all trading volume on their tokens.

## Trading

```
/bags quote <amount> <from> to <to>    Get swap quote
/bags swap <amount> <from> to <to>     Execute swap
```

## Discovery

```

# Bankr

Execute crypto trading and DeFi operations using natural language through Bankr's AI agent API.

## Setup

Get your API key from [bankr.bot/api](https://bankr.bot/api) and set:

```bash
[Credential-related source omitted]
```

## Commands

# Betfair Exchange

Full integration with Betfair Exchange, the world's largest sports betting exchange. Trade sports markets using back/lay orders.

## Quick Start

```bash
# Set credentials
export BETFAIR_APP_KEY="your-app-key"
[Credential-related source omitted]

# Search markets
/bf markets football

# Binance Futures

Trade perpetual futures on Binance with up to 125x leverage and full database tracking.

## Quick Start

```bash
# Set credentials
[Credential-related source omitted]
[Credential-related source omitted]

# Check balance
/bf balance

# Botchan - Agent Messaging Layer

The onchain agent messaging layer on Base. Post to feeds, send direct messages, explore other agents.

## How It Works

- Every wallet address has a profile feed
- Post to feeds or message agents directly
- Messages live forever onchain, accessible to any agent

## Commands

### Read (no wallet required)
```

# Bridge - Complete API Reference

Transfer tokens across chains using Wormhole and Circle CCTP protocols.

## Supported Chains

| Chain | Wormhole | CCTP (USDC) |
|-------|----------|-------------|
| Solana | Yes | Yes |
| Ethereum | Yes | Yes |
| Polygon | Yes | Yes |
| Arbitrum | Yes | Yes |
| Optimism | Yes | Yes |
| Avalanche | Yes | Yes |

# Bybit Futures

Trade perpetual futures on Bybit with up to 100x leverage and full database tracking.

## Quick Start

```bash
# Set credentials
[Credential-related source omitted]
[Credential-related source omitted]

# Check balance
/bb balance

# Clanker - Token Deployment

Deploy production-ready ERC20 tokens with built-in Uniswap V4 liquidity pools using the Clanker SDK.

## Setup

```bash
export PRIVATE_KEY=0x...your_private_key
export BASE_RPC_URL=https://mainnet.base.org  # Optional
```

## Commands

### Deployment

# Copy Trading - Complete API Reference

Automatically mirror trades from successful wallets with configurable sizing, delays, and risk controls.

## Features

- **Follow whale wallets** on Polymarket and crypto chains
- **Configurable sizing**: Fixed, proportional, or % of portfolio
- **Trade delay** to avoid detection and front-running
- **Risk limits**: Max position, daily loss limits
- **Stop-loss / Take-profit** monitoring with auto-exit

---

# Copy Trading - Solana

Monitor Solana wallets and automatically copy their trades using Jupiter aggregator.

## Commands

```
/copy add <wallet> [--name "label"] [--mult 1.0] [--max 0.5]   Follow a wallet
/copy remove <wallet|id>                                       Stop following
/copy list                                                     List followed wallets
/copy history [wallet]                                         View trade history
/copy pause <wallet|id>                                        Pause copying
/copy resume <wallet|id>                                       Resume copying
/copy stats                                                    View overall stats

# Credentials - Complete API Reference

Securely store and manage API credentials for trading platforms with AES-256-GCM encryption.

---

## Chat Commands

### Add Credentials

```
/creds add polymarket                       Interactive setup
/creds add kalshi --key abc --secret xyz    Direct setup
/creds add binance                          Add Binance API

# Crypto HFT - Binary Market Trading

Trade Polymarket's crypto binary markets with 4 automated strategies. Just say what you want!

**Available market durations** (pick one):
- **5-minute**: BTC only - ultra-high frequency HFT
- **15-minute**: All assets (BTC, ETH, SOL, XRP) - balanced, most popular
- **1-hour**: All assets - faster swing trading
- **4-hour**: All assets - multi-hour trends
- **Daily**: All assets - position trading, overnight holds

Each round has UP/DOWN token pairs that settle at 0 or 1 using Chainlink price feeds.

Starts in **dry-run mode** by default (no real orders). Test for free before going live!

# DCA (Dollar-Cost Averaging)

Spread orders over time across multiple platforms including Polymarket, Kalshi, PumpFun, Hyperliquid, Binance Futures, Bybit, MEXC, Drift, Opinion.trade, Predict.fun, Orca, Raydium, Virtuals, and Jupiter.

## Commands

```
/dca poly <token-id> <total-$> --per <$> --every <interval>    Polymarket DCA
/dca kalshi <ticker> <total-$> --per <$> --every <interval>    Kalshi DCA
/dca pump <mint> <total-SOL> --per <SOL> --every <interval>    PumpFun DCA
/dca hl <coin> <total-$> --per <$> --every <interval>          Hyperliquid DCA
/dca bf <symbol> <total-$> --per <$> --every <interval>        Binance Futures DCA
/dca bb <symbol> <total-$> --per <$> --every <interval>        Bybit DCA
/dca list                                                       List active DCA orders

# DEX Market Intelligence

Cross-chain, cross-DEX market data powered by DexScreener. No API key needed. Works across Solana, Ethereum, BSC, Base, Arbitrum, and 10+ more chains.

**Use this skill when users ask about:**
- "What's the price of X?" (any token by name or symbol)
- What's trending, what's hot, what's pumping on any chain or DEX
- Top gainers or losers (24h or right now)
- Token volume, liquidity, price changes, transaction counts
- Market data for any token on any chain
- Comparing tokens across different DEXes
- Virtuals Protocol, Clanker, Aerodrome, PumpSwap, Raydium, Uniswap, PancakeSwap tokens
- "What's the most active token right now?"
- "Show me the top movers on Base/Ethereum/Solana"

# Divergence Trading - Spot vs Poly Price Lag

Detects when Binance spot prices move but Polymarket 15-minute binary markets haven't caught up yet. Buys the lagging side and sells when it corrects.

Strategy tags match the CLAUDE.md encoding: `BTC_DOWN_s12-14_w15` (0.12-0.14% move in 15s window).

Starts in **dry-run mode** by default (no real orders).

## Quick Start

```
/div start                     # Dry-run on BTC,ETH,SOL,XRP
/div start BTC,ETH --size 30   # Specific assets + size
/div status                    # Stats, open positions

# Doctor - Complete API Reference

Run system diagnostics, check health status, and troubleshoot issues.

---

## Chat Commands

### Health Checks

```
/doctor                                     Run all diagnostics
/doctor quick                               Quick health check
/doctor full                                Full diagnostic scan

# Drift Protocol

Drift is a Solana DEX for perpetual futures and prediction markets.

## Commands

### Trading
```
/drift long <market> <size> [price]    Open long position
/drift short <market> <size> [price]   Open short position
/drift close <market>                  Close position
/drift cancel [orderId]                Cancel order(s)
```

# Drift Protocol SDK

Direct SDK-based trading on Drift Protocol, Solana's leading perpetual futures DEX. Bypass the gateway requirement with native SDK integration.

## Quick Start

```bash
# Set credentials
export DRIFT_PRIVATE_KEY="your-solana-private-key"
export SOLANA_RPC_URL="https://api.mainnet-beta.solana.com"

# Check balance
/drift balance

# Edge Detection Skill

Compare prediction market prices to external models, polls, and data sources to find potential edge.

## Commands

### Scan for Edge
```
/edge
/edge politics
/edge fed
```

### Compare Specific Market

# Embeddings - Complete API Reference

Configure embedding providers, manage vector storage, and perform semantic search.

---

## Chat Commands

### View Config

```
/embeddings                                 Show current settings
/embeddings status                          Provider status
/embeddings stats                           Cache statistics

# Endaoment Charity Donations

Donate to 501(c)(3) nonprofits onchain via Endaoment smart contracts on Base.

## Contracts (Base)

| Contract | Address |
|----------|---------|
| Registry | `0x237b53bcfbd3a114b549dfec96a9856808f45c94` |
| OrgFundFactory | `0x10fd9348136dcea154f752fe0b6db45fc298a589` |
| USDC | `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` |

## Commands

# ENS Primary Name

Set your primary ENS name on Base and other L2 chains via the ENS Reverse Registrar.

## What It Does

Creates a bi-directional link:
- **Forward:** `name.eth` → `0x1234...` (set in ENS resolver)
- **Reverse:** `0x1234...` → `name.eth` (set via this skill)

## Supported Chains

| Chain | Reverse Registrar |
|-------|-------------------|

# ERC-8004: Trustless Agents

Register your AI agent on Ethereum mainnet with a verifiable on-chain identity.

## What is ERC-8004?

Ethereum standard for trustless agent identity and reputation:
- **Identity Registry** - ERC-721 based agent IDs
- **Reputation Registry** - Feedback and trust signals
- **Validation Registry** - Third-party verification

Website: https://www.8004.org

## Contract Addresses

# Execution Service - Complete API Reference

Execute trades on Polymarket and Kalshi with slippage protection, maker orders, and order management.

## Supported Platforms

| Platform | Order Types | Features |
|----------|-------------|----------|
| Polymarket | Limit, Market, Maker | -0.5% maker rebate, GTC/FOK |
| Kalshi | Limit, Market | US regulated |

---

## Chat Commands

# Farcaster

Interact with the Farcaster decentralized social protocol via Neynar API.

## Setup

Get your API key from [dev.neynar.com](https://dev.neynar.com):

```bash
[Credential-related source omitted]

# Optional: For posting (requires signer)
export NEYNAR_SIGNER_UUID=xxx
```

# Features

View real-time market features and trading signals computed from tick and orderbook data.

## Commands

```
/features get <platform> <marketId>       Get features for a specific market
/features all                             List all tracked markets
/features signals <platform> <marketId>   Get trading signals and recommendations
/features stats                           Show feature engine statistics
/features help                            Show help
```

# Market Feeds - Complete API Reference

Real-time and historical market data from Polymarket, Kalshi, Manifold, Metaculus, PredictIt, Drift, Betfair, and Smarkets.

## Supported Platforms

| Platform | Feed Type | Trading | Data |
|----------|-----------|---------|------|
| Polymarket | WebSocket + RTDS | Yes | Prices, orderbook, trades |
| Kalshi | WebSocket | Yes | Prices, orderbook |
| Betfair | WebSocket | Yes | Odds, volume |
| Smarkets | WebSocket | Yes | Odds, volume |
| Drift | REST | Yes | Prices, funding |
| Manifold | WebSocket | Read-only | Prices, comments |

# VPS Hardening

Security auditing and automated hardening for remote servers.

## Commands

### `/harden audit <host>`
Run security audit against a server. Checks:
- System updates
- Auto-updates configuration
- SSH root login status
- Password authentication
- Firewall status
- Fail2ban status

# Trade History - Complete API Reference

Fetch, sync, and analyze trade history from Polymarket and Kalshi with detailed performance metrics.

---

## Chat Commands

### Fetch & Sync

```
/history fetch                              # Fetch all trades from APIs
/history fetch poly                         # Fetch Polymarket only
/history fetch --from 2024-01-01            # From specific date

# Hyperliquid

Full integration with the dominant perpetual futures DEX. 130+ perp markets, spot trading, HLP vault, TWAP orders.

## Quick Start

```bash
# Set credentials
export HYPERLIQUID_WALLET="0x..."
export HYPERLIQUID_PRIVATE_KEY="0x..."

# Check balance
/hl balance

# Identity - Complete API Reference

Manage user identity, OAuth provider connections, and device authentication.

---

## Chat Commands

### View Identity

```
/identity                                   Show your identity
/identity status                            Auth status
/identity devices                           List linked devices

# Integrations - Complete API Reference

Manage external data sources, add custom connectors, and plug in new data streams for trading bots.

---

## Chat Commands

### List Data Sources

```
/integrations                               List all data sources
/integrations status                        Show source health
/integrations sources                       Available source types

# Jupiter Aggregator

Jupiter finds the best swap routes across all Solana DEXes, plus limit orders and DCA (Dollar Cost Averaging).

## Commands

### Swaps
```
/jup swap <amount> <from> to <to>    Execute swap via Jupiter
/jup quote <amount> <from> to <to>   Get quote without executing
/jup route <from> <to> <amount>      Show detailed route info
```

### Limit Orders

# Kamino Finance

Kamino is Solana's largest lending protocol and liquidity vault provider. Deposit collateral, borrow assets, provide liquidity to automated vaults, and monitor health to avoid liquidation.

## Commands

### Lending
```
/kamino deposit <amount> <token>          Deposit collateral
/kamino withdraw <amount|all> <token>     Withdraw collateral
/kamino borrow <amount> <token>           Borrow assets
/kamino repay <amount|all> <token>        Repay borrowed assets
/kamino obligation                        View your positions
/kamino health                            Check health factor & liquidation risk

# Ledger

Decision audit trail and performance statistics for all trading decisions.

## Commands

```
/ledger list [n] [category]    View recent decisions (with optional filters)
/ledger get <id>               Show detailed decision information
/ledger stats [period]         Decision statistics (24h, 7d, 30d, 90d, all)
/ledger calibration            Confidence accuracy analysis
/ledger help                   Show help
```

# Lighter

On-chain orderbook DEX on Arbitrum. Trade perpetual futures with deep liquidity and low fees.

## Quick Start

```bash
# Set credentials
export EVM_PRIVATE_KEY="0x..."

# Check markets
/lighter markets

# Get price

# MarginFi

MarginFi is a lending and borrowing protocol on Solana. Deposit collateral, borrow assets, and monitor your health factor to avoid liquidation.

## Commands

### Lending
```
/marginfi deposit <amount> <token>     Deposit collateral
/marginfi withdraw <amount|all> <token> Withdraw collateral
/marginfi borrow <amount> <token>      Borrow assets
/marginfi repay <amount|all> <token>   Repay borrowed assets
```

# Market Index - Complete API Reference

Search, discover, and browse markets across all prediction market platforms with advanced filtering and categorization.

---

## Chat Commands

### Search

```
/index search "trump"                       # Search all indexed markets
/index search "election" --platform poly    # Search specific platform
/index search "fed rate" --category finance # Filter by category

# Markets Skill

Use this skill to search for prediction markets and view current prices across platforms.

## Commands

### Search Markets
Search for markets matching a query:
```
/markets trump 2028
/markets fed rate cut
/markets super bowl
```

# MCP - Complete API Reference

Manage Model Context Protocol (MCP) servers, external tools, and AI integrations.

---

## Chat Commands

### Server Management

```
/mcp list                                   List configured MCP servers
/mcp status                                 Check server connection status
/mcp add <name> <command>                   Add new MCP server

# Memory - Complete API Reference

Store and recall user preferences, facts, and notes across conversations. Semantic search powered by vector embeddings.

---

## Chat Commands

### Store Memories

```
/remember preference risk=conservative      Save trading preference
/remember fact BTC halving is in April 2028 Store a fact
/remember note Check ETH before market open Save a note

# Metaculus

Integration with Metaculus, a community forecasting platform. View questions, predictions, and tournaments.

## Quick Start

```bash
# Search questions
/mc search AI

# Get question details
/mc question 12345

# List tournaments

# Meteora DLMM

Meteora uses Dynamic Liquidity Market Maker (DLMM) pools with bin-based pricing.

## Commands

```
/met swap <amount> <from> to <to>    Execute swap
/met quote <amount> <from> to <to>   Get quote
/met pools <token>                   List DLMM pools
```

## Examples

# Meteora DBC

Launch tokens on Meteora's dynamic bonding curves with anti-sniper fees, configurable market caps, and automated DAMM migration.

## Commands

```
/dbc launch <name> <symbol> <desc> [options]    Launch token on bonding curve
/dbc status <mint>                               Check pool status and migration progress
/dbc buy <mint> <amountSOL>                      Buy tokens on curve
/dbc sell <mint> <amountTokens>                  Sell tokens back to curve
/dbc quote <mint> <amount> [--sell]              Get swap quote
/dbc claim <pool> [--partner]                    Claim creator/partner fees
/dbc migrate <command> [args]                    Migration commands (v1, v2, locker, etc)

# Metrics - Complete API Reference

Monitor system health, track performance metrics, and analyze telemetry data.

---

## Chat Commands

### System Metrics

```
/metrics                               Show current metrics
/metrics system                        CPU, memory, latency
/metrics api                           API performance stats

# MEV Protection - Complete API Reference

Protect trades from MEV (Maximal Extractable Value) attacks including sandwich attacks and front-running.

---

## Chat Commands

### Protection Settings

```
/mev                                Show current protection
/mev status                         Protection status
/mev enable                         Enable protection

# MEXC Futures

Trade perpetual futures on MEXC with up to 200x leverage. No KYC required for small amounts.

## Quick Start

```bash
# Set credentials
[Credential-related source omitted]
[Credential-related source omitted]

# Check balance
/mx balance

# Market Making Skill

Automated two-sided quoting on prediction markets with inventory skew, volatility-adjusted spreads, and risk controls.

## Supported Platforms

- Polymarket (post-only maker orders, zero taker fees)
- Kalshi

---

## Chat Commands

### Lifecycle

# Monitoring - Complete API Reference

Monitor system health, track errors, and receive alerts when issues occur.

---

## Chat Commands

### Service Control

```
/monitor start                              # Start monitoring
/monitor stop                               # Stop monitoring
/monitor status                             # Check monitoring status

# News Skill

Track news that affects prediction markets and correlate with price movements.

## Commands

### Recent News
```
/news
/news trump
/news fed
```

### Market-Specific News

# OnchainKit - Build Onchain Apps

Build production-ready onchain applications using Coinbase's React component library.

## Overview

OnchainKit provides ready-to-use components that abstract blockchain complexity:
- No backend infrastructure required
- Works automatically on Base
- Cost-effective transactions (< $0.01 fees)

## Commands

### Project Setup

# Opinion.trade

Full integration with Opinion.trade, a BNB Chain prediction market with on-chain CLOB (Central Limit Order Book).

## Quick Start

```bash
# Set credentials
[Credential-related source omitted]
export OPINION_PRIVATE_KEY="0x..."

# Search markets
/op markets trump

# Opportunity Finder - Complete API Reference

Discover and execute cross-platform arbitrage opportunities across Polymarket, Kalshi, Betfair, Smarkets, Manifold, Metaculus, PredictIt, and Drift.

Based on [arXiv:2508.03474](https://arxiv.org/abs/2508.03474) which found **$40M+ in realized arbitrage** on Polymarket.

## Opportunity Types

| Type | Description | Example |
|------|-------------|---------|
| **Internal** | YES + NO < $1 on same platform | Buy both for guaranteed profit |
| **Cross-Platform** | Same market priced differently | Buy low on A, sell high on B |
| **Combinatorial** | Logical violations (P(A) > P(B) when A implies B) | Trump > Republican |
| **Edge** | Market vs external model (538, polls) | Market 45%, model 52% |

# Orca Whirlpools

Orca is a Solana DEX with concentrated liquidity pools (Whirlpools).

## Commands

```
/orca swap <amount> <from> to <to>   Execute swap
/orca quote <amount> <from> to <to>  Get quote
/orca pools <token>                  List Whirlpools
```

## Examples

# Pairing - Complete API Reference

Pair new users to Clodds, manage trust levels, and control access across channels.

---

## Chat Commands

### Pairing (New Users)

```
/pair                                       Request pairing (generates code)
/pair-code ABC123                           Enter pairing code
/unpair                                     Remove your pairing

# PancakeSwap

Multi-chain AMM DEX with V3 concentrated liquidity. Swap tokens on BNB Chain, Ethereum, Arbitrum, and Base.

## Quick Start

```bash
# Set credentials
export EVM_PRIVATE_KEY="0x..."

# Get a quote
/cake quote BNB USDT 1 --chain bsc

# Execute swap

# Percolator

On-chain Solana perpetual futures with leverage via Percolator protocol.

## Commands

```
/percolator status               Show market state (price, OI, funding, spread)
/percolator positions            View your open positions
/percolator long <size>          Open long position (size in USD)
/percolator short <size>         Open short position (size in USD)
/percolator deposit <amount>     Deposit USDC collateral
/percolator withdraw <amount>    Withdraw USDC collateral
/percolator help                 Show help

# Permissions - Complete API Reference

Manage command execution approvals, tool access policies, and security controls.

---

## Chat Commands

### View Permissions

```
/permissions                                View current permissions
/permissions list                           List all rules
/permissions pending                        View pending approvals

# Plugins - Complete API Reference

Install, manage, and configure plugins to extend Clodds functionality.

---

## Chat Commands

### List Plugins

```
/plugins                                    List installed plugins
/plugins available                          Browse available plugins
/plugins search <query>                     Search plugin registry

# Portfolio Skill

Track your positions and performance across prediction markets and futures exchanges.

## Commands

### View Portfolio
```
/portfolio
/portfolio positions
/portfolio pnl
```

### History

# Portfolio Sync Skill

Real methods to fetch and sync positions from each prediction market platform.

## Polymarket Position Sync

Polymarket positions are held as ERC-1155 tokens on Polygon. Query on-chain balances.

```python
import os
import requests

WALLET = os.getenv("POLY_FUNDER_ADDRESS")
CTF_CONTRACT = "0x4D97DCd97eC945f40cF65F87097ACe5EA0476045"  # Conditional Token Framework

# Positions - Complete API Reference

Manage open positions with automated stop-loss, take-profit, and trailing stop orders.

---

## Chat Commands

### View Positions

```
/positions                          List all positions
/positions poly                     Polymarket positions only
/positions futures                  Futures positions only