{"uid":"cap_ROMe62EHH6GHcopnnUnYL","slug":"x-twitter-crypto-tweet-search-with-sentiment-signal-a0cc6a52","name":"X/Twitter Crypto Tweet Search with Sentiment Signal","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/tweets/user?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_B4cpsQlSAucBzB4ueo5A0","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-related queries and returns posts plus a structured sentiment/signal summary including cashtags, sentiment score, top claims, and engagement metrics.","exampleAgentPrompt":"Search X for recent posts about $BTC mentioning ETF inflows, sorted by relevancy, and give me the sentiment signal and top engagement stats — up to 10 posts in English.","exampleUseCases":[{"title":"Token sentiment check before trade","prompt":"Before I enter a position on $SOL, search X for the latest 15 posts about $SOL sorted by relevancy and tell me if sentiment is bullish or bearish, and what the top claim is."},{"title":"Influencer timeline monitoring","prompt":"Pull the last 10 tweets from handle 'CryptoKaleo' on X and summarize what he's been saying, including any cashtags and engagement numbers."},{"title":"Hashtag trend and engagement scan","prompt":"Search X for posts with the hashtag 'BaseChain' from the last 3 days, sorted by recency, and show me the top terms, sentiment score, and which handles have the most followers in the results."}],"resultDescription":"Returns a list of matching posts (id, url, text, author name/handle/verified status/follower count, created_at, language, engagement metrics), a structured signal object (cashtags found, bullish/bearish sentiment label and score 0–1, top claim post, top terms, aggregate engagement, notable handles), the original query, a source tag, an updated_at timestamp, and a next-page token plus suggested follow-up endpoint paths.","failureModes":["Empty results if query matches no posts in the last 7 days (n=0)","Payment failure if x402 USDC payment on Base is not completed or insufficient","Rate limiting or 402 response if payment is malformed","Invalid query syntax causes API error from upstream X API","date range outside 7-day window returns no results","next_token invalid or expired causes pagination error"],"whenToPreferThis":"Choose this endpoint when an AI trading or onchain agent needs real-time social sentiment from X for a crypto token, protocol, or handle — especially when a structured signal summary (sentiment score, top claim, cashtags, notable handles) is needed alongside raw posts. It is preferable over generic Twitter scrapers because it bundles sentiment analysis into the same pay-per-call response with no API key required, using x402 micropayments on Base. Use it when the agent needs to correlate on-chain price data with social narrative, or to monitor community reaction to on-chain events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:03.970Z","isFirstParty":false,"canonicalSlug":"x-twitter-crypto-tweet-search-with-sentiment-signal-a0cc6a52"}