# botsmith

> Three pay-per-call APIs for AI agents: X (Twitter) posts, accounts, trends and search; Polymarket market discovery and per-market signals; and Jev, TypeSafe's calibrated decision model. USDC on Base, no account and no API key.

Every paid route answers an unpaid request with HTTP 402 and an x402 `PAYMENT-REQUIRED` header; pay with any x402 client and retry. Inputs are validated before payment, so a bad request is never charged.

## Machine-readable

- [Catalog](https://x402.botsmith.dev/catalog): every route with JSON Schemas, prices and examples
- [OpenAPI 3.1](https://x402.botsmith.dev/openapi.json)
- [x402 discovery document](https://x402.botsmith.dev/.well-known/x402)

## Social Signal

What the market is saying: X (Twitter) posts, profiles, search, mentions, timelines, threads, followers, trends, account dossiers and Jev-scored pulse as clean JSON, no account or API key required.

- [GET /x/tweet](https://x402.botsmith.dev/x/tweet): X Tweet Lookup. 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. ($0.015 USDC)
- [GET /x/user](https://x402.botsmith.dev/x/user): X User Profile. 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. ($0.015 USDC)
- [GET /x/search](https://x402.botsmith.dev/x/search): X Tweet Search. 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. ($0.02 USDC)
- [GET /x/dossier](https://x402.botsmith.dev/x/dossier): X Account Dossier. 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. ($0.05 USDC)
- [GET /x/watchlist](https://x402.botsmith.dev/x/watchlist): X KOL Watchlist Monitor. 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. ($0.05 USDC)
- [GET /x/mentions](https://x402.botsmith.dev/x/mentions): X Mentions. Who is talking about an X (Twitter) account: the 20 latest posts that mention the handle, newest first, as clean JSON with metrics and entities, plus the accounts mentioning it most on the page and a cursor for older mentions. Optional sinceTime (unix seconds) to poll only what is new. No X account or API key needed. ($0.01 USDC)
- [GET /x/timeline](https://x402.botsmith.dev/x/timeline): X User Timeline. Latest posts by an X (Twitter) account: up to 20 per call, newest first, as clean JSON with metrics, hashtags, links and mentions, plus a cursor for older posts. Replies excluded unless includeReplies=true. No X account or API key needed. ($0.01 USDC)
- [GET /x/thread](https://x402.botsmith.dev/x/thread): X Thread Unroll. Unroll an X (Twitter) thread from any post id in it: the conversation author's posts oldest first with their text joined for reading, then the replies around it, each with metrics and its reply-to id. Pass the cursor for more replies. No X account or API key needed. ($0.01 USDC)
- [GET /x/followers](https://x402.botsmith.dev/x/followers): X Follower Sample. Sample an X (Twitter) account's audience: its 40 newest followers with full profiles (bio, follower counts, account age, verification), how many of them are verified (checked against the account's verified-follower list, not X's dead legacy flag) and that share, plus the account's total follower count. No X account or API key needed. ($0.01 USDC)
- [GET /x/trends](https://x402.botsmith.dev/x/trends): X Trends. Top 30 trending topics on X (Twitter) right now for a location by Yahoo WOEID: 1 worldwide, 23424977 United States, 23424975 United Kingdom, 23424856 Japan, 23424748 Australia, 2459115 New York, 44418 London. Each with rank and the search query to pull its posts. The location actually served is echoed back. No X account or API key needed. ($0.005 USDC)
- [GET /x/users/search](https://x402.botsmith.dev/x/users/search): X User Search. Find X (Twitter) accounts by keyword: up to 20 matching accounts per call with full profiles (bio, follower counts, account age, verification) as clean JSON, plus a cursor for more. No X account or API key needed. ($0.01 USDC)
- [GET /x/pulse](https://x402.botsmith.dev/x/pulse): X Pulse. 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. ($0.05 USDC)

## Prediction Market Signal

What the market expects: which Polymarket markets are worth watching, per-market microstructure for the ones that are, and their odds beside what X says.

- [GET /polymarket/markets](https://x402.botsmith.dev/polymarket/markets): Best Markets to Watch. 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. ($0.02 USDC)
- [GET /polymarket/market](https://x402.botsmith.dev/polymarket/market): Market Intel & Signals. 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. ($0.02 USDC)
- [GET /polymarket/chatter](https://x402.botsmith.dev/polymarket/chatter): Market Chatter. A Polymarket market's odds next to what X (Twitter) is saying about it, in one call: implied probability, 24h move, volume and days to resolution, beside the latest X posts about the question (retweets excluded) with post and author counts, the time window and the five most engaged posts. TypeSafe's Jev model reads the posts and gives the probability the chatter expects yes, and the divergence from the market's price. Pass a slug (or omit it for the busiest open market) and optionally your own X query. Data, not investment advice. ($0.03 USDC)

## Decision Signal

What to do about it: TypeSafe's Jev System One model turns a state plus typed questions into calibrated probabilities, picks and scores instead of prose.

- [POST /jev](https://x402.botsmith.dev/jev): Jev Decision. Ask Jev (TypeSafe System One) typed questions about one state and get numbers back, not text: noul answers the probability a yes/no is yes; choice picks an option with a probability for every option; score places the state on an ordered scale of levels with a probability for every level. Same body and answer as TypeSafe's POST /v1/systemone (model optional, state as text or JSON, questions keyed by your ids), so their docs and SDK question helpers apply; pay per call instead of sending an API key. Answers are calibrated and deterministic for the same input, so the threshold that turns a probability into an action can live in the agent's own code. ($0.005 USDC)