# Twitter/X Search for Crypto Agents (x402) > Twitter/X Search for Crypto Agents (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). Searches recent X (Twitter) posts by keyword, cashtag, handle, or hashtag and returns posts with engagement metrics and a crypto sentiment signal summary, paid per-call via x402 USDC. ## Facts - Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/twitter/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/twitter-x-search-for-crypto-agents-x402-57434086 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2icrvPo-kZi1jFoHYoLn4 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 twitter-x-search-for-crypto-agents-x402-57434086 ``` Example prompt: Search X for the most recent posts mentioning $ETH sorted by recency, limit to 10 posts in English, and tell me the overall sentiment and top claims. ## When to prefer this Use this endpoint when an AI trading or onchain agent needs real-time social sentiment, trending claims, or engagement signals from X about a crypto token, protocol, or handle, and does not want to manage API keys. Prefer this over direct X API integration when operating in an x402 pay-per-call micropayment environment and needing bundled sentiment signal extraction alongside raw posts. ## Known failure modes - Query string missing or empty — returns validation error - Date range outside last 7 days — X API limits recent search window - Rate limit or upstream X API error — 5xx or quota error from X - Payment not processed via x402 — 402 Payment Required response with payment details - Invalid next_token — pagination fails with 400 - Language filter typo returns no results ## 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 name/handle/verified status/followers, engagement metrics, language, timestamp), plus a signal object with extracted cashtags, sentiment label and score, top claim post, top terms, engagement totals, notable handles, and suggested next endpoints. Also includes the query used, total count, pagination token, source, and update timestamp. ## 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/twitter-x-search-for-crypto-agents-x402-57434086/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)