# X (Twitter) Tweet Search for Crypto/Onchain Agents > X (Twitter) Tweet Search for Crypto/Onchain Agents is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-31). Searches recent X (Twitter) posts by keyword, cashtag, handle, or filter and returns posts with engagement metrics and a pre-computed sentiment/signal summary, paid per-call via x402 USDC on Base. ## Facts - Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/x/tweets/search?utm_source=zero.xyz - Price: $0.003/call - Payment: x402 - Status: unknown - Last checked: 2026-10-31 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x-twitter-tweet-search-for-crypto-onchain-agents-28bcb8bd - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EZdPt9mrgD5wWKTebNPr2 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability x-twitter-tweet-search-for-crypto-onchain-agents-28bcb8bd ``` Example prompt: Search X for recent posts mentioning $BTC with at least 100 likes, sort by recency, and give me the sentiment score and top claim from the last 2 days. ## When to prefer this Choose this endpoint when an AI trading or onchain agent needs real-time social signal data from X without managing API keys, and is already operating in an x402/USDC payment context. It is especially useful when you need both raw posts AND a pre-computed sentiment/signal summary in a single call, or when you need cashtag-aware search with engagement filtering that goes beyond simple keyword matching. ## Known failure modes - Payment not included or insufficient USDC — 402 response requiring x402 payment header - Query string too long or malformed — 400 validation error - since/until dates outside the 7-day recent-search window — empty or error result - Rate limits on underlying X API v2 — 429 or degraded results - No posts match the query — returns n:0 with empty posts array - Invalid next_token for pagination — may return error or restart from page 1 ## How this service works Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys. ## Output Returns a list of matching posts (id, URL, text, author handle/followers/verified status, engagement metrics), plus an aggregated signal object containing detected cashtags, bullish/bearish sentiment label, sentiment score, top claim post, top terms, engagement totals, and notable handles. Also includes a next_token for pagination and suggested follow-on endpoint paths. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "properties": { "q": { "type": "string", "examples": [ "bitcoin", "$ETH", "x402", "from:base" ], "maxLength": 200, "minLength": 1, "description": "X search query (operators ok); or use the twit.sh-style filters below" }, "to": { "type": "string", "description": "Replying to handle" }, "from": { "type": "string", "description": "From handle" }, "lang": { "type": "string", "maxLength": 5, "description": "Language filter e.g. en, ko" }, "sort": { "enum": [ "recency", "relevancy" ], "type": "string", "description": "Default relevancy" }, "limit": { "type": "integer", "maximum": 20, "minimum": 1, "description": "Posts (default 10)" }, "since": { "type": "string", "description": "YYYY-MM-DD (last 7 days)" }, "until": { "type": "string", "description": "YYYY-MM-DD" }, "words": { "type": "string", "description": "All of these words" }, "phrase": { "type": "string", "description": "Exact phrase" }, "anyWords": { "type": "string", "description": "Any of these words (space/comma separated)" }, "hashtags": { "type": "string", "description": "Hashtags (comma separated, # optional)" }, "minLikes": { "type": "integer", "minimum": 0 }, "username": { "type": "string", "description": "Timeline shortcut: posts from this handle" }, "noneWords": { "type": "string", "description": "None of these words" }, "mentioning": { "type": "string", "description": "Mentions handle" }, "minReplies": { "type": "integer", "minimum": 0 }, "minReposts": { "type": "integer", "minimum": 0 }, "next_token": { … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "n": 1, "q": "bitcoin", "next": [ "/crypto/prices?symbols=BTC", "/crypto/prediction-markets?q=bitcoin", "/crypto/market-pulse" ], "posts": [ { "id": "1851234567890123456", "url": "https://x.com/example/status/1851234567890123456", "lang": "en", "text": "$BTC ETF inflows strong again, ATH watch", "author": { "name": "Example", "handle": "example", "verified": true, "followers": 250000 }, "metrics": { "likes": 1200, "quotes": 12, "replies": 85, "reposts": 210 }, "created_at": "2026-10-30T01:20:00Z" } ], "signal": { "cashtags": [ "$BTC" ], "sentiment": "bullish", "top_claim": { "url": "https://x.com/example/status/1851234567890123456", "text": "$BTC ETF inflows strong again, ATH watch", "handle": "example" }, "top_terms": [ "etf", "inflows", "ath" ], "engagement": { "likes": 1200, "replies": 85, "reposts": 210 }, "notable_handles": [ { "handle": "example", "followers": 250000 } ], "sentiment_score": 0.4 }, "source": "x-api-v2-recent-search", "updated_at": "2026-10-30T01:50:00Z" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-twitter-tweet-search-for-crypto-onchain-agents-28bcb8bd/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)