𝕏 :8083

Twitter Monitor

Watches Twitter/X accounts for keyword matches and fires Gunbot trading signals in real time. Configure any account, any keyword, any trade action — route through the Webhook Portal for full gate filtering, or execute directly on Gunbot.

Open App Read the Docs

Capabilities

Social alpha Gunbot orders.

Multi-Account Monitoring

Watch any number of Twitter/X accounts simultaneously. Resolve handles to user IDs with automatic 24-hour caching.

Keyword Matching

Any tweet from a watched account that contains a watched keyword fires a signal. Retweets, replies, and quote tweets are optionally filtered.

Per-Keyword Trade Config

Each keyword can have its own action (buy / sell / addpair), exchange, symbol, and amount. Different keywords different trades.

Automatic Rate Limiting

Detects Twitter API 429 responses and backs off automatically. Configurable poll interval with a 15-second minimum.

Dual Signal Routing

Route signals through Webhook Portal (inherits all gate rules and indicator filters) or post directly to Gunbot's REST API.

addpair Support

Tweet triggers can create new Gunbot pairs via addpair — automatically start trading a new coin the moment it's announced.

Signal Routing

Two routing modes

Webhook Mode RECOMMENDED

Signal is POSTed to the Webhook Portal on :8081. Inherits all configured gate rules, indicator filters, rate limits, and cooldowns before any execution.

Gate rules apply (RSI, MACD, rate limit, cooldown…)

Full audit log in Webhook Portal UI

Optional HMAC signing for security

Gunbot Direct Mode

Signal is POSTed directly to Gunbot's trade API on :3001. No gate filtering. Fastest path to execution — use with caution.

Bypasses gate rules — lowest latency

Good for time-critical listings

No indicator filtering applied

Poll timer fires  (configurable interval, min 15s)
  └─ GET /2/tweets/search/recent Twitter API v2
       query: (from:account1 OR from:account2) (kw1 OR kw2) -is:retweet lang:en
       since_id: last seen tweet ID (no reprocessing)
       │
       └─ For each new tweet:
            ├─ checkKeywords(tweet.text)  [matched keyword configs]
            ├─ Build signal { action, exchange, symbol, amount, tweetId… }
            │
            ├─ webhook mode  ── POST :8081/webhook  Gate rules  Gunbot  Exchange
            └─ gunbot mode   ── POST :3001/api/v1/trade/market  Exchange

Twitter API

Bearer Token & rate limits

Getting your Bearer Token (free)

Go to developer.twitter.com create a project create an app Keys and Tokens copy the Bearer Token. Takes about 5 minutes. The free tier is enough for casual monitoring — paste the token into the Config tab and you're done.

        
        Twitter API v2 — Rate limits by tier
      
        TierPriceSearch requests / 15 minRecommended poll interval

        Free$01 req / 15 min≥ 900,000 ms (15 min)
Basic$100/mo15 req / 15 min≥ 60,000 ms (1 min)
Pro$5000/mo300 req / 15 min≥ 3,000 ms (3 sec)

Tier	Price	Search requests / 15 min	Recommended poll interval
Free	$0	1 req / 15 min	≥ 900,000 ms (15 min)
Basic	$100/mo	15 req / 15 min	≥ 60,000 ms (1 min)
Pro	$5000/mo	300 req / 15 min	≥ 3,000 ms (3 sec)