x-twitter-monitor

# X monitors — real-time events | Task | Approach | |---|---| | Start watching | `x_monitor` `action: "create"` — see **Create** | | Get the events | Poll `/api/monitors/{id}/events` (free) or register a webhook | | Keep it alive | `action: "extend"` before `expires_at`; it does **not** auto-renew | | Stop it | `DELETE /api/monitors/{id}` — no refund for unused hours | A monitor is **prepaid by the hour** — about $0.025/hr, so ~$0.61/day or ~$4.20/week. Max 168 hours per purchase, 720 hours of forward window. ## Create ``` POST https://twitr.sh/api/tools/x_monitor Idempotency-Key: <uuid> { "action": "create", "username": "vercel", "hours": 168 } # account monitor { "action": "create", "query": "\"launch week\"", "hours": 168 } # keyword monitor ``` **Tell the user the total cost before creating.** Pay on **Base (x402) or Tempo (MPP)** — a monitor is a stateful resource needing a recoverable owner wallet, so Solana is not offered. 21 event types: `tweet.new`, `.reply`, `.retweet`, `.quote`, `.media`, `.link`, `.poll`, `.mention`, `.hashtag`, `.longform`, plus `profile.*.changed` (avatar, banner, name, username, bio, location, url, verified, protected, pinned_tweet, unavailable) on **account monitors only**. A terminal `monitor.expired` / `monitor.deleted` fires once when it ends. ## Get events — polling (free) ``` GET https://twitr.sh/api/monitors/{id}/events?after={last_event_id}&limit=50 ``` Wallet-signed, free, 60 reads/min. Cursor semantics: pass the last id y...