{"uid":"cap_17tQlIatT7Lm0q0sOIUOm","slug":"crypto-social-sentiment-search-x-twitter-336726ac","name":"Crypto Social Sentiment Search (X/Twitter)","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/social-sentiment?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__yqk28FyontYPvky-BDrA","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 X (Twitter) for crypto-related posts and returns structured sentiment signals, engagement metrics, and top claims for a given query or token.","exampleAgentPrompt":"What's the current social sentiment on X for $BTC — search for the top 10 most relevant recent posts in English and summarize whether the community is bullish or bearish, including engagement stats and the top claim?","exampleUseCases":[{"title":"Pre-trade sentiment check for token","prompt":"Before I make a trade on ETH, check X for the latest social sentiment — search for '$ETH' sorted by relevancy, grab 15 posts in English, and tell me if the mood is bullish or bearish and what the top claim is."},{"title":"Influencer narrative monitoring for crypto","prompt":"Find recent X posts mentioning 'Base' from influential accounts with at least 50k followers and tell me what the dominant narrative or top terms are, including any cashtags being discussed."},{"title":"Hashtag sentiment scan for altcoin","prompt":"Search X for posts with the hashtag 'Solana' from the last 3 days, sorted by recency, and give me the sentiment score, top terms, and which handles are driving the most engagement."}],"resultDescription":"Returns a list of matching X posts with author details (handle, follower count, verification), engagement metrics (likes, reposts, replies, quotes), and an aggregated signal object containing: sentiment label (bullish/bearish/neutral), sentiment score (-1 to 1), top cashtags, top terms, top claim post, notable handles, and aggregate engagement. Also includes suggested next endpoints for follow-up calls and a pagination token for additional results.","failureModes":["No posts found for obscure or misspelled query — returns empty posts array","Query too broad returns low-signal posts with neutral sentiment","Rate limit or X API upstream error returns 5xx","Invalid date range (since/until outside 7-day window) causes 400","Payment failure via x402 (insufficient USDC balance) blocks the call","next_token expired or invalid causes pagination failure"],"whenToPreferThis":"Use this endpoint when an AI trading or onchain agent needs real-time social sentiment from X for a specific crypto token, narrative, or handle — especially when the agent wants a structured sentiment score and top claim rather than raw tweet text. It is pay-per-call with no API key required (x402/USDC), making it ideal for autonomous agents that need to query crypto social signals on demand without managing API credentials. Prefer this over generic Twitter scrapers when you need the aggregated signal object with cashtag extraction and next-step endpoint suggestions tailored for crypto trading workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:09.539Z","isFirstParty":false,"canonicalSlug":"crypto-social-sentiment-search-x-twitter-336726ac"}