### Lighter DEX CLI Quick Start and Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/lighter/SKILL.md

Provides examples of how to interact with the Lighter DEX using its command-line interface (CLI). This includes setting up credentials, checking markets, getting prices, and executing trades like opening and closing positions. It also covers commands for managing orders and account information.

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

# Check markets
/lighter markets

# Get price
/lighter price ETH-USD

# Open positions
/lighter long ETH-USD 1
/lighter short BTC-USD 0.1 45000

# List available markets
/lighter markets

# Get current price
/lighter price <market>

# Show orderbook depth
/lighter book <market>

# Show balances
/lighter balance

# Show open positions
/lighter positions

# List open orders
/lighter orders

# Open long position
/lighter long <market> <size> [price]

# Open short position
/lighter short <market> <size> [price]

# Close position
/lighter close <market>

# Close all positions
/lighter closeall

# Cancel order
/lighter cancel <orderId>

# Cancel all orders
/lighter cancelall

# Examples:
/lighter long ETH-USD 1           # Market long 1 ETH
/lighter long ETH-USD 1 3000      # Limit long at $3,000
/lighter short BTC-USD 0.1        # Market short 0.1 BTC
/lighter close ETH-USD            # Close ETH position
```

--------------------------------

### Unified Solana Trading CLI Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/TRADING.md

Examples demonstrating the usage of the unified Solana trading CLI commands, showing how to perform swaps, get quotes, list pools, and find routes for various tokens.

```bash
/sol swap 1 SOL to USDC
/sol quote 100 USDC to JUP
/sol pools BONK
/sol route SOL USDC

```

--------------------------------

### Install Plugins from Various Sources (TypeScript)

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/plugins/SKILL.md

Provides examples of installing plugins using the Plugin Manager API. Plugins can be installed from the default registry, a direct URL, or a local file path.

```typescript
// Install from registry
await plugins.install('advanced-charts');

// Install from URL
await plugins.install('https://github.com/user/plugin/releases/latest/plugin.zip');

// Install from local path
await plugins.install('/path/to/plugin');
```

--------------------------------

### Binance Futures Bot: Quick Start and Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/binance-futures/SKILL.md

Provides essential commands for setting up API credentials, checking account status, opening and managing futures positions, and retrieving market data. Includes examples for common trading actions and data queries.

```bash
# Set credentials
export BINANCE_API_KEY="your-api-key"
export BINANCE_API_SECRET="your-api-secret"

# Check balance
/bf balance

# Open position
/bf long BTCUSDT 0.01 10x

# View stats
/bf stats

/bf long BTCUSDT 0.01 10x      # 10x leveraged long
/bf short ETHUSDT 0.1 20x      # 20x leveraged short
/bf tp BTCUSDT 105000          # Take profit at $105k
/bf sl BTCUSDT 95000           # Stop loss at $95k
/bf close BTCUSDT              # Close BTC position
/bf trades BTCUSDT 20          # Last 20 BTC trades
/bf dbstats ETHUSDT week       # ETH stats for past week
```

--------------------------------

### Install and Run CloddsBot from npm

Source: https://github.com/alsk1992/cloddsbot/blob/main/README.md

Installs the CloddsBot package globally using npm and then runs the interactive setup wizard. The wizard guides users through API key configuration, messaging channel setup, and starts the gateway. The WebChat interface will be accessible at http://localhost:18789/webchat.

```bash
npm install -g clodds --loglevel=error
clodds onboard
```

--------------------------------

### Install and Run CloddsBot from Source

Source: https://github.com/alsk1992/cloddsbot/blob/main/README.md

Clones the CloddsBot repository from GitHub, installs dependencies, copies the environment example file, and builds and starts the application. Users need to add their ANTHROPIC_API_KEY to the .env file.

```bash
git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
npm install && cp .env.example .env
# Add ANTHROPIC_API_KEY to .env
npm run build && npm start
```

--------------------------------

### Build Clodds from Source

Source: https://context7.com/alsk1992/cloddsbot/llms.txt

Steps to clone the repository, install dependencies, configure environment variables, and start the application in development or production mode.

```bash
git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
npm install && cp .env.example .env
echo "ANTHROPIC_API_KEY=sk-ant-..." >> .env
npm run build && npm start
```

--------------------------------

### Run Cloddsbot Setup Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/setup/SKILL.md

These commands initiate the Cloddsbot setup wizard. They can be used to get an overview of all configurations, set up specific skill categories like DeFi or futures, check environment variables, or perform a quick health check of the environment.

```bash
# See what's configured and what needs setup
/setup

# Configure a specific category
/setup defi
/setup futures
/setup prediction
/setup solana
/setup ai

# Check all environment variables
/setup env

# Quick health check
/setup check
```

--------------------------------

### Install Clodds Globally with npm

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/DEPLOYMENT_GUIDE.md

Installs the Clodds bot globally using npm and initiates the onboarding wizard for setup.

```bash
npm install -g clodds
clodds onboard
```

--------------------------------

### VPS Hardening Command Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/harden/SKILL.md

Provides examples of how to use the cloddsbot's VPS hardening commands, including specifying hosts, users, and using dry-run options. These examples demonstrate practical application of the audit, fix, emergency, and report functionalities.

```bash
/harden audit 192.168.1.100
/harden fix myserver.com --user=admin
/harden emergency vps.example.com --dry-run
/harden report server.io > security-report.md
```

--------------------------------

### Advanced Preset Usage Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/pump-swarm/SKILL.md

Practical examples of creating custom strategy, token, and wallet group presets, and applying them to trade commands.

```bash
# Create a custom strategy preset
/swarm preset save my_stealth --type strategy --mode sequential --slippage 300

# Create a token preset for BONK
/swarm preset save bonk_entry --type token --mint DezXAZ... --slippage 1000 --amount 0.1

# Create a wallet group preset
/swarm preset save top5 --type wallet_group --wallets wallet_0,wallet_1,wallet_2,wallet_3,wallet_4

# List all presets
/swarm preset list

# List only strategy presets
/swarm preset list strategy

# Use preset in trade
/swarm buy ABC... 0.1 --preset my_stealth
/swarm sell ABC... 100% --preset fast

# Delete a preset
/swarm preset delete old_preset
```

--------------------------------

### Complete Trading Example using Python SDK

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/trading-polymarket/SKILL.md

A comprehensive Python script demonstrating how to initialize the ClobClient, get balances, check order books, and place buy/sell orders.

```APIDOC
## Complete Trading Example

```python
#!/usr/bin/env python3
"""
Production-ready Polymarket trading script
"""

import os
import time
import requests
from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, ApiCreds, OrderType

# Initialize
client = ClobClient(
    "https://clob.polymarket.com",
    key=os.getenv("PRIVATE_KEY"),
    chain_id=137,
    funder=os.getenv("POLY_FUNDER_ADDRESS"),
    signature_type=2
)
client.set_api_creds(ApiCreds(
    api_key=os.getenv("POLY_API_KEY"),
    api_secret=os.getenv("POLY_API_SECRET"),
    api_passphrase=os.getenv("POLY_API_PASSPHRASE")
))

TOKEN_ID = "YOUR_TOKEN_ID"
WALLET = os.getenv("POLY_FUNDER_ADDRESS")
CTF = "0x4D97DCd97eC945f40cF65F87097ACe5EA0476045"

def get_balance(token_id):
    """Get position size"""
    token_int = int(token_id)
    data = f"0x00fdd58e000000000000000000000000{WALLET[2:].lower()}{token_int:064x}"
    r = requests.post("https://polygon-rpc.com/", json={
        "jsonrpc": "2.0", "method": "eth_call",
        "params": [{"to": CTF, "data": data}, "latest"], "id": 1
    })
    return int(r.json().get("result", "0x0"), 16) / 1e6

def get_orderbook(token_id):
    """Get current bid/ask"""
    book = client.get_order_book(token_id)
    return {
        "best_bid": float(book.bids[0].price) if book.bids else 0,
        "best_ask": float(book.asks[0].price) if book.asks else 1
    }

# Check position
position = get_balance(TOKEN_ID)
print(f"Current position: {position} shares")

# Get market
book = get_orderbook(TOKEN_ID)
print(f"Bid: {book['best_bid']:.2f}, Ask: {book['best_ask']:.2f}")

# Place a buy order (maker - inside spread)
buy_price = book['best_bid'] + 0.01  # 1 cent above bid
if buy_price < book['best_ask']:  # Ensure we're maker
    result = client.create_and_post_order(OrderArgs(
        token_id=TOKEN_ID,
        price=buy_price,
        size=10.0,
        side="BUY"
    ))
    print(f"Buy order placed: {result}")

# Place a sell order (market sell via FOK)
if position > 0:
    result = client.create_and_post_order(OrderArgs(
        token_id=TOKEN_ID,
        price=0.01,  # Lowest price = immediate fill
        size=position,
        side="SELL"
    ))
    print(f"Sold position: {result}")
```
```

--------------------------------

### Meteora Bot: Swap Example

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/meteora/SKILL.md

An example demonstrating how to execute a swap command for 1 SOL to USDC using the Meteora bot.

```bash
/met swap 1 SOL to USDC
```

--------------------------------

### Install and Configure Clodds via NPM

Source: https://context7.com/alsk1992/cloddsbot/llms.txt

Commands to install the Clodds terminal globally, run the interactive onboarding wizard, and start the local gateway service.

```bash
npm install -g clodds --loglevel=error
clodds onboard
clodds start
open http://localhost:18789/webchat
```

--------------------------------

### Clodds Bittensor Setup and Verification

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/BITTENSOR.md

Commands to initialize the Bittensor environment using the interactive wizard and verify that all dependencies are correctly installed.

```bash
clodds bittensor setup
clodds bittensor check
```

--------------------------------

### Complete Order Examples in Python

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/trading-polymarket/SKILL.md

Provides comprehensive examples of creating and posting various types of orders, including limit buy/sell (GTC, GTD), market buy/sell (FOK), post-only maker orders, and fill-or-kill (FAK) orders.

```python
from py_clob_client.order_builder.constants import BUY, SELL

# 1. LIMIT BUY (GTC) - sits on book until filled
order = client.create_and_post_order(
    OrderArgs(token_id=TOKEN_ID, price=0.45, size=100.0, side=BUY)
)

# 2. LIMIT SELL (GTC)
order = client.create_and_post_order(
    OrderArgs(token_id=TOKEN_ID, price=0.55, size=50.0, side=SELL)
)

# 3. MARKET BUY - spend $100 USDC at current prices (FOK)
signed = client.create_market_order(
    MarketOrderArgs(token_id=TOKEN_ID, amount=100.0, side=BUY)
)
result = client.post_order(signed, orderType=OrderType.FOK)

# 4. MARKET SELL - sell all shares immediately (FOK)
signed = client.create_market_order(
    MarketOrderArgs(token_id=TOKEN_ID, amount=my_shares, side=SELL)
)
result = client.post_order(signed, orderType=OrderType.FOK)

# 5. POST-ONLY MAKER ORDER (avoid taker fees, earn rebates)
signed = client.create_order(
    OrderArgs(token_id=TOKEN_ID, price=0.44, size=100.0, side=BUY)
)
result = client.post_order(signed, orderType=OrderType.GTC, post_only=True)
# If order would cross spread, it gets REJECTED instead of taking

# 6. GOOD TIL DATE (GTD) - expires after timestamp
import time
expiry = int(time.time()) + 300  # 5 minutes from now
signed = client.create_order(
    OrderArgs(token_id=TOKEN_ID, price=0.50, size=100.0, side=BUY, expiration=expiry)
)
result = client.post_order(signed, orderType=OrderType.GTD)

# 7. FILL AND KILL (FAK) - fill what you can, cancel rest
signed = client.create_market_order(
    MarketOrderArgs(token_id=TOKEN_ID, amount=1000.0, side=BUY)
)
result = client.post_order(signed, orderType=OrderType.FAK)
```

--------------------------------

### Weather Bot Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/weather/SKILL.md

Illustrates practical usage of the weather betting bot commands with concrete examples. These examples demonstrate how to specify cities for forecasts, initiate market scans, calculate edges for specific markets, place bets with specified amounts, and configure auto-betting thresholds.

```bash
/weather forecast "New York"
/weather scan
/weather edge abc123
/weather bet abc123 10
/weather auto --threshold 15
```

--------------------------------

### Botchan CLI Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/botchan/SKILL.md

Provides practical examples of using Botchan commands for various operations, including listing feeds, reading posts with a limit, viewing profiles, posting messages to feeds, and sending direct messages to other agents.

```bash
/botchan feeds
/botchan read general --limit 5
/botchan profile 0x1234...
/botchan post general "Hello agents!"
/botchan post 0xFriend "Hey, want to collaborate?"
```

--------------------------------

### Bags CLI: Example Usage

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/bags/SKILL.md

Illustrative examples of how to use various Bags.fm CLI commands for common tasks such as trading, discovery, token launching, fee management, fee sharing, and wallet lookups.

```bash
# Trading
/bags quote 1 SOL to USDC
/bags swap 0.5 SOL to BONK

# Discovery
/bags trending
/bags token ABC123...

# Launch a token
/bags launch "Moon Token" MOON "To the moon!" --twitter moontoken --initial 0.1

# Check and claim fees
/bags fees
/bags claim

# Set up 50/50 fee share
/bags fee-config <mint> wallet1:5000 wallet2:5000

# Lookup wallet by Twitter
/bags wallet twitter elonmusk
```

--------------------------------

### MCP Server Configuration Example

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/mcp/SKILL.md

An example JSON structure for configuring MCP servers, including command, arguments, and environment variables for different server types like filesystem and GitHub.

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
      "env": {}
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}
```

--------------------------------

### Cloning and Setup for Clodds Bot Development

Source: https://github.com/alsk1992/cloddsbot/blob/main/CONTRIBUTING.md

Steps to clone the Clodds Bot repository, install dependencies, and set up a new feature branch for development.

```bash
git clone https://github.com/YOUR_USERNAME/clodds
cd clodds
npm install
git checkout -b feature/my-feature
```

--------------------------------

### Setup CloddsBot Systemd Service

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/DEPLOYMENT.md

Provides a step-by-step guide for setting up CloddsBot as a systemd service, including creating the necessary user, directories, copying application files, configuring the environment file, and enabling/starting the service. It also shows how to check the service status and view logs.

```bash
# Create user
sudo useradd -r -s /sbin/nologin clodds

# Create directories
sudo mkdir -p /opt/clodds /var/lib/clodds /etc/clodds
sudo chown clodds:clodds /var/lib/clodds

# Copy application
sudo cp -r dist/* /opt/clodds/

# Create environment file
sudo cp .env /etc/clodds/clodds.env
sudo chmod 600 /etc/clodds/clodds.env

# Enable and start
sudo systemctl daemon-reload
sudo systemctl enable clodds
sudo systemctl start clodds

# Check status
sudo systemctl status clodds
sudo journalctl -u clodds -f
```

--------------------------------

### Bybit Futures Trading Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/bybit-futures/SKILL.md

Illustrative examples demonstrating various trading operations on Bybit futures using the bot's command-line interface. These examples cover opening/closing positions, setting stop-loss/take-profit, and retrieving historical data.

```bash
# 10x leveraged long
/bb long BTCUSDT 0.01 10x

# 20x leveraged short
/bb short ETHUSDT 0.1 20x

# Take profit at $105k
/bb tp BTCUSDT 105000

# Stop loss at $95k
/bb sl BTCUSDT 95000

# Close BTC position
/bb close BTCUSDT

# Last 20 BTC trades
/bb trades BTCUSDT 20

# ETH stats for past week
/bb stats ETHUSDT week
```

--------------------------------

### Build and Run CloddsBot from Source

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/DEPLOYMENT.md

Provides instructions to clone the CloddsBot repository, install dependencies, configure environment variables, build the project, and start the application. This method is suitable for development or custom deployments.

```bash
# Clone repository
git clone https://github.com/alsk1992/CloddsBot.git
cd CloddsBot

# Install dependencies
npm ci

# Create environment file
cp .env.example .env
# Edit .env with your API keys

# Build
npm run build

# Start
npm start
# Or: node dist/index.js
```

--------------------------------

### Kamino Example Usage

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/kamino/SKILL.md

Illustrative examples of how to use Kamino Finance bot commands for various operations.

```bash
/kamino deposit 100 USDC
/kamino borrow 50 SOL
/kamino health
/kamino repay all SOL
/kamino rates
/kamino strategies
/kamino vault-deposit ABC123... 1000 500
```

--------------------------------

### Install Veil SDK

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/veil/SKILL.md

Installs the Veil SDK using npm, which is required for Node.js-based ZK proof generation and interacting with Veil functionalities.

```bash
npm install -g @veil-cash/sdk
```

--------------------------------

### Schedule Preset Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/automation/SKILL.md

Examples of using named schedule presets instead of raw cron expressions. These presets simplify the creation of common recurring tasks like hourly reports or daily snapshots.

```bash
/auto cron EVERY_MINUTE check-prices
/auto cron EVERY_5_MINUTES portfolio-sync
/auto cron EVERY_15_MINUTES scan-arbs
/auto cron HOURLY report
/auto cron DAILY_MIDNIGHT snapshot
/auto cron DAILY_9AM morning-scan
/auto cron WEEKLY_MONDAY_9AM weekly-report
/auto cron MONTHLY monthly-summary
```

--------------------------------

### Project Setup Commands for OnchainKit

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/onchainkit/SKILL.md

Provides commands to create a new onchain application or add components to an existing project using the OnchainKit CLI.

```bash
/onchainkit create <project-name>    Create new onchain app
/onchainkit add <component>          Add component to project
```

--------------------------------

### Initialize Exchange Clients and Execute Trades

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/TRADING.md

Demonstrates how to instantiate clients for Binance, Bybit, Hyperliquid, and Mexc using environment variables. It also shows common trading operations such as checking balances, placing market orders, setting leverage, and monitoring positions.

```typescript
import { BinanceFuturesClient, BybitFuturesClient, HyperliquidClient, MexcFuturesClient } from './trading/futures';

const binance = new BinanceFuturesClient({
  apiKey: process.env.BINANCE_API_KEY!,
  apiSecret: process.env.BINANCE_API_SECRET!,
});

const balance = await binance.getBalance();
const order = await binance.placeOrder({
  symbol: 'BTCUSDT',
  side: 'BUY',
  type: 'MARKET',
  quantity: 0.01,
});
await binance.setLeverage('BTCUSDT', 10);
```

--------------------------------

### Record Custom Metrics

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/TELEMETRY.md

Examples of recording counters, gauges, and histograms, and starting the Prometheus metrics server.

```typescript
telemetry.recordCounter('api_requests_total', 1, { endpoint: '/markets', method: 'GET' });
telemetry.recordGauge('active_connections', 42, { channel: 'telegram' });
telemetry.recordHistogram('request_duration_ms', 150, { endpoint: '/api/search' });
telemetry.startMetricsServer(9090);
```

--------------------------------

### Storage Service Payload

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example request body for the Storage service, detailing operations like put, get, delete, and list.

```APIDOC
### Storage Service Payload

#### Request Body Example
```json
{
  "wallet": "0x...",
  "payload": {
    "operation": "put",
    "key": "my-file.txt",
    "content": "Hello World",
    "contentType": "text/plain",
    "ttl": 3600
  }
}
```

**Operations:** `put`, `get`, `delete`, `list`
```

--------------------------------

### OnchainKit Project Initialization

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/onchainkit/SKILL.md

Provides commands for setting up a new project with OnchainKit using npm or adding it to an existing project.

```bash
# Create new app
npm create onchain@latest

# Or add to existing project
npm install @coinbase/onchainkit
```

--------------------------------

### Health Check Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/health endpoint, indicating service status and operational metrics.

```json
{
  "status": "ok",
  "service": "clodds-compute",
  "version": "v1",
  "uptime": 123456,
  "activeJobs": 2
}
```

--------------------------------

### Deploy Tokens with Clanker CLI

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/clanker/SKILL.md

Examples of deploying tokens using various configurations including vanity addresses, vesting schedules, and initial market cap settings.

```bash
/clanker deploy "My Token" TKN --image ipfs://Qm... --vanity

/clanker deploy "Creator Token" CTK \
  --vault 10 \
  --vault-lockup 30 \
  --vault-vesting 30

/clanker deploy "Launch Token" LTK \
  --dev-buy 0.1 \
  --market-cap 5

/clanker deploy "Community Token" CMT \
  --image ipfs://Qm... \
  --description "Community-owned token" \
  --twitter mytoken \
  --website https://mytoken.xyz \
  --vault 10 \
  --vault-lockup 7 \
  --vault-vesting 30 \
  --vanity \
  --chain base
```

--------------------------------

### CloddsBot CLI Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/README.md

Provides a list of essential command-line interface (CLI) commands for interacting with CloddsBot. These commands cover setup, starting the gateway, entering the REPL, running diagnostics, enhancing security, setting the locale, and starting the MCP server.

```bash
clodds onboard     # Interactive setup wizard
clodds start       # Start the gateway
clodds repl        # Interactive REPL
clodds doctor      # System diagnostics
clodds secure      # Harden security
clodds locale set zh  # Change language
clodds mcp         # Start MCP server (for Claude Desktop/Code)
clodds mcp install # Auto-configure Claude Desktop/Code
```

--------------------------------

### Initialize and Index Markdown Collections

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/qmd/SKILL.md

Commands to add a directory to the qmd index, add an optional context description, and generate embeddings for semantic search capabilities.

```bash
qmd collection add /path/to/notes --name notes --mask "**/*.md"
qmd context add qmd://notes "Description of this collection"
qmd embed
```

--------------------------------

### Botchan Setup and Requirements

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/botchan/SKILL.md

Information on setting up Botchan, including environment variables and network requirements.

```APIDOC
## Botchan Setup and Requirements

### Description
Information on setting up Botchan, including environment variables and network requirements.

### Environment Variables
For posting messages, you need to set your private key:
```bash
export PRIVATE_KEY="0x..."
```

### Network Requirements
Requires ETH on the Base network to pay for gas fees.
```

--------------------------------

### DCA Command Line Interface Examples

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/TRADING.md

Provides examples of using the `/dca` command to set up Dollar-Cost Averaging strategies on various platforms like Polymarket, Kalshi, PumpFun, Hyperliquid, Binance Futures, Bybit, MEXC Futures, Drift Protocol, Opinion.trade, Predict.fun, Orca Whirlpool, Raydium, and Virtuals. Each command requires specific parameters such as token IDs, amounts, intervals, and sometimes API keys or private keys.

```bash
# Polymarket
/dca poly <token-id> <total-$> --per <$> --every <interval> [--price <p>]

# Example:
/dca poly 0x1234...cond 100 --per 10 --every 1h --price 0.45

```

```bash
# Kalshi
/dca kalshi <ticker> <total-$> --per <$> --every <interval> [--price <p>]

# Example:
/dca kalshi KXBTC-25FEB 500 --per 25 --every 4h

```

```bash
# PumpFun
/dca pump <mint> <total-SOL> --per <SOL> --every <interval> [--slippage <bps>] [--pool pump|raydium|auto]

# Example:
/dca pump 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU 5 --per 0.5 --every 5m

```

```bash
# Hyperliquid
/dca hl <coin> <total-$> --per <$> --every <interval> [--side long|short] [--leverage <n>]

# Example:
/dca hl BTC 1000 --per 100 --every 4h --side long --leverage 5

```

```bash
# Binance Futures
/dca bf <symbol> <total-$> --per <$> --every <interval> [--side long|short] [--leverage <n>]

# Example:
/dca bf BTCUSDT 1000 --per 100 --every 4h --side long --leverage 10

```

```bash
# Bybit
/dca bb <symbol> <total-$> --per <$> --every <interval> [--side long|short] [--leverage <n>]

# Example:
/dca bb BTCUSDT 1000 --per 100 --every 4h --side short --leverage 3

```

```bash
# MEXC Futures
/dca mexc <symbol> <total-$> --per <$> --every <interval> [--side long|short] [--leverage <n>]

# Example:
/dca mexc BTC_USDT 1000 --per 100 --every 4h --side long --leverage 20

# Requires: MEXC_API_KEY, MEXC_API_SECRET

```

```bash
# Drift Protocol (Solana)
/dca drift <market-index> <total-$> --per <$> --every <interval> [--type perp|spot] [--side long|short]

# Example:
/dca drift 0 500 --per 50 --every 4h --type perp --side long

# Requires: SOLANA_PRIVATE_KEY

```

```bash
# Opinion.trade (BNB Chain)
/dca opinion <market-id> <total-$> --per <$> --every <interval> [--price <p>]

# Example:
/dca opinion 12345 100 --per 10 --every 1h --price 0.40

# Requires: OPINION_API_KEY, OPINION_API_SECRET

```

```bash
# Predict.fun (BNB Chain)
/dca predict <market-id> <total-$> --per <$> --every <interval> [--price <p>]

# Example:
/dca predict abc-market 100 --per 10 --every 1h

# Requires: PREDICTFUN_PRIVATE_KEY

```

```bash
# Orca Whirlpool (Solana)
/dca orca <pool-address> <input-mint> <total> --per <amt> --every <interval> [--slippage <bps>]

# Example:
/dca orca HJPjoWUrhoZzkNfRpHuieeFk9WGRBBmfcxDGU9wmjEQp So11...1112 10 --per 1 --every 1h

# Requires: SOLANA_PRIVATE_KEY

```

```bash
# Raydium (Solana)
/dca raydium <input-mint> to <output-mint> <total> --per <amt> --every <interval> [--slippage <bps>]

# Example:
/dca raydium SOL to USDC 10 --per 1 --every 1h

# Requires: SOLANA_PRIVATE_KEY

```

```bash
# Virtuals (Base Chain)
/dca virtuals <agent-token-address> <total-VIRTUAL> --per <VIRTUAL> --every <interval> [--slippage <bps>]

# Example:
/dca virtuals 0xABC...token 1000 --per 100 --every 1h --slippage 200

# Requires: EVM_PRIVATE_KEY

```

--------------------------------

### Apply Safe Fixes with Cloddsbot

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/VPS_SECURITY.md

Applies a set of safe, automated security fixes to a server. These fixes include system updates, auto-updates installation, firewall setup, fail2ban installation, and setting SSH MaxAuthTries. It can optionally use a specified user and perform a dry run to preview changes.

```bash
/harden fix myserver.com --user=admin
```

```bash
/harden audit host --user=deployer
```

```bash
/harden fix host --dry-run
```

--------------------------------

### MEXC Futures Bot Setup and Basic Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/mexc-futures/SKILL.md

Instructions on setting up API credentials and using basic commands for account balance and position management.

```APIDOC
## MEXC Futures Bot Setup and Basic Commands

### Description
This section covers the initial setup of the MEXC Futures bot, including setting API keys and demonstrating fundamental commands for checking account balance and viewing open positions.

### Setup

1. **Set Credentials:** Export your MEXC API key and secret as environment variables.
   ```bash
   export MEXC_API_KEY="your-api-key"
   export MEXC_API_SECRET="your-api-secret"
   ```

### Commands

#### Account Commands

- `/mx balance`: Check account balance.
- `/mx positions`: View open positions.
- `/mx orders`: List open orders.

### Request Example

```bash
/mx balance
```

### Response Example

(Response will vary based on account status)
```json
{
  "available_balance": "1000.00 USDT",
  "margin_balance": "1050.00 USDT"
}
```
```

--------------------------------

### TypeScript: Get Current Market Price

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/feeds/SKILL.md

Provides an example of fetching the current price for a market in TypeScript. It retrieves the YES and NO prices, the spread, and the timestamp of the last update.

```typescript
// Get current price
const price = await feeds.getPrice('polymarket', 'market-123');

console.log(`YES: ${price.yes}`);
console.log(`NO: ${price.no}`);
console.log(`Spread: ${price.spread}`);
console.log(`Updated: ${price.timestamp}`);
```

--------------------------------

### Wallet Balance Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/balance/:wallet endpoint, showing the available, pending, deposited, and spent credits for a given wallet address.

```json
{
  "wallet": "0x...",
  "available": 10.50,
  "pending": 0.25,
  "totalDeposited": 15.00,
  "totalSpent": 4.25
}
```

--------------------------------

### Botchan Setup - Environment Variable

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/botchan/SKILL.md

Shows how to set up the necessary environment variable for Botchan write operations. The PRIVATE_KEY is required for authenticating transactions that modify data on the Base network.

```bash
export PRIVATE_KEY="0x..."  # For posting
```

--------------------------------

### Pricing Information Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/pricing endpoint, detailing the pricing structure for various compute services like LLM, code, web, and GPU.

```json
{
  "llm": {
    "service": "llm",
    "basePrice": 0,
    "unit": "token",
    "pricePerUnit": 0.000003,
    "minCharge": 0.001,
    "maxCharge": 10
  },
  "code": {
    "service": "code",
    "basePrice": 0.01,
    "unit": "second",
    "pricePerUnit": 0.001,
    "minCharge": 0.01,
    "maxCharge": 1
  },
  "web": {
    "service": "web",
    "basePrice": 0.005,
    "unit": "request",
    "pricePerUnit": 0.005,
    "minCharge": 0.005,
    "maxCharge": 0.1
  },
  "trade": {
    "service": "trade",
    "basePrice": 0.01,
    "unit": "call",
    "pricePerUnit": 0.01,
    "minCharge": 0.01,
    "maxCharge": 0.5
  },
  "data": {
    "service": "data",
    "basePrice": 0.001,
    "unit": "request",
    "pricePerUnit": 0.001,
    "minCharge": 0.001,
    "maxCharge": 0.1
  },
  "storage": {
    "service": "storage",
    "basePrice": 0,
    "unit": "mb",
    "pricePerUnit": 0.0001,
    "minCharge": 0.001,
    "maxCharge": 1
  },
  "gpu": {
    "service": "gpu",
    "basePrice": 0,
    "unit": "second",
    "pricePerUnit": 0.01,
    "minCharge": 0.1,
    "maxCharge": 100
  },
  "ml": {
    "service": "ml",
    "basePrice": 0.01,
    "unit": "request",
    "pricePerUnit": 0.01,
    "minCharge": 0.01,
    "maxCharge": 1
  }
}
```

--------------------------------

### TypeScript: Get and Search News

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/feeds/SKILL.md

Provides examples for retrieving recent news and searching for news articles related to a specific topic or market in TypeScript. It shows how to filter by date and source.

```typescript
// Get recent news
const news = await feeds.getRecentNews('trump', { limit: 10 });

for (const article of news) {
  console.log(`[${article.source}] ${article.title}`);
  console.log(`  ${article.summary}`);
  console.log(`  ${article.url}`);
}

// Search news
const searchResults = await feeds.searchNews('federal reserve', {
  from: '2024-01-01',
  sources: ['reuters', 'bloomberg'],
});
```

--------------------------------

### Create and Post Orders in Python

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/trading-polymarket/SKILL.md

Demonstrates methods for creating and posting orders, including a combined create-and-post call, separate creation and posting steps, and market order creation. Also shows how to calculate the expected price for a market order.

```python
# SIMPLE: Create and post in one call (recommended)
result = client.create_and_post_order(
    OrderArgs(
        token_id="123456789012345678901234567890",
        price=0.45,
        size=10.0,
        side="BUY"
    )
)
# Returns: {"orderID": "...", "status": "...", ...}

# ADVANCED: Separate create and post
order = client.create_order(OrderArgs(...))  # Returns SignedOrder
result = client.post_order(order, orderType=OrderType.GTC, post_only=False)

# Market order (calculates price automatically)
result = client.create_market_order(
    MarketOrderArgs(
        token_id="...",
        amount=100.0,    # Spend $100 USDC
        side="BUY"
    )
)

# Calculate expected fill price before market order
price = client.calculate_market_price(
    token_id="...",
    side="BUY",
    amount=100.0,
    order_type=OrderType.FOK
)
```

--------------------------------

### MCP Registry Management (TypeScript)

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/mcp/SKILL.md

Provides examples of using the MCP Registry to manage MCP servers. This includes adding, listing, getting, removing servers, and starting/stopping all registered servers.

```typescript
import { createMCPRegistry } from 'clodds/mcp';

const registry = createMCPRegistry({
  configPath: './mcp-servers.json',
});

// Add server
registry.addServer({
  name: 'filesystem',
  command: 'npx',
  args: ['-y', '@modelcontextprotocol/server-filesystem', '/home/user'],
  env: {},
});

// List servers
const servers = registry.listServers();

// Get server
const server = registry.getServer('filesystem');

// Remove server
registry.removeServer('filesystem');

// Start all servers
await registry.startAll();

// Stop all servers
await registry.stopAll();
```

--------------------------------

### Cloddsbot CLI Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/SKILLS.md

A set of command-line interface commands for managing Cloddsbot skills. These commands allow users to list, search, install, update, uninstall, and get information about skills.

```bash
clodds skills list
clodds skills list --verbose
clodds skills search <query>
clodds skills install <slug>
clodds skills update [slug]
clodds skills uninstall <slug>
clodds skills info <slug>
```

--------------------------------

### Initialize and Scan for Opportunities (TypeScript)

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/OPPORTUNITY_FINDER.md

This snippet demonstrates how to initialize the Opportunity Finder with a database, feeds, and embeddings, and then scan for trading opportunities based on a query and minimum edge. It also shows how to set up real-time alerts for new opportunities.

```typescript
import { createOpportunityFinder } from './opportunity';

const finder = createOpportunityFinder(db, feeds, embeddings, {
  minEdge: 0.5,
  semanticMatching: true,
});

// Find opportunities
const opps = await finder.scan({ query: 'fed rate', minEdge: 1 });

// Real-time alerts
finder.on('opportunity', (opp) => console.log('Found:', opp.edgePct, '%'));
await finder.startRealtime();
```

--------------------------------

### Initialize and Control Opportunity Finder

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/OPPORTUNITY_FINDER.md

Demonstrates how to instantiate the opportunity finder and manage real-time scanning processes.

```javascript
const finder = createOpportunityFinder(db, feeds, embeddings, config);
finder.startRealtime();
// ... perform operations
finder.stopRealtime();
```

--------------------------------

### Wallet Usage Statistics Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/usage/:wallet endpoint, detailing service-specific usage (requests, cost, duration) and total cost for a specified period.

```json
{
  "wallet": "0x...",
  "period": "week",
  "byService": {
    "llm": {
      "requests": 50,
      "cost": 2.50,
      "avgDuration": 1500
    },
    "code": {
      "requests": 10,
      "cost": 0.50,
      "avgDuration": 3000
    }
  },
  "totalCost": 3.00,
  "totalRequests": 60
}
```

--------------------------------

### API Metrics Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/metrics endpoint, providing aggregated API usage statistics, including uptime, request counts, revenue, and job statuses.

```json
{
  "uptime": 123456,
  "totalRequests": 1500,
  "totalRevenue": 45.50,
  "activeJobs": 2,
  "jobsByStatus": {
    "pending": 1,
    "processing": 1,
    "completed": 1450,
    "failed": 48
  },
  "requestsByService": {
    "llm": 1200,
    "code": 200,
    "web": 100
  }
}
```

--------------------------------

### Chat Commands for Market Feeds

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/feeds/SKILL.md

Examples of chat commands to interact with the market feeds. These commands allow searching markets, getting prices and orderbooks, subscribing to real-time updates, and retrieving news.

```bash
/feed search "trump"
/feed search "election" --platform poly
/feed search "fed rate" --limit 20
/feed price poly <market-id>
/feed price kalshi TRUMP-WIN
/feed prices "trump"
/feed orderbook poly <market-id>
/feed orderbook poly <market-id> --depth 10
/feed subscribe poly <market-id>
/feed unsubscribe poly <market-id>
/feed subscriptions
/feed news "trump"
/feed news <market-id>
/feed news --recent 10
/feed edge poly <market-id>
/feed kelly poly <market-id> --prob 0.55
```

--------------------------------

### Virtuals Protocol CLI Commands

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/VIRTUALS.md

Provides examples of command-line interface (CLI) commands for interacting with the Virtuals Protocol, including searching agents, viewing trending agents, and getting trade quotes.

```bash
/agents luna              # Search for AI agents
/trending-agents          # See what's hot
/agent 0x1234...          # Get agent details
/agent-quote buy 0x... 100  # Get trade quote
```

--------------------------------

### Swarm Trading Examples: Buying and Selling with Options

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/pump-swarm/SKILL.md

Demonstrates practical usage of the swarm trading commands with various options, including specifying wallets, using presets, executing multi-bundle or sequential sells, and trading across different DEXs like Bags.fm and Meteora.

```bash
# Buy 0.1 SOL worth on each enabled wallet (auto mode)
/swarm buy ABC123mint... 0.1

# Buy with specific wallets only
/swarm buy ABC123mint... 0.2 --wallets wallet_0,wallet_1

# Buy with a preset
/swarm buy ABC123mint... 0.1 --preset stealth

# Sell 100% with multiple Jito bundles (for >5 wallets)
/swarm sell ABC123mint... 100% --multi-bundle

# Sell 50% with staggered timing (stealth mode)
/swarm sell ABC123mint... 50% --sequential

# Sell with preset
/swarm sell ABC123mint... 100% --preset fast

# Check positions before selling
/swarm refresh ABC123mint...
/swarm position ABC123mint...

# Multi-DEX examples
/swarm buy ABC123mint... 0.1 --dex bags          # Buy on Bags.fm
/swarm buy ABC123mint... 0.1 --dex meteora       # Buy on Meteora DLMM
/swarm sell ABC123mint... 100% --dex bags        # Sell on Bags.fm
```

--------------------------------

### Single Job Status Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/job/:jobId endpoint, providing detailed status, results, cost, and usage breakdown for a specific asynchronous compute job.

```json
{
  "id": "req_123",
  "jobId": "job_456",
  "service": "llm",
  "status": "completed",
  "result": {
    "content": "The weather is sunny.",
    "model": "claude-opus-4-6",
    "usage": { "inputTokens": 10, "outputTokens": 5 },
    "stopReason": "end_turn"
  },
  "cost": 0.05,
  "usage": {
    "units": 1500,
    "unitType": "token",
    "durationMs": 2300,
    "breakdown": {
      "base": 0,
      "usage": 0.0045,
      "total": 0.0045
    }
  },
  "timestamp": 1706500000000
}
```

--------------------------------

### Wallet Jobs List Endpoint Response

Source: https://github.com/alsk1992/cloddsbot/blob/main/docs/API.md

Example JSON response for the GET /v1/jobs/:wallet endpoint, listing recent jobs associated with a wallet, including their ID, service, status, cost, and timestamp.

```json
{
  "jobs": [
    {
      "id": "req_123",
      "jobId": "job_456",
      "service": "llm",
      "status": "completed",
      "cost": 0.05,
      "timestamp": 1706500000000
    }
  ],
  "count": 1
}
```

--------------------------------

### Configure Trading Clients from Environment Variables (TypeScript)

Source: https://github.com/alsk1992/cloddsbot/blob/main/src/skills/bundled/trading-futures/SKILL.md

This snippet demonstrates how to automatically configure trading clients for Binance, Bybit, MEXC, and Hyperliquid futures by reading API keys and secrets from environment variables. It utilizes the `setupFromEnv` function for a quick setup.

```typescript
import { setupFromEnv } from 'clodds/trading/futures';

// Auto-configure from environment variables
const { clients, database, strategyEngine } = await setupFromEnv();

// Access individual clients
const binance = clients.binance;
const bybit = clients.bybit;
const mexc = clients.mexc;
const hyperliquid = clients.hyperliquid;
```