# X (Twitter) Search for Crypto Agents via x402 > X (Twitter) Search for Crypto Agents via x402 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). Search X (Twitter) posts with advanced filters and returns posts, sentiment signals, and engagement metrics, paid per-call via x402 USDC micropayment on Base ## Facts - Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/api/x-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-search-for-crypto-agents-via-x402-bc3417c6 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A-BZDs80rOg1VoUtHFXHd 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-search-for-crypto-agents-via-x402-bc3417c6 ``` Example prompt: Search X for recent posts about $BTC mentioning ETF inflows, sorted by relevancy, in English, from the last 7 days, and give me the top 10 with sentiment analysis. ## When to prefer this Use this endpoint when an AI agent needs real-time X/Twitter post data with sentiment and engagement signals for crypto topics, without needing a traditional API key — especially when operating in a pay-per-call micropayment architecture via x402 on Base. Prefer this over scraping tools when structured signal extraction (sentiment score, top cashtags, notable handles) is needed alongside raw posts. It is particularly well-suited for trading agents that need social sentiment as a signal input alongside price or on-chain data from sibling endpoints on the same platform. ## Known failure modes - Payment failure if USDC balance on Base is insufficient (x402 payment required) - Empty results if query matches no recent posts within the 7-day window - Rate limiting or quota exhaustion from underlying X API - Invalid query syntax causing a 400 error - Pagination token expiry if too much time passes between paginated requests - Language filter mismatch returning no posts for rare language+query combinations ## 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 JSON object with matched posts (id, URL, language, text, author name/handle/verified status/followers, and metrics like likes/quotes/replies/reposts), a signal summary (top cashtags, sentiment label and score, top claim, top terms, engagement totals, notable handles), the query used, a pagination next_token if more results exist, and suggested next API calls. Source and updated_at timestamp are also included. ## 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-search-for-crypto-agents-via-x402-bc3417c6/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)