{"uid":"cap_-_JxZarBR4vho6xCDqeSN","slug":"botsmith-x-pulse-a17173c5","name":"botsmith X Pulse","description":"X Pulse ($0.05/call): Is X bullish or bearish on a ticker or topic right now? Reads the latest 40 X (Twitter) posts about it (retweets excluded) and has TypeSafe's Jev model score them into a calibrated probability that the chatter is bullish, plus a bullish/neutral/bearish stance with a probability for each, the time window and author count it covers, and the five most engaged posts to cite. One call, no X account or API key. Sentiment data, not investment advice.","url":"https://x402.botsmith.dev/x/pulse?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","required":["topic"],"properties":{"topic":{"type":"string","maxLength":100,"minLength":1,"description":"Ticker, name or X search query, e.g. \"$BTC\", \"Solana\" or \"x402\""}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["topic","bullish","bearish","stance","sample","topPosts","model"],"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Jev model version that scored it"},"topic":{"type":"string"},"sample":{"type":"object","required":["posts","authors","from","to"],"properties":{"to":{"anyOf":[{"type":"string"},{"type":"null"}]},"from":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Oldest post read, ISO 8601"},"posts":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"authors":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991}},"additionalProperties":false},"stance":{"anyOf":[{"type":"object","required":["pick","confidence","probabilities"],"properties":{"pick":{"enum":["bullish","neutral","bearish"],"type":"string"},"confidence":{"type":"number"},"probabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}}},"additionalProperties":false},{"type":"null"}]},"bearish":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"1 - bullish"},"bullish":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Probability the chatter is bullish, 0 to 1; null if no posts"},"topPosts":{"type":"array","items":{"type":"object","required":["url","author","text","createdAt","likes","views"],"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"likes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"description":"Five most engaged posts read"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ojLeRJ9vfTfLiduAYRwiN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores the latest 40 X (Twitter) posts about a ticker or topic into a bullish/neutral/bearish sentiment probability using the Jev model","exampleAgentPrompt":"What's the current X sentiment on $BTC — is the crowd bullish or bearish right now, and how confident is the model?","exampleUseCases":[{"title":"Pre-trade crypto sentiment check","prompt":"Before I make a move on Solana, check what X is saying about $SOL right now — is the crowd leaning bullish or bearish, and what's the probability?"},{"title":"Topic buzz sentiment for new protocol","prompt":"Is x402 getting positive or negative chatter on X right now? Give me the bullish probability and show me the most engaged posts."},{"title":"Sentiment monitoring for portfolio ticker","prompt":"What's the current X mood on $ETH — bullish, neutral, or bearish? I want the confidence score and the top posts driving the conversation."}],"resultDescription":"Returns a bullish probability (0–1), a bearish probability (1 minus bullish), a stance object with pick (bullish/neutral/bearish), confidence score, and per-label probabilities, plus sample metadata covering post count, unique author count, and the time window of posts read, and an array of the five most-engaged posts with URL, author, text, creation time, likes, and views. Also includes the Jev model version used.","failureModes":["No posts found for the topic returns null for bullish/bearish/stance fields","Topic string too short (< 1 char) or too long (> 100 chars) causes validation error","Downstream X data fetch failure returns an error with no sentiment output","Payment not received or x402 handshake fails results in 402 Payment Required response","Ambiguous query may return low-confidence or neutral stance"],"whenToPreferThis":"Choose this endpoint when you need a fast, single-call social sentiment read on a crypto ticker or topic from X without needing your own X account or API key. It is purpose-built for financial sentiment use cases with calibrated probabilities and curated top posts for citation, making it superior to raw search endpoints when you want scored, structured sentiment rather than raw post lists.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:31:21.532Z","isFirstParty":false,"canonicalSlug":"botsmith-x-pulse-a17173c5"}