{"uid":"cap_A-BZDs80rOg1VoUtHFXHd","slug":"x-twitter-search-for-crypto-agents-via-x402-bc3417c6","name":"X (Twitter) Search for Crypto Agents 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/api/x-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_uHPipBvXjx995aeE8q1Va","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 X (Twitter) posts with advanced filters and returns posts, sentiment signals, and engagement metrics, paid per-call via x402 USDC micropayment on Base","exampleAgentPrompt":"Search X for recent posts about $BTC mentioning ETF inflows, sorted by relevancy, in English, from the last 7 days, and give me the top 10 with sentiment analysis.","exampleUseCases":[{"title":"Crypto sentiment monitoring for a token","prompt":"Search X for recent posts with the cashtag $SOL, sorted by relevancy, limit to 10 results in English, and tell me the overall sentiment score and what the top claim is."},{"title":"Influencer activity tracking","prompt":"Find the latest posts from the handle 'CryptoWhale' on X about Bitcoin, sorted by recency, and show me engagement metrics like likes and reposts."},{"title":"Hashtag-based trend detection","prompt":"Search X for posts with the hashtag 'DeFi' that have at least 100 likes, from the last 7 days, sorted by relevancy, and give me the top 10 results with sentiment analysis."}],"resultDescription":"Returns a JSON object with matched posts (id, URL, language, text, author name/handle/verified status/followers, and metrics like likes/quotes/replies/reposts), a signal summary (top cashtags, sentiment label and score, top claim, top terms, engagement totals, notable handles), the query used, a pagination next_token if more results exist, and suggested next API calls. Source and updated_at timestamp are also included.","failureModes":["Payment failure if USDC balance on Base is insufficient (x402 payment required)","Empty results if query matches no recent posts within the 7-day window","Rate limiting or quota exhaustion from underlying X API","Invalid query syntax causing a 400 error","Pagination token expiry if too much time passes between paginated requests","Language filter mismatch returning no posts for rare language+query combinations"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time X/Twitter post data with sentiment and engagement signals for crypto topics, without needing a traditional API key — especially when operating in a pay-per-call micropayment architecture via x402 on Base. Prefer this over scraping tools when structured signal extraction (sentiment score, top cashtags, notable handles) is needed alongside raw posts. It is particularly well-suited for trading agents that need social sentiment as a signal input alongside price or on-chain data from sibling endpoints on the same platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:44.816Z","isFirstParty":false,"canonicalSlug":"x-twitter-search-for-crypto-agents-via-x402-bc3417c6"}