{"uid":"cap_2icrvPo-kZi1jFoHYoLn4","slug":"twitter-x-search-for-crypto-agents-x402-57434086","name":"Twitter/X Search for Crypto Agents (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/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_vBUlTf7fHdEFmCOIO8L8Q","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-trade token sentiment check","prompt":"Before I buy, search X for the last 7 days of posts mentioning $ARB, show me the sentiment score and the top claim so I can gauge social mood."},{"title":"Monitor a DeFi protocol on crypto Twitter","prompt":"Search X for posts mentioning 'Hyperliquid' from the last 3 days, sorted by relevancy, limit 15 results, and summarize what people are saying."},{"title":"Track a specific influencer's recent posts","prompt":"Pull the latest 10 posts from handle 'base' on X and give me their engagement metrics and any cashtags they're talking about."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:14.954Z","isFirstParty":false,"canonicalSlug":"twitter-x-search-for-crypto-agents-x402-57434086"}