# Crypto Tweet Search & Social Signal Endpoint > Crypto Tweet Search & Social Signal Endpoint 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 for crypto topics and returns posts with aggregated social signals including sentiment, top claims, and engagement metrics ## Facts - Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/crypto/tweets?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/crypto-tweet-search-social-signal-endpoint-b9006e16 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NR_Tt31kY-605myRL2X9B 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 crypto-tweet-search-social-signal-endpoint-b9006e16 ``` Example prompt: Search X for the most recent posts about $BTC from the last 3 days, sorted by recency, and give me the sentiment signal and top claim — show me up to 10 results in English. ## When to prefer this Use this endpoint when you need real-time social sentiment, trending narratives, or community chatter around a crypto asset or topic on X, especially when you want aggregated signal (sentiment score, top claim, notable handles) alongside raw posts. Prefer this over generic web search when you specifically want X/Twitter data with crypto-focused signal processing. Ideal for pre-trade sentiment checks, narrative discovery, or monitoring influencer activity around a token. ## Known failure modes - Empty result set if query matches no recent tweets within the 7-day window - Rate limiting or upstream X API errors returning 5xx - Invalid query syntax or unsupported operators returning 400 - Pagination token expiry causing loss of result context - Language filter returning zero results for niche queries ## 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 (up to 20) each with text, author info (name, handle, verified status, follower count), engagement metrics (likes, replies, reposts, quotes), language, timestamp, and URL. Also includes an aggregated signal object with overall sentiment label, sentiment score, extracted cashtags, top terms, top claim post, notable handles, and engagement totals. Includes a next_token for pagination and suggested follow-up 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/crypto-tweet-search-social-signal-endpoint-b9006e16/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)