# AgentFeed Live crypto market data, a liquidation tape, tokenized-equity peg data and Solana on-chain data, served to AI agents over HTTP. 59 paid routes and 4 free routes. Every route is a GET that returns JSON. ## How to pay There are no API keys and no accounts. Payment is per call, in USDC, over x402 v2 on every rail and x402 v1 on Base and Solana. 1. GET the route. Unpaid, it answers 402. The x402 v2 challenge is in the PAYMENT-REQUIRED response header, base64-encoded JSON, for every rail. The body is the x402 v1 challenge, {x402Version: 1, accepts}, for Base and Solana. 2. Pay and repeat the request with a PAYMENT-SIGNATURE header (x402 v2) or an X-PAYMENT header (x402 v1, Base or Solana). An X-PAYMENT carrying a v2 payload is read as PAYMENT-SIGNATURE. Copy payTo only from a fresh 402 response, never from transaction history: a lookalike of the treasury address has sent address-poisoning transfers to our buyers. 3. The response body is `{ "tool": "", "data": { ... }, "paid": true }`. 4 rails are accepted on every paid route: - Solana mainnet — USDC - Base (eip155:8453) — USDC - Polygon (eip155:137) — USDC - Arbitrum (eip155:42161) — USDC MPP (solana/charge) is also offered on the same 402, in WWW-Authenticate, for: GET /api/sol-price, GET /api/btc-price. Machine-readable: - https://x402.ochinimus.app/openapi.json — OpenAPI 3.1, every route with parameters, prices and a real response example - https://x402.ochinimus.app/.well-known/x402 — the resource list - https://x402.ochinimus.app/.well-known/x402.json — the full manifest with prices and accepted rails - https://x402.ochinimus.app/mcp — the same tools over MCP (POST, streamable HTTP) - https://x402.ochinimus.app/api/sample/ — a real captured response for any paid route, free - https://x402.ochinimus.app/api/forecast-record — the settled cascade-forecast track record, free - https://x402.ochinimus.app/SKILL.md — the agent skill: when to use each route, what it answers, what it costs ## Free routes - GET /api/fear-greed — free, not payment-gated - GET /api/last-liquidation — free, not payment-gated - GET /api/exit-method — free, not payment-gated - GET /api/forecast-record — free, not payment-gated ## Paid routes (59, $0.913 for one call of each) ### Our own collateral exit-liquidity tape - GET /api/exit-quote — $0.02 — params: symbol, size_usd EXIT LIQUIDITY on seized collateral: what a liquidator ACTUALLY realises selling a Kamino reserve into live routing, versus the oracle price the protocol marks it at. Returns max_exitable_usd (largest clip whose liquidator margin is still positive, found by bisection, with its resolution width), the exitable fraction, the conservative bound at the 2% penalty floor, and for the nearest clip actually probed: realised USD, haircut bps and liquidator margin bps. Distinguishes a router that REFUSES to quote a token (permissioning, not illiquidity) from a book with no route (a real liquidity finding) - they are different facts and were one status until this split. A terminal verdict requires six consecutive agreeing observations from the symbol's own tape, so a single bad quote cannot produce a finding; withheld verdicts fall back to the last corroborated measurement with its age rather than returning null. Zero bad debt today does not disprove any of this - it means nobody has been forced to test it at size. Method, corroboration rules and row counts are free via get_exit_method. ### Our own tokenized-equity peg tape - GET /api/peg-deviation — $0.02 — params: symbol, hours Tokenized stock peg deviation on Solana: the on-chain DEX price of a tokenized US equity versus the underlying's last real trade, in bps, with 24h stats split into market-open and off-hours. Sampled every 5 minutes by our own collector. - GET /api/peg-sessions — $0.03 — params: symbol, days Tokenized stock peg by trading session: deviation broken out across open, premarket, afterhours, overnight and weekend — mean, p95, max bps and median liquidity each, with the worst off-hours window flagged. Market-open acts as the control. - GET /api/peg-universe — $0.05 — params: days, min_liquidity_usd Tokenized stocks ranked by off-hours peg risk: every tokenized US equity we track, with p95 and max deviation bps, market-open deviation as the control, and median liquidity. Dead pools are excluded rather than reported as perfect pegs. ### Our own liquidation tape - GET /api/cascade-forecast — $0.02 — params: symbol, symbols Liquidation forecast, FORWARD-LOOKING and not a description of what already happened. Returns the probability that a symbol will liquidate more in the NEXT 15 minutes than its own 90th-percentile 15-minute window. Calibrated on a 28-day tape of 1.4M Bybit liquidations across 799 symbols, which cannot be reconstructed by anyone starting today because no exchange publishes liquidation history. Every answer carries the exact question, the threshold in USD, the window it read, the number of historical occurrences behind the number, and instructions for settling it yourself from the public feed. When a state has too little history the tool DECLINES rather than guessing, and says why. The settled record is free at /api/forecast-record. - GET /api/cascade-history — $0.03 — params: symbol, scope, hours, min_usd, gap_s Liquidation cascade history: past clustered same-side flush events reconstructed from our own tape, with start and end, prints, USD total and peak print, up to 72h back. /api/cascade tells you what is happening NOW; this tells you what already happened. - GET /api/liq-heatmap — $0.02 — params: symbol, hours, buckets Liquidation heatmap by PRICE LEVEL: where leverage actually got flushed in the last N hours — USD, prints and long/short split per price zone, with the hottest zone flagged. Built from real liquidation prints, not entry-price estimates. BTC, ETH, SOL, HYPE or any other USDT perp on our Bybit, OKX and Binance tape. - GET /api/liq-history — $0.05 — params: symbol, scope, hours, bucket_min Liquidation history, time-bucketed: total, long and short USD, prints and biggest print per bucket, for any USDT perp or the whole recorded universe, up to 7 days back. Bybit is the only complete liq tape in crypto and no exchange publishes history of it. - GET /api/liq-pulse — $0.005 Use when an agent needs to know what is being liquidated right now. Returns the last 60 minutes across every USDT perp we record: total USD, long/short split, prints and the top 5 symbols. Declines with the tape age if our recording is stale. - GET /api/squeeze-score — $0.1 — params: symbol Short squeeze score and long flush score, 0-100, for any USDT perp. Composite of the funding rate, long/short crowding, 24h open-interest build, and liquidation skew from our own tape. One number for whether a trade is crowded and about to hurt someone. ### Market and positioning - GET /api/btc-price — $0.005 BTC price / Bitcoin spot price in USD, live. Multi-source with a fixed fallback order — Coinbase, then Kraken, then Pyth Hermes — first finite quote wins. Returns the price, the venue that served it, and a Pyth confidence interval when Pyth did. - GET /api/eth-price — $0.005 ETH spot price in USD, aggregated across seven independent venues (CoinGecko, Coinbase, Kraken, Binance, OKX, Gemini, DefiLlama). Returns the lead figure plus every venue quote that answered, so a caller can see the spread rather than trust one exchange. Venues are ranked in a fixed declared order, not completion order, so identical market state always returns the same lead price. - GET /api/long-short — $0.01 — params: symbol Long/short ratio for ANY USDT perp: the retail long and short account percentages from Bybit with 1h and 24h trend. The crowding gauge. - GET /api/market-snapshot — $0.005 Crypto market snapshot in one call: SOL and BTC spot prices, both perp funding rates with mark price and open interest, and the Fear & Greed index with its classification. Five reads, one payment. - GET /api/market-state — $0.02 — params: symbol Market state for BTC, ETH, SOL or HYPE in one call: spot and perp basis, realized vol 7d and 30d, implied vol (DVOL or 30-day ATM) and the IV minus RV spread, funding per venue with 30-day z-scores, open interest and its 24h change, long/short, liquidations 1h and 24h by side, Fear and Greed, the next FOMC or CPI release, and flags with stated thresholds. Every part carries its source and as-of time; a part we do not hold is null with a reason. - GET /api/positioning — $0.005 Open interest and long/short ratio for SOL and BTC perps: the retail long/short account ratio plus Bybit open interest with 1h and 24h change. For any other USDT perp use /api/open-interest and /api/long-short. - GET /api/price — $0.005 — params: symbol Use when an agent needs a spot price without choosing a venue. Returns the price, the venue that actually served it, and a Pyth confidence when Pyth served. Coinbase, then Kraken, then Pyth Hermes. Serves SOL, BTC and ETH; anything else is declined. - GET /api/sol-price — $0.005 SOL price / Solana spot price in USD, live. Multi-source with a fixed fallback order — Coinbase, then Kraken, then Pyth Hermes — first finite quote wins. Returns the price, the venue that served it, and a Pyth confidence interval when Pyth did. - GET /api/trade-context — $0.01 Crypto trading context in one call: SOL and BTC prices, perp funding rates, Fear & Greed, long/short positioning, open interest and 1h/24h liquidation stats. The whole pre-trade picture, one payment. ### Live liquidations and cascades - GET /api/cascade — $0.01 — params: window, min_events, min_usd Liquidation cascade detector, live: clustered same-side liquidations happening NOW on SOL, BTC, ETH, XRP and DOGE across Bybit, OKX and Binance, with side, USD total, prints, duration and severity. For every perp we record use /api/cascade-scan. - GET /api/cascade-scan — $0.05 — params: window, min_events, min_usd Liquidation cascade scan across EVERY USDT perp we record on Bybit, OKX and Binance at once, not just the majors: symbol, side liquidated, USD total, prints, duration, severity. Bybit is the only complete unthrottled liquidation tape in crypto. - GET /api/liquidation-leaders — $0.02 — params: window_min, limit Liquidation leaderboard: top symbols by liquidation USD right now across every USDT perp we record on Bybit, OKX and Binance, with long/short split, biggest single print and venue count. What is blowing up, ranked. - GET /api/liquidation-stats — $0.01 Liquidation stats, 1h and 24h totals for SOL, BTC, ETH, XRP and DOGE: long vs short USD split, biggest single print, and a per-exchange breakdown across Bybit, OKX and Binance. - GET /api/liquidations — $0.005 — params: symbol, scope, limit, min_usd Crypto liquidations, live tape: recent perp liquidation prints across Bybit, OKX and Binance with timestamp, side liquidated, size, price and USD value. Any USDT perp we record, not just majors. The Bybit tape is complete and unthrottled. - GET /api/perp — $0.005 — params: symbol Use when an agent needs one perp market in a single call. Returns cross-venue funding (Bybit, OKX, Hyperliquid), open interest with 1h/24h change, long/short ratio, and 24h liquidations with long/short split and biggest print from our own tape. - GET /api/venue-liq-share — $0.02 — params: symbol, hours Liquidations by exchange: per-venue liquidation share across Bybit, OKX and Binance with long/short split and biggest print, for any symbol or the whole recorded universe. Which venue is flushing whom. ### Tokenized stocks and peg - GET /api/equity-24h — $0.01 — params: symbol Weekend price for US stocks: an indicative 24/7 price for a stock or index (TSLA, NVDA, S&P 500, Nasdaq) from stock perps on Hyperliquid, Bybit, Binance and OKX and our tokenized stocks DEX price, with the last regular-session price, its time and source, the implied gap in %, each source's liquidity and the session (open, pre, after, overnight, weekend). Indicative, never an exchange quote; 503 when no source has liquidity. ### Derivatives - GET /api/basis — $0.01 — params: symbol Perp-vs-spot basis for any USDT pair: the premium or discount in %, a contango or backwardation read, and the funding context that goes with it. - GET /api/funding-cross — $0.01 — params: symbol Funding rate for ANY USDT perp across Bybit, OKX and Hyperliquid in one call, with the cross-venue spread and a crowding read. - GET /api/funding-extremes — $0.02 — params: limit, min_turnover_usd Funding rate extremes across every Bybit USDT perp: the most positive and most negative funding with annualized %, 24h price move and open interest. The most crowded trades in the market — crowded shorts are squeeze candidates. - GET /api/funding-history — $0.005 — params: symbol, limit Funding rate history for any USDT perp, up to 200 intervals: the average rate, its annualized %, the share of intervals that were positive, and the raw series. What the carry has actually been. - GET /api/funding-pulse — $0.005 Use when an agent needs the most extreme funding rates right now. Returns the 5 largest absolute annualised rates across the whole Bybit USDT perp universe, each with venue, 8h rate, open interest and 24h price move. One call, not a full screen. - GET /api/funding-radar — $0.02 — params: top, min_oi_usd Funding rates radar across Bybit, OKX and Hyperliquid. It tracks every USDT perp listed on at least two of them from $5M combined open interest and, by default, shows the ones with $10M and up; min_oi_usd changes that. Per symbol: the current funding per venue at its 8h equivalent, each venue's 30-day z-score against its own settled history, the cross-venue spread, and a flag on any |z| of 2 or more, most extreme first. Precomputed every 5 minutes, with as_of and stale. - GET /api/funding-rate — $0.005 — params: symbol Funding rate for any USDT perp on Bybit, OKX and Hyperliquid: per venue the raw rate, its interval in hours, the 8h equivalent, the annualised rate, next funding time and mark price. Without a symbol: funding rates for the SOL and BTC perps on Hyperliquid, with open interest. Cross-venue spread and crowding: /api/funding-cross. - GET /api/oi-spike-scan — $0.02 — params: limit Open interest spikes across every Bybit USDT perp: abnormal OI jumps against an earlier snapshot of the same universe, at least 30 minutes old and with its exact age returned as baseline_min_ago, plus funding and 24h price context. - GET /api/open-interest — $0.01 — params: symbol Open interest for ANY USDT perp: Bybit OI in base units and in USD with 1h and 24h change, plus OKX open interest and the mark price. /api/positioning covers SOL and BTC only. - GET /api/tradfi-radar — $0.02 — params: class, venue, top, min_oi_usd Stock perps, S&P 500, Nasdaq, gold and oil perps ranked by funding rate: every stock, index, commodity and FX perp on Hyperliquid HIP-3 dexes (trade[XYZ], Paragon, Markets by Kinetiq, Entropy), Bybit, Binance and OKX, with funding at its 8h equivalent, a 30-day funding z-score on HIP-3, open interest and its 24h change, mark minus oracle basis and 24h volume. Filter by asset class or venue. Precomputed every 5 minutes; stale data answers 503. ### Microstructure and screeners - GET /api/orderbook-imbalance — $0.01 — params: symbol, bps Orderbook imbalance for any USDT perp: resting bid and ask liquidity in USD within ±N bps of mid, the ratio between the two sides, and a skew read. - GET /api/orderbook-walls — $0.01 — params: symbol, top Orderbook walls for any USDT perp: the largest resting orders on each side of the book, with USD size and distance from mid. - GET /api/spread-arb — $0.02 — params: symbol Cross-exchange spread and arbitrage edge for any USDT perp: the best bid and ask on Bybit, OKX and Hyperliquid, with the best cross-venue edge in bps, pre-fee. - GET /api/top-movers — $0.01 — params: limit, min_turnover_usd Top gainers and losers over 24h across every Bybit USDT perp above a liquidity floor, each with its funding rate attached. The "what moved" screener. - GET /api/volatility — $0.01 — params: symbol Realized volatility for any USDT perp: 7-day and 30-day annualized from daily closes, plus today's range in %. A position-sizing input. - GET /api/whale-trades — $0.02 — params: symbol, min_usd, limit Whale trades for any USDT perp: prints from the live trade tape above a USD threshold, with buy and sell totals, net flow and the dominant side. ### Solana on-chain - GET /api/dex-quote — $0.005 — params: input_mint, output_mint, amount Solana DEX quote from Jupiter for any SPL pair: output amount, price impact %, the route taken and the slippage assumed. The real executable price on Solana, not an index price. - GET /api/jito-tips — $0.005 Jito tips: bundle tip floor percentiles from p25 to p99 in SOL — what landed bundles are actually paying — with an EMA p50 and a landing recommendation. - GET /api/priority-fees — $0.005 Solana priority fees right now: the fee estimate at every level from min to unsafeMax in micro-lamports per compute unit, with a recommended tip. For bots that need their transactions to land. - GET /api/sol-network — $0.005 Solana network health: recent average TPS, the current slot, the current epoch and epoch progress in %. - GET /api/token-holders/:mint — $0.02 — params: :mint Top holders of any SPL token: per-account share with top-1, top-5 and top-10 concentration for a Solana mint. A deeper cut than the summary in /api/token-risk. - GET /api/token-metadata/:mint — $0.005 — params: :mint SPL token metadata for any Solana mint: name, symbol, decimals, total supply, current USD price, interface type, and whether the metadata is still mutable. Helius DAS. - GET /api/token-risk/:mint — $0.01 — params: :mint Solana token rug check / risk signals for any SPL mint: mint and freeze authority status (revoked is safer), top-1 and top-10 holder concentration, supply, price, and a list of risk flags. Not a honeypot or LP-lock checker. - GET /api/wallet-activity/:wallet — $0.02 — params: :wallet, limit Solana wallet activity: recent transactions for any address, parsed human-readable — type, protocol, description, fee and failures. Helius enhanced transactions. - GET /api/wallet-holdings/:wallet — $0.008 — params: :wallet Solana wallet holdings / portfolio for any address: native SOL with its USD value, every SPL token with amount, unit price and USD value, and an NFT count. Helius DAS getAssetsByOwner, up to 100 assets. ### Base and EVM - GET /api/base-balance — $0.005 — params: address, token, chain ERC20 and native ETH wallet balance on Base or Ethereum mainnet, for a 0x address or an ENS name. decimals() and symbol() are read from the contract at request time rather than assumed, because assuming 18 reports a USDC balance a trillion times too large. ENS is resolved through two independent resolvers and the answer is used only when they agree, so a wrong address can never produce a confident balance for the wrong wallet. An unsupported chain is refused rather than silently answered from the wrong one. - GET /api/base-gas — $0.005 Base gas price (chain 8453) in BOTH gwei and wei, with base fee, priority fee and block number when the node supplies them. Both units are returned because a caller asking in wei and a caller asking in gwei are asking the same question. Served from keyless public RPC with three-node fallback, so there is no API key to rotate or expire. ### DeFi and macro - GET /api/macro-calendar — $0.005 — params: type, days FOMC, CPI, NFP and PCE calendar for traders: the next Fed rate decisions and the CPI, nonfarm payrolls and PCE release dates with UTC times converted from New York time (DST-aware), each with its official Fed, BLS or BEA source URL and the time we verified it. Read daily from the agencies' own pages and never entered by hand; data verified more than 35 days ago answers 503 and is never charged. - GET /api/stablecoin-flows — $0.01 Stablecoin supply and flows: total stablecoin market cap with 7d and 30d deltas and the top stables by size — the macro risk-on / risk-off dial for crypto. - GET /api/tvl — $0.005 — params: target TVL for any DeFi protocol with 1d and 7d change, or a top-15 chains ranking. DefiLlama-backed; a protocol family is aggregated across its deployments and the change is TVL-weighted. ### Other - GET /api/options-gex — $0.03 — params: currency Gamma exposure (GEX) for BTC, ETH, SOL, XRP and HYPE options on Deribit: gamma by strike in USD per 1% move, net GEX under a dealer-sign convention stated in every response, the gamma flip level and the call and put walls. Black-Scholes gamma on Deribit mark implied volatility across every live expiry. Precomputed every 5 minutes; a snapshot older than 15 minutes answers 503 and is never charged. - GET /api/options-summary — $0.02 — params: currency Implied volatility and options skew for BTC, ETH, SOL, XRP and HYPE from Deribit: DVOL (or our 30-day ATM implied vol where Deribit publishes none) with its 24h change, the ATM IV term structure, 25-delta risk reversal and butterfly per expiry, put/call ratio by open interest and 24h volume, options open interest in USD, max pain for the next three expiries and the top strikes. Precomputed every 5 minutes; a snapshot older than 15 minutes answers 503 and is never charged. ## Notes - Path-parameter routes also accept the parameter as a query string: /api/token-risk?mint= is rewritten to the canonical path form before the paywall. - HEAD on a paid route answers the 402 challenge headers with no body; it never pays and never reaches a handler. HEAD on a free route answers 405. The paid surface is GET-only. - Rate limit, per caller per minute: 240 for GET and POST /mcp, 2400 for every other method. A 429 carries Retry-After. - A route that cannot reach its upstream returns an error rather than a stale or invented value.