# orchard-data

> Pay-per-call market data and agent tools (web-read, email-verify, token-check)
> for AI agents over the x402 protocol. USDC on Base
> (network eip155:8453). No account, no API key, no subscription: GET an endpoint,
> receive HTTP 402 with payment requirements, sign a USDC micro-payment, retry.

## Free — no wallet required
- [/](https://orchard-data.letom1176.workers.dev/) — product manifest with live prices
- [/openapi.json](https://orchard-data.letom1176.workers.dev/openapi.json) — machine-readable spec
- [/api/sample](https://orchard-data.letom1176.workers.dev/api/sample) — a full real response showing exactly what a paid call returns
- [/api/feed-status](https://orchard-data.letom1176.workers.dev/api/feed-status) — per-product data freshness, check before you buy

## Paid products
- [/api/backtest](https://orchard-data.letom1176.workers.dev/api/backtest) — $0.10 — Honest backtest of your entry rule on 10y of real bars — train/test halves, no look-ahead, baselines printed, noise flagged as noise
- [/api/symbol-dossier](https://orchard-data.letom1176.workers.dev/api/symbol-dossier) — $0.02 — One-call deep ticker context: quote + 1y technicals + expected move + regime + news catalysts — cheaper than buying the parts separately
- [/api/regime-forecast](https://orchard-data.letom1176.workers.dev/api/regime-forecast) — $0.01 — ML market-regime forecast with verifiable accuracy — audit the scored ledger before you buy
- [/api/catalyst-radar](https://orchard-data.letom1176.workers.dev/api/catalyst-radar) — $0.01 — Tickers with a fresh news catalyst (bullish + bearish) and the headline behind each: a live trading system's AI scanner, or a disclosed 12h headline scan when it is idle
- [/api/dip-radar](https://orchard-data.letom1176.workers.dev/api/dip-radar) — $0.01 — Dip radar over the exact ~55-name universe a live trading system trades: RSI(2), 20d-high distance, dip flags under disclosed thresholds — 24/7
- [/api/track-record](https://orchard-data.letom1176.workers.dev/api/track-record) — $0.01 — Tamper-evident accuracy ledger: forecasts timestamped before outcomes, scored vs realized SPY daily
- [/api/expected-move](https://orchard-data.letom1176.workers.dev/api/expected-move) — $0.005 — Options-implied expected move (ATM straddle): ?symbol=SPY, NVDA, ...
- [/api/funding-rates](https://orchard-data.letom1176.workers.dev/api/funding-rates) — $0.003 — BTC/ETH/SOL perp funding: 8h + annualized, next funding time
- [/api/market-brief](https://orchard-data.letom1176.workers.dev/api/market-brief) — $0.005 — BTC/ETH/SOL + SPY/QQQ/IWM/VIX + crypto fear&greed, one call
- [/api/trending](https://orchard-data.letom1176.workers.dev/api/trending) — $0.005 — StockTwits trending + r/wallstreetbets mention counts
- [/api/movers](https://orchard-data.letom1176.workers.dev/api/movers) — $0.005 — Top trending US tickers with live quotes, sorted by move
- [/api/macro](https://orchard-data.letom1176.workers.dev/api/macro) — $0.003 — Treasury yields, dollar index, gold, oil, VIX
- [/api/ohlcv](https://orchard-data.letom1176.workers.dev/api/ohlcv) — $0.002 — Daily OHLCV candles: ?symbol=SPY&range=1mo
- [/api/fear-greed](https://orchard-data.letom1176.workers.dev/api/fear-greed) — $0.001 — Crypto fear & greed index, current + previous reading
- [/api/dip-check](https://orchard-data.letom1176.workers.dev/api/dip-check) — $0.003 — Is this symbol dipping? RSI(2), RSI(14), distance from the 20-day close-high, and 1d/5d/20d returns for any US symbol, with a deep_dip/dip/near_dip verdict under fully disclosed thresholds you can re-derive yourself. The single-symbol version of /api/dip-radar. Params: ?symbol=NVDA.
- [/api/quote](https://orchard-data.letom1176.workers.dev/api/quote) — $0.002 — Live quote for any US symbol: last, previous close, % change, day high/low, volume and the exchange timestamp. One symbol, one call. Params: ?symbol=NVDA.
- [/api/crypto-spot](https://orchard-data.letom1176.workers.dev/api/crypto-spot) — $0.003 — BTC, ETH and SOL spot prices with 24h change, from CoinGecko. No key, no account.
- [/api/etf-quotes](https://orchard-data.letom1176.workers.dev/api/etf-quotes) — $0.003 — Live quotes for the four US index ETFs an agent actually needs: SPY, QQQ, DIA, IWM. Last, change and day range for each.
- [/api/wsb-mentions](https://orchard-data.letom1176.workers.dev/api/wsb-mentions) — $0.003 — r/wallstreetbets ticker mention counts, ranked. What retail is actually talking about, as a number rather than a vibe.
- [/api/stocktwits-trending](https://orchard-data.letom1176.workers.dev/api/stocktwits-trending) — $0.003 — StockTwits trending symbols right now, with watchlist counts. The other half of retail attention, separate from Reddit.
- [/api/yields](https://orchard-data.letom1176.workers.dev/api/yields) — $0.002 — The US Treasury curve in one call: 13-week, 5-year, 10-year and 30-year yields with daily change.
- [/api/vix](https://orchard-data.letom1176.workers.dev/api/vix) — $0.001 — The VIX right now - last, previous close, % change, day range. The single number for how frightened the equity market is.
- [/api/commodities](https://orchard-data.letom1176.workers.dev/api/commodities) — $0.002 — Gold futures, WTI crude futures and the dollar index in one call - the three prices that move everything else.
- [/api/chat/completions](https://orchard-data.letom1176.workers.dev/api/chat/completions) — $0.001 — OpenAI-compatible chat completions, flat price per call: gpt-oss-120b (default), llama-3.3-70b, qwen3-30b or gemma-4-26b. Send the usual {model, messages, max_tokens (<=1024), temperature}; get a chat.completion back. No account, no API key. Failed calls are never charged.
- [/api/ask](https://orchard-data.letom1176.workers.dev/api/ask) — $0.001 — Ask an LLM one question over plain GET and get a concise answer: ?q=your question (&model=gpt-oss-120b|llama-3.3-70b|qwen3-30b|gemma-4-26b). The simplest paid AI call there is. Failed calls are never charged.
- [/api/web-read](https://orchard-data.letom1176.workers.dev/api/web-read) — $0.001 — Read any web page as clean markdown for an LLM: title, description, publish date, main text with links, word count. Static HTML (no JS rendering), up to ~60k chars. Failed fetches are never charged. Params: ?url=https://...
- [/api/email-verify](https://orchard-data.letom1176.workers.dev/api/email-verify) — $0.001 — Email verification before you send: syntax, domain exists, live MX lookup, null-MX, disposable/throwaway domain, role account, free provider, SPF and DMARC. Verdict + 0-100 score + reasons. Params: ?email=someone@example.com.
- [/api/token-check](https://orchard-data.letom1176.workers.dev/api/token-check) — $0.005 — EVM token safety check before you buy: honeypot, buy/sell tax, owner powers (mint, balance changes, hidden owner, pause, blacklist), source verified, holder concentration, plus live DEX liquidity, volume and pool age. Verdict + score + red flags. Params: ?address=0x...&chain=base (base, ethereum, bsc, arbitrum, polygon, optimism).
- [/api/sentiment-brief](https://orchard-data.letom1176.workers.dev/api/sentiment-brief) — $0.005 — Crowd mood in one call: crypto fear & greed, StockTwits trending, r/wallstreetbets mentions and CoinGecko's most-searched coins. Cheaper than the four slices bought separately.
- [/api/fear-greed-history](https://orchard-data.letom1176.workers.dev/api/fear-greed-history) — $0.002 — Crypto fear & greed, last 30 days: daily readings plus 7d/30d averages, 30d min/max, 7-day trend and count of extreme-fear/extreme-greed days.
- [/api/crypto-trending](https://orchard-data.letom1176.workers.dev/api/crypto-trending) — $0.002 — Most-searched coins on CoinGecko in the last 24h, ranked, with price, 24h change, market cap and volume, plus the trending sectors. Retail crypto attention.
- [/api/crypto-global](https://orchard-data.letom1176.workers.dev/api/crypto-global) — $0.001 — Whole crypto market in one call: total market cap, 24h volume, 24h market-cap change, BTC and ETH dominance.
- [/api/fx-rates](https://orchard-data.letom1176.workers.dev/api/fx-rates) — $0.001 — Currency exchange rates (ECB reference, ~30 currencies) with the majors pulled out. Params: ?base=USD (any 3-letter code).
- [/api/gas](https://orchard-data.letom1176.workers.dev/api/gas) — $0.001 — Gas right now on Base and Ethereum: next base fee, priority-fee percentiles, suggested max fee, and the USD cost of an ETH transfer, ERC-20 transfer and DEX swap.
- [/api/prediction-markets](https://orchard-data.letom1176.workers.dev/api/prediction-markets) — $0.003 — Live Polymarket odds: the most-traded open markets by 24h volume, each outcome's price as a probability, volume, liquidity, end date. Params: ?q=keyword to filter (e.g. ?q=fed).
- [/v1/chat/completions](https://orchard-data.letom1176.workers.dev/v1/chat/completions) — $0.001 — OpenAI-compatible chat completions, flat price per call: gpt-oss-120b (default), llama-3.3-70b, qwen3-30b or gemma-4-26b. Send the usual {model, messages, max_tokens (<=1024), temperature}; get a chat.completion back. No account, no API key. Failed calls are never charged.

## What is actually differentiated here
Most market data is a repackaged public feed and we do not pretend otherwise.
These four are not obtainable elsewhere, because they are the live outputs of a
real algorithmic trading system rather than a vendor passthrough:
- /api/backtest — computation over data, with honest validation: next-open fills
  (no look-ahead), slippage charged, train/test halves scored separately, buy&hold
  and SPY baselines always printed, disagreeing halves reported as noise.
- /api/regime-forecast — an ML volatility-regime model that actually trades.
- /api/track-record — that model's accuracy, scored server-side against realized
  SPY moves under a rule disclosed in the payload. Predictions are recorded before
  outcomes. Audit us before you spend anything.
- /api/dip-radar — the live dip scan over the exact universe the system trades.

## Honesty policy
Staleness is always reported, never hidden. A product whose upstream feed goes
stale is withdrawn from sale (HTTP 503) rather than sold at full price — see
/api/feed-status for what is currently degraded.

## OpenAI-compatible LLM endpoint
Base URL: https://orchard-data.letom1176.workers.dev/v1 (also https://orchard-data.letom1176.workers.dev/api). POST /chat/completions, $0.001 USDC per call,
models gpt-oss-120b (default), llama-3.3-70b, qwen3-30b, gemma-4-26b, max 1024 output tokens.
Free model list: GET https://orchard-data.letom1176.workers.dev/v1/models. Use any OpenAI SDK with an x402-paying fetch:
  new OpenAI({ baseURL: "https://orchard-data.letom1176.workers.dev/v1", apiKey: "x402", fetch: fetchPay })
Failed calls are never charged.

## MCP
npx orchard-data-mcp — same catalog as MCP tools; four tools are free and need no wallet.