{"uid":"cap_NR_Tt31kY-605myRL2X9B","slug":"crypto-tweet-search-social-signal-endpoint-b9006e16","name":"Crypto Tweet Search & Social Signal Endpoint","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/tweets?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_h5i8qR3T-v2tBiYCMamlJ","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 for crypto topics and returns posts with aggregated social signals including sentiment, top claims, and engagement metrics","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Token sentiment check before trade","prompt":"Search X for recent posts mentioning $ETH and tell me whether the overall sentiment is bullish or bearish right now — show me the top 10 most relevant posts and the top claim."},{"title":"Influencer chatter monitor for a specific handle","prompt":"Pull the latest tweets from handle @CryptoKaleo about Bitcoin and show me their engagement stats and what the top claims are."},{"title":"Narrative discovery for a new DeFi protocol","prompt":"Search X for posts containing the hashtag 'Hyperliquid' from the past 7 days, sorted by relevancy, with at least 50 likes — what are people saying and what's the overall sentiment?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:49.150Z","isFirstParty":false,"canonicalSlug":"crypto-tweet-search-social-signal-endpoint-b9006e16"}