{"uid":"cap_wxP6-HBgQY-HRL_zJEvAD","slug":"crypto-twitter-search-via-x402-be8ce43e","name":"Crypto Twitter Search via x402","description":"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.","url":"https://kr-x402-mvp.kgy5612.workers.dev/crypto/twitter-search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":"string","description":"Pagination token from previous response"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DDVokmTrA5Vn2JpCkSblB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search recent X (Twitter) posts about crypto topics and return structured signals including sentiment, top claims, engagement metrics, and cashtag mentions — paid per-call with USDC on Base via x402.","exampleAgentPrompt":"Search X for the latest tweets about $BTC ETF inflows sorted by recency, limit 15 results in English, and tell me the overall sentiment and top claims being made.","exampleUseCases":[{"title":"Pre-trade sentiment check on token","prompt":"Before I make a trade, search X for recent posts about $SOL sorted by relevancy, up to 10 results, and summarize the sentiment — is the crowd bullish or bearish right now?"},{"title":"Monitor influencer narrative on protocol","prompt":"Search X for tweets from handle 'base' mentioning 'gas fees' in English, sorted by recency, and show me the top claim and any notable handles posting about it."},{"title":"Kimchi premium arbitrage signal check","prompt":"Search X for posts with the phrase 'kimchi premium' from the last 7 days, limit 20, sorted by relevancy — I want to see the sentiment score and top terms to gauge if there's real arb chatter."}],"resultDescription":"Returns a structured JSON object with: the matched posts (id, URL, text, author info, engagement metrics, language, timestamp), an aggregated signal block with detected cashtags, overall sentiment label (e.g. 'bullish'), sentiment score (-1 to 1), top claim (most-engaged post), top terms, engagement totals, notable handles with follower counts, plus a next_token for pagination and suggested follow-on endpoint paths.","failureModes":["Payment failure (402): USDC balance insufficient or x402 payment not attached","Invalid query (400): query string exceeds 200 chars or is empty","Date range out of bounds: since/until outside the 7-day recent-search window","No results found: query too narrow or niche term with no recent posts","Rate limit from upstream X API causing temporary unavailability","Invalid next_token: stale or malformed pagination token returns error"],"whenToPreferThis":"Choose this endpoint when your agent needs real-time crypto social sentiment or narrative intelligence from X without managing API keys — ideal for trading agents that want to cross-reference on-chain signals with crowd sentiment before executing, or for monitoring emerging narratives around specific tokens, protocols, or influencers. It is preferable over generic Twitter scraping tools when you need structured sentiment signals (score, cashtags, top claim) delivered in a single pay-per-call response with no auth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:08.994Z","isFirstParty":false,"canonicalSlug":"crypto-twitter-search-via-x402-be8ce43e"}