# Crypto Social Sentiment Search (X/Twitter) via x402 > Crypto Social Sentiment Search (X/Twitter) 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). Searches X (Twitter) for crypto-related posts and returns structured social sentiment signals, post metrics, and cashtag analysis for a given query. ## Facts - Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/v1/crypto/social?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-social-sentiment-search-x-twitter-via-x402-6a8937ac - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3dSwNrAtHHufS2yxBPmUz 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-social-sentiment-search-x-twitter-via-x402-6a8937ac ``` Example prompt: Search X for the latest posts about $BTC, sorted by recency, and give me the sentiment signal — what are people saying, what's the top claim, and who are the notable accounts posting about it? ## When to prefer this Choose this endpoint when an AI trading or onchain agent needs real-time social sentiment from X (Twitter) for a specific crypto token, handle, or topic — especially when combined with price or market data from sibling endpoints. Ideal for pre-trade sentiment checks, monitoring token launch buzz, or tracking influential crypto accounts. Prefer this over general web search when you need structured engagement metrics, cashtag extraction, and a ready-made sentiment score rather than raw HTML or unstructured text. ## Known failure modes - Query too long (>200 chars) returns 400 validation error - No results found for niche or misspelled query returns empty posts array - since/until outside the allowed 7-day window returns error or empty results - Payment failure via x402 (insufficient USDC balance) returns 402 with payment details - X API rate limits or downtime cause 502/503 errors - Invalid next_token for pagination returns error or restarts from beginning ## 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 X posts (id, URL, text, author handle/name/followers/verified, language, created_at, and per-post metrics: likes, reposts, replies, quotes), plus an aggregated signal object containing overall sentiment label (bullish/bearish/neutral), sentiment score, top cashtags mentioned, top terms, top claim post, engagement totals, and notable handles. Also 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-social-sentiment-search-x-twitter-via-x402-6a8937ac/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)