{"name":"botsmith","summary":"Real-time market signal for trading agents: what the market is saying (X), what it expects (prediction markets), what it is positioned for (perp funding and open interest) and what it settles in (stablecoin pegs). Pay per call in USDC or USD₮0, no account and no API key.","protocol":"x402","x402Version":2,"network":"eip155:8453","payTo":"0xcb9b3F94387389e38EF2A7b3C0B851FB8325d7e9","paywallEnabled":true,"baseUrl":"https://x402.botsmith.dev","suites":[{"id":"x-intel","name":"Social Signal","summary":"What the market is saying: X (Twitter) posts, profiles, search and account dossiers as clean JSON, no account or API key required.","tags":["x","twitter","social","sentiment","signal"],"services":[{"id":"tweet","name":"X Tweet Lookup","version":"0.1.0","summary":"Fetch a single X (Twitter) post by id: text, author, metrics, entities.","tags":["x","twitter","social","tweet","lookup"],"routes":[{"method":"GET","path":"/x/tweet","url":"https://x402.botsmith.dev/x/tweet","price":"$0.005","summary":"Fetch one X (Twitter) post by numeric id: full text, author, ISO timestamp, like/retweet/reply/view counts, hashtags, expanded links and mentions as clean JSON. No X account or API key needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","pattern":"^[0-9]{1,25}$","description":"Numeric tweet/post id"}},"required":["id"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"type":"object","properties":{"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["handle","name","id"],"additionalProperties":false},"metrics":{"type":"object","properties":{"likes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["likes","retweets","replies","quotes","views"],"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"}},"required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"additionalProperties":false},"examples":{"input":{"id":"1846987139428634858"},"output":{"id":"1846987139428634858","url":"https://x.com/example/status/1846987139428634858","text":"Shipping the new agent payments stack today. HTTP 402 is finally real.","createdAt":"2026-07-01T07:00:30.000Z","lang":"en","author":{"handle":"example","name":"Example Dev","id":"44196397"},"metrics":{"likes":1200,"retweets":340,"replies":85,"quotes":12,"views":250000},"hashtags":["x402"],"links":["https://x402.org"],"mentions":["coinbase"]}}}]},{"id":"user","name":"X User Profile","version":"0.1.0","summary":"Fetch an X (Twitter) account profile by handle: bio, followers, age, verification.","tags":["x","twitter","social","profile","account"],"routes":[{"method":"GET","path":"/x/user","url":"https://x402.botsmith.dev/x/user","price":"$0.004","summary":"Fetch an X (Twitter) account by handle: display name, bio, follower/following/tweet counts, account creation date and age in days, verification status, location and profile image. No X account or API key needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"}},"required":["handle"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"handle":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"profileImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"object","properties":{"blue":{"type":"boolean"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["blue","type"],"additionalProperties":false},"followers":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"following":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"tweetCount":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 account creation time"},"accountAgeDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["handle","id","name","bio","url","location","profileImage","verified","followers","following","tweetCount","createdAt","accountAgeDays"],"additionalProperties":false},"examples":{"input":{"handle":"naval"},"output":{"handle":"naval","id":"745273","name":"Naval","bio":"Deploy capital and code.","url":"https://x.com/naval","location":null,"profileImage":"https://pbs.twimg.com/profile_images/example.jpg","verified":{"blue":true,"type":null},"followers":2900000,"following":1200,"tweetCount":42000,"createdAt":"2007-02-01T05:44:27.000Z","accountAgeDays":7106}}}]},{"id":"search","name":"X Tweet Search","version":"0.1.0","summary":"Search recent X (Twitter) posts with full query syntax; one page of results per call.","tags":["x","twitter","social","search","monitoring"],"routes":[{"method":"GET","path":"/x/search","url":"https://x402.botsmith.dev/x/search","price":"$0.005","summary":"Search X (Twitter) posts with full advanced-search syntax (from:, since:, until:, exact phrases, boolean operators). Returns up to 20 posts per call as clean JSON with metrics and entities, plus a cursor for the next page. No X account or API key needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":400,"description":"Search query, e.g. \"x402 from:coinbase since:2026-07-01\""},"type":{"default":"Latest","description":"Sort by recency or engagement","type":"string","enum":["Latest","Top"]},"cursor":{"description":"Pagination cursor from a previous call","type":"string","pattern":"^[A-Za-z0-9+/=_-]{1,400}$"}},"required":["query","type"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"type":"object","properties":{"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["handle","name","id"],"additionalProperties":false},"metrics":{"type":"object","properties":{"likes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["likes","retweets","replies","quotes","views"],"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"}},"required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"additionalProperties":false},"description":"Up to 20 matching posts"},"hasNextPage":{"type":"boolean"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["tweets","hasNextPage","nextCursor"],"additionalProperties":false},"examples":{"input":{"query":"x402 payments","type":"Latest"},"output":{"tweets":[{"id":"1846987139428634858","url":"https://x.com/example/status/1846987139428634858","text":"Shipping the new agent payments stack today. HTTP 402 is finally real.","createdAt":"2026-07-01T07:00:30.000Z","lang":"en","author":{"handle":"example","name":"Example Dev","id":"44196397"},"metrics":{"likes":1200,"retweets":340,"replies":85,"quotes":12,"views":250000},"hashtags":["x402"],"links":["https://x402.org"],"mentions":["coinbase"]}],"hasNextPage":true,"nextCursor":"DAACCgACGgAAAAAAAAA"}}}]},{"id":"dossier","name":"X Account Dossier","version":"0.1.0","summary":"One-call X (Twitter) account intelligence: profile, recent-activity analytics and bot-likelihood signals.","tags":["x","twitter","social","dossier","intel","bot-detection"],"routes":[{"method":"GET","path":"/x/dossier","url":"https://x402.botsmith.dev/x/dossier","price":"$0.02","summary":"Full X (Twitter) account dossier in one call: profile, an analysis of recent posts (cadence, average engagement, reply/retweet/link share, top hashtags and mentions), the raw recent posts, and a transparent bot-likelihood signal with the evidence behind it. Composes profile + activity so an agent vetting an account does not have to. No X account or API key needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"},"sampleSize":{"default":20,"description":"How many recent posts to analyze (max 20)","type":"integer","minimum":1,"maximum":20}},"required":["handle","sampleSize"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profile":{"type":"object","properties":{"handle":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"profileImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"object","properties":{"blue":{"type":"boolean"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["blue","type"],"additionalProperties":false},"followers":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"following":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"tweetCount":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 account creation time"},"accountAgeDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["handle","id","name","bio","url","location","profileImage","verified","followers","following","tweetCount","createdAt","accountAgeDays"],"additionalProperties":false},"activity":{"type":"object","properties":{"sampleSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"spanDays":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Days between oldest and newest sampled post"},"postsPerDay":{"anyOf":[{"type":"number"},{"type":"null"}]},"avgLikes":{"anyOf":[{"type":"number"},{"type":"null"}]},"avgRetweets":{"anyOf":[{"type":"number"},{"type":"null"}]},"avgReplies":{"anyOf":[{"type":"number"},{"type":"null"}]},"replyShare":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Fraction of sampled posts that are replies"},"retweetShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"withLinksShare":{"anyOf":[{"type":"number"},{"type":"null"}]},"topHashtags":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["tag","count"],"additionalProperties":false}},"topMentions":{"type":"array","items":{"type":"object","properties":{"handle":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["handle","count"],"additionalProperties":false}}},"required":["sampleSize","spanDays","postsPerDay","avgLikes","avgRetweets","avgReplies","replyShare","retweetShare","withLinksShare","topHashtags","topMentions"],"additionalProperties":false},"authenticity":{"type":"object","properties":{"botLikelihood":{"type":"string","enum":["low","medium","high","unknown"]},"flags":{"type":"array","items":{"type":"string"},"description":"Transparent evidence behind the signal"}},"required":["botLikelihood","flags"],"additionalProperties":false}},"required":["profile","activity","authenticity"],"additionalProperties":false},"examples":{"input":{"handle":"naval","sampleSize":20},"output":{"profile":{"handle":"naval","id":"745273","name":"Naval","bio":"Deploy capital and code.","url":"https://x.com/naval","location":null,"profileImage":"https://pbs.twimg.com/profile_images/example.jpg","verified":{"blue":true,"type":null},"followers":2900000,"following":1200,"tweetCount":42000,"createdAt":"2007-02-01T05:44:27.000Z","accountAgeDays":7106},"activity":{"sampleSize":20,"spanDays":14.2,"postsPerDay":1.41,"avgLikes":4200,"avgRetweets":610,"avgReplies":180,"replyShare":0.15,"retweetShare":0.05,"withLinksShare":0.2,"topHashtags":[{"tag":"startups","count":3}],"topMentions":[{"handle":"paulg","count":2}]},"authenticity":{"botLikelihood":"low","flags":["no automation signals in profile or recent activity"]}}}}]},{"id":"watchlist","name":"X KOL Watchlist Monitor","version":"0.1.0","summary":"Monitor a list of X (Twitter) accounts in one call: new high-signal posts since your last poll, spam-filtered and deduped.","tags":["x","twitter","social","monitoring","watchlist","kol","signal"],"routes":[{"method":"GET","path":"/x/watchlist","url":"https://x402.botsmith.dev/x/watchlist","price":"$0.02","summary":"Watch up to 15 X (Twitter) accounts with one call: every new post from the list since your last poll, above your engagement floor, with retweets and crypto-spam (airdrop/giveaway/presale bait) filtered out and duplicates removed. Pass the returned newestId back as sinceId to get only what is new - replaces the search + filter + dedupe + paging loop KOL-monitoring agents build by hand. No X account or API key needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"handles":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}(,\\s?@?[A-Za-z0-9_]{1,15}){0,14}$","description":"Comma-separated list of up to 15 X handles to monitor, with or without leading @"},"sinceId":{"description":"Only return posts newer than this id; pass the newestId from your last poll","type":"string","pattern":"^[0-9]{1,25}$"},"minFaves":{"default":5,"description":"Minimum likes a post needs to be included (engagement floor)","type":"integer","minimum":0,"maximum":100000},"lang":{"default":"en","description":"Restrict to posts in this language","type":"string","pattern":"^[a-z]{2}$"},"filter":{"default":"spam","description":"\"spam\" excludes airdrop/giveaway/presale bait; \"none\" returns everything","type":"string","enum":["spam","none"]}},"required":["handles","minFaves","lang","filter"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"author":{"type":"object","properties":{"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["handle","name","id"],"additionalProperties":false},"metrics":{"type":"object","properties":{"likes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["likes","retweets","replies","quotes","views"],"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"}},"required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"additionalProperties":false},"description":"New posts, newest first, deduped"},"newestId":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pass back as sinceId on your next poll"},"complete":{"type":"boolean","description":"False when more new posts exist than one call could fetch; poll again to catch up"},"query":{"type":"string","description":"The search query executed upstream, for transparency"},"polledAt":{"type":"string","description":"ISO 8601 time of this poll"}},"required":["posts","newestId","complete","query","polledAt"],"additionalProperties":false},"examples":{"input":{"handles":"aeyakovenko,0xMert_,blknoiz06","minFaves":5,"lang":"en","filter":"spam"},"output":{"posts":[{"id":"1846987139428634858","url":"https://x.com/example/status/1846987139428634858","text":"Shipping the new agent payments stack today. HTTP 402 is finally real.","createdAt":"2026-07-01T07:00:30.000Z","lang":"en","author":{"handle":"example","name":"Example Dev","id":"44196397"},"metrics":{"likes":1200,"retweets":340,"replies":85,"quotes":12,"views":250000},"hashtags":["x402"],"links":["https://x402.org"],"mentions":["coinbase"]}],"newestId":"1846987139428634858","complete":true,"query":"(from:aeyakovenko OR from:0xMert_ OR from:blknoiz06) min_faves:5 lang:en -filter:retweets -airdrop -giveaway -presale -\"drop your\" -\"gm family\" -winner","polledAt":"2026-07-01T07:05:00.000Z"}}}]}]},{"id":"polymarket","name":"Prediction Market Signal","summary":"What the market expects: which Polymarket markets are worth watching and per-market microstructure for the ones that are.","tags":["polymarket","prediction-markets","odds","sentiment","signal"],"services":[{"id":"markets","name":"Best Markets to Watch","version":"0.1.0","summary":"Ranked, filterable list of the most watch-worthy Polymarket markets right now.","tags":["polymarket","prediction-markets","trending","data"],"routes":[{"method":"GET","path":"/polymarket/markets","url":"https://x402.botsmith.dev/polymarket/markets","price":"$0.005","summary":"The best Polymarket prediction markets to watch right now, ranked by a composite watch-score (24h volume, liquidity, competitiveness, momentum, time-to-resolution). Filter by tag. Returns implied probability, volume, liquidity, spread and a plain-English reason for each. Live data, no account needed.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"limit":{"default":10,"description":"How many markets to return","type":"integer","minimum":1,"maximum":25},"tag":{"description":"Filter by a Polymarket tag slug, e.g. 'politics', 'crypto', 'sports'","type":"string"},"sort":{"default":"watch","description":"Ranking: 'watch' = composite watch-score (default), or raw volume/liquidity","type":"string","enum":["watch","volume","liquidity"]}},"required":["limit","sort"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"yesPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Implied probability of the first outcome (0-1)"},"volume24hr":{"anyOf":[{"type":"number"},{"type":"null"}]},"liquidity":{"anyOf":[{"type":"number"},{"type":"null"}]},"spread":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"daysToResolution":{"anyOf":[{"type":"number"},{"type":"null"}]},"watchScore":{"type":"number","description":"0-100 composite: activity, depth, competitiveness, momentum, timing"},"why":{"type":"string","description":"Short human-readable reason this market ranks"}},"required":["question","slug","url","yesPrice","volume24hr","liquidity","spread","priceChange24h","daysToResolution","watchScore","why"],"additionalProperties":false}}},"required":["count","sort","markets"],"additionalProperties":false},"examples":{"input":{"limit":5,"sort":"watch"},"output":{"count":1,"sort":"watch","markets":[{"question":"Will the Fed cut rates in March?","slug":"will-the-fed-cut-rates-in-march","url":"https://polymarket.com/market/will-the-fed-cut-rates-in-march","yesPrice":0.42,"volume24hr":1830000,"liquidity":240000,"spread":0.01,"priceChange24h":0.05,"daysToResolution":12,"watchScore":78.4,"why":"$1.8M traded in 24h, +5pt move today, tightly contested, resolves in 12d"}]}}}]},{"id":"market","name":"Market Intel & Signals","version":"0.1.0","summary":"Per-market Polymarket snapshot with order-book microstructure signals.","tags":["polymarket","prediction-markets","microstructure","trading","data"],"routes":[{"method":"GET","path":"/polymarket/market","url":"https://x402.botsmith.dev/polymarket/market","price":"$0.006","summary":"Deep snapshot and execution microstructure for one Polymarket market: implied probability, best bid/ask/spread, 24h volume, liquidity depth, days to resolution, momentum, and estimated slippage to buy at $100 and $1000 order sizes from the live order book. Pass a slug, or omit it for the highest-volume open market right now. Signals are factual market data, not investment advice.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"description":"Polymarket market slug from a market URL, e.g. 'will-the-fed-cut-rates-in-march'. Omit to get the single highest-volume open market right now.","type":"string","minLength":1}},"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string"},"outcomes":{"type":"array","items":{"type":"string"}},"impliedProbability":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Price of the first outcome (0-1)"},"prices":{"type":"object","properties":{"bestBid":{"anyOf":[{"type":"number"},{"type":"null"}]},"bestAsk":{"anyOf":[{"type":"number"},{"type":"null"}]},"lastTrade":{"anyOf":[{"type":"number"},{"type":"null"}]},"spread":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["bestBid","bestAsk","lastTrade","spread"],"additionalProperties":false},"volume24hr":{"anyOf":[{"type":"number"},{"type":"null"}]},"liquidity":{"anyOf":[{"type":"number"},{"type":"null"}]},"liquidityRating":{"type":"string","enum":["thin","moderate","deep"]},"daysToResolution":{"anyOf":[{"type":"number"},{"type":"null"}]},"priceChange24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"signals":{"type":"object","properties":{"bookDepthUsd":{"anyOf":[{"type":"object","properties":{"bids":{"type":"number"},"asks":{"type":"number"}},"required":["bids","asks"],"additionalProperties":false},{"type":"null"}]},"slippage":{"type":"array","items":{"type":"object","properties":{"orderUsd":{"type":"number"},"avgPrice":{"anyOf":[{"type":"number"},{"type":"null"}]},"sharesFilled":{"type":"number"},"filled":{"type":"boolean"},"slippagePctVsBest":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["orderUsd","avgPrice","sharesFilled","filled","slippagePctVsBest"],"additionalProperties":false},"description":"Estimated average fill price to BUY the first outcome at $100 and $1000 order sizes"}},"required":["bookDepthUsd","slippage"],"additionalProperties":false,"description":"Execution microstructure derived from the live order book. Data, not investment advice."}},"required":["question","slug","url","outcomes","impliedProbability","prices","volume24hr","liquidity","liquidityRating","daysToResolution","priceChange24h","signals"],"additionalProperties":false},"examples":{"input":{},"output":{"question":"Will the Fed cut rates in March?","slug":"will-the-fed-cut-rates-in-march","url":"https://polymarket.com/market/will-the-fed-cut-rates-in-march","outcomes":["Yes","No"],"impliedProbability":0.42,"prices":{"bestBid":0.41,"bestAsk":0.43,"lastTrade":0.42,"spread":0.02},"volume24hr":1830000,"liquidity":240000,"liquidityRating":"deep","daysToResolution":12,"priceChange24h":0.05,"signals":{"bookDepthUsd":{"bids":120000,"asks":135000},"slippage":[{"orderUsd":100,"avgPrice":0.4305,"sharesFilled":232.3,"filled":true,"slippagePctVsBest":0.12},{"orderUsd":1000,"avgPrice":0.4342,"sharesFilled":2303.1,"filled":true,"slippagePctVsBest":0.98}]}}}}]}]},{"id":"derivatives","name":"Derivatives Signal","summary":"What the market is positioned for: cross-exchange perpetual-futures funding, open interest and sentiment.","tags":["crypto","derivatives","futures","funding","signal"],"services":[{"id":"perp","name":"Crypto Perp Snapshot","version":"0.1.0","summary":"Cross-exchange perpetual-futures snapshot: funding, open interest and sentiment in one call.","tags":["crypto","derivatives","futures","funding","trading","data"],"routes":[{"method":"GET","path":"/derivatives/perp","url":"https://x402.botsmith.dev/derivatives/perp","price":"$0.006","summary":"One-call perpetual-futures snapshot for a coin (BTC, ETH, SOL, ...): funding rate and open interest across Binance, Bybit and OKX, aggregate OI, average funding (annualized) with a longs-pay/shorts-pay read, mark price, next funding time and the Fear & Greed index. Keyless public exchange data; normalized so a trading agent gets one JSON instead of three exchange schemas.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9]{1,15}$","description":"Base coin symbol (USDT perp is assumed), e.g. BTC"}},"required":["symbol"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"symbol":{"type":"string"},"markPrice":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Binance mark price (anchor)"},"nextFundingTime":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO time of the next funding"},"venues":{"type":"array","items":{"type":"object","properties":{"venue":{"type":"string"},"fundingRate":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Current funding rate (per interval, e.g. 8h)"},"fundingRateAnnualizedPct":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Funding annualized to a percent"},"openInterestBase":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Open interest in base units"},"markPrice":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["venue","fundingRate","fundingRateAnnualizedPct","openInterestBase","markPrice"],"additionalProperties":false},"description":"Per-exchange funding, open interest and mark"},"aggregateOpenInterestBase":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Summed OI across venues, base units"},"avgFundingRate":{"anyOf":[{"type":"number"},{"type":"null"}]},"avgFundingAnnualizedPct":{"anyOf":[{"type":"number"},{"type":"null"}]},"fundingSkew":{"anyOf":[{"type":"string","enum":["longs pay","shorts pay","neutral"]},{"type":"null"}],"description":"Who pays funding now"},"fearGreed":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"classification":{"type":"string"}},"required":["value","classification"],"additionalProperties":false},{"type":"null"}],"description":"Crypto Fear & Greed index (0-100)"}},"required":["symbol","markPrice","nextFundingTime","venues","aggregateOpenInterestBase","avgFundingRate","avgFundingAnnualizedPct","fundingSkew","fearGreed"],"additionalProperties":false},"examples":{"input":{"symbol":"BTC"},"output":{"symbol":"BTC-PERP","markPrice":64587.4,"nextFundingTime":"2026-07-18T16:00:00.000Z","venues":[{"venue":"binance","fundingRate":0.00001117,"fundingRateAnnualizedPct":1.22,"openInterestBase":101352.15,"markPrice":64587.4},{"venue":"bybit","fundingRate":-0.00001327,"fundingRateAnnualizedPct":-1.45,"openInterestBase":54447.45,"markPrice":64593},{"venue":"okx","fundingRate":-0.0000169,"fundingRateAnnualizedPct":-1.85,"openInterestBase":31047.62,"markPrice":64599.9}],"aggregateOpenInterestBase":186847,"avgFundingRate":-0.0000063,"avgFundingAnnualizedPct":-0.69,"fundingSkew":"neutral","fearGreed":{"value":25,"classification":"Extreme Fear"}}}}]}]},{"id":"stablecoin","name":"Settlement Risk","summary":"What the market settles in: live peg deviation and supply for the stablecoins agents hold and pay with.","tags":["stablecoin","peg","depeg","settlement","signal"],"services":[{"id":"peg","name":"Stablecoin Peg Monitor","version":"0.1.0","summary":"Live peg and supply check for any stablecoin: deviation from target, circulating supply and chain spread.","tags":["stablecoin","defi","usdc","peg","crypto","risk","data"],"routes":[{"method":"GET","path":"/stablecoin/peg","url":"https://x402.botsmith.dev/stablecoin/peg","price":"$0.004","summary":"Live peg-and-supply snapshot for any stablecoin by symbol (USDC, USDT, DAI, ...): current price, signed deviation from peg in basis points, a depeg alert at 1%, total circulating supply and its top-chain breakdown. Keyless. Useful before settling or holding value in a given stablecoin.","input":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"symbol":{"type":"string","minLength":1,"maxLength":40,"description":"Stablecoin symbol (USDC, USDT, DAI) or name substring"}},"required":["symbol"],"additionalProperties":false},"output":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"pegType":{"type":"string","description":"e.g. peggedUSD, peggedEUR"},"pegMechanism":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"e.g. fiat-backed, crypto-backed, algorithmic"},"price":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Latest price in the peg currency"},"pegTarget":{"type":"number","description":"Intended peg value (1 for USD stablecoins)"},"pegDeviationBps":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Signed basis points off the peg target"},"depegAlert":{"type":"boolean","description":"True when |deviation| >= 100 bps (1%)"},"circulatingUsd":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Total circulating supply in USD"},"topChains":{"type":"array","items":{"type":"object","properties":{"chain":{"type":"string"},"circulatingUsd":{"type":"number"},"share":{"type":"number","description":"Fraction of total supply on this chain"}},"required":["chain","circulatingUsd","share"],"additionalProperties":false},"description":"Top chains by circulating supply"},"chainCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Chains the asset is live on"}},"required":["id","symbol","name","pegType","pegMechanism","price","pegTarget","pegDeviationBps","depegAlert","circulatingUsd","topChains","chainCount"],"additionalProperties":false},"examples":{"input":{"symbol":"USDC"},"output":{"id":"2","symbol":"USDC","name":"USD Coin","pegType":"peggedUSD","pegMechanism":"fiat-backed","price":0.9999,"pegTarget":1,"pegDeviationBps":-1,"depegAlert":false,"circulatingUsd":73409336950,"topChains":[{"chain":"Ethereum","circulatingUsd":41000000000,"share":0.558},{"chain":"Solana","circulatingUsd":9000000000,"share":0.123},{"chain":"Base","circulatingUsd":4200000000,"share":0.057}],"chainCount":84}}}]}]}]}