Signals

Signals Trading

Monitor external signals from RSS feeds, Twitter, Telegram, and webhooks to trigger automatic trades.

Commands

Copy code
/signal add rss <url> [--name "label"]            Add RSS feed source
/signal add twitter <username> [--name "label"]   Add Twitter/X account
/signal add webhook [--name "label"]              Get webhook URL for custom signals
/signal list                                      List all signal sources
/signal remove <id>                               Remove source
/signal pause <id>                                Pause source
/signal resume <id>                               Resume source
/signal history [source]                          View signal history
/signal test <id>                                 Test signal detection
/signal filter <id> add <type> <value> <action>   Add filter rule
/signal filter <id> list                          List filters
/signal config <id> [options]                     Configure source

Examples

Copy code
/signal add rss https://example.com/feed.xml --name "crypto-news"
/signal add twitter CryptoTrader --name "whale-alerts"
/signal add webhook --name "my-alerts"
/signal filter abc123 add keyword "bullish" buy
/signal filter abc123 add keyword "dump" sell
/signal list

Signal Sources

RSS Feeds

Monitor any RSS/Atom feed for signals. Polls every 30 seconds by default.

Copy code
/signal add rss https://example.com/feed.xml --name "news"

Twitter/X

Monitor tweets from specific accounts via Nitter proxy.

Copy code
/signal add twitter whale_alert --name "whale"

Webhooks

Receive signals via HTTP POST to a custom webhook URL.

Copy code
/signal add webhook --name "custom"
# Returns: POST https://clodds.io/webhook/abc123

Webhook payload:

jsonCopy code
{
  "content": "Buy BONK now! 5BqXr...",
  "author": "trader",
  "secret": "your-secret"
}

Filters

Control when signals trigger trades:

• keyword: Match text content
• mint: Match specific token address
• sentiment: Match bullish/bearish sentiment
• regex: Custom regex pattern

Copy code
/signal filter <id> add keyword "100x" buy
/signal filter <id> add sentiment bearish sell
/signal filter <id> add regex "pump.*now" buy

Configuration

Copy code
/signal config <id> --amount 0.1       SOL amount per trade
/signal config <id> --slippage 500     Slippage in bps
/signal config <id> --cooldown 60000   Cooldown between trades (ms)
/signal config <id> --require-mint     Only trade if mint found in signal

Features

• Auto-detect token mint addresses in signals
• Sentiment analysis (bullish/bearish keywords)
• Cooldown to prevent spam trading
• Trade history and P&L tracking
• Support for Pump.fun, Raydium, Jupiter routing