The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the AgentFeed listing page.
Crypto liquidations, cascade detection, positioning and market data for AI agents. Pay per call in USDC. No API keys, no accounts, no subscriptions.
AgentFeed sells live trading data through the x402 payment protocol on Solana and Base. An agent hits an endpoint, gets a 402 Payment Required with the price, pays a fraction of a cent in USDC from its own wallet, and receives the data — in about two seconds, gas sponsored by the facilitator.
Two rails, same data:
| Rail | Endpoint | For |
|---|---|---|
| MCP (Streamable HTTP) | https://x402.ochinimus.app/mcp | Claude, Cursor, MCP-native frameworks |
| HTTP (x402) | https://x402.ochinimus.app/api/* | Anything that speaks HTTP |
We run our own liquidation collector across Bybit, OKX and Binance — every USDT-margined perpetual on all three, roughly 780 symbols, recorded continuously since 2026-07-08.
This data cannot be bought. Not from us, not from anyone:
liquidationSnapshot no longer exists on
data.binance.vision — the directory is an empty shell. Verified 2026-07-12.There is no public historical liquidation dataset for any major venue, at any price. The only way to hold this data is to have been recording it.
Being straight about this matters more than the marketing:
| Venue | Feed | Complete? |
|---|---|---|
| Bybit | allLiquidation | ✅ Yes. Every liquidation, 500ms cadence. The only complete, unthrottled public liquidation stream among the major perp venues. |
| Binance | !forceOrder@arr | ❌ No. Snapshot only — max one order per symbol per 1000ms, per Binance's own docs. allForceOrders REST is unmaintained. |
| OKX | liquidation-orders | ❌ No. Max one update per second per contract. |
| Hyperliquid | — | ⛔ Not included. Hyperliquid exposes no public liquidation stream. WsTrade carries no liquidation marker; the data lives only in user-scoped streams. Capturing it requires running a node. |
Binance and OKX rows are a structural undercount, and the undercount is worst during cascades — exactly when the data matters most. This is true of every liquidation dataset on the market, including the well-known ones. Most don't say so.
Bybit rows are the highest-integrity part of the dataset. Weight accordingly.
side field, which most datasets get wrongThree exchanges, three conventions. We normalize all of them:
S is already the position side (Buy = a long was liquidated). Passed through.S is the order side — a SELL order is what closes a long. Flipped.posSide explicitly. Mapped.In our output: Buy = a LONG was liquidated. Sell = a SHORT was liquidated. Invert this
and every long/short ratio you compute is backwards for some venues.
Notional uses filled_qty × avg_fill_price — what actually executed — not limit_price × requested_size.
| Tool | Price | Description |
|---|---|---|
| get_sol_price | $0.001 | SOL spot price |
| get_btc_price | $0.001 | BTC spot price |
| get_funding_rate | $0.002 | SOL+BTC perp funding rates |
| get_market_snapshot | $0.003 | Full market snapshot in one call |
| get_wallet_holdings | $0.008 | Solana wallet holdings via Helius DAS |
| get_token_metadata | $0.005 | SPL token metadata via Helius DAS |
| get_recent_liquidations | $0.003 | Recent liquidations across 780+ USDT perps |
| get_cascade_alert | $0.01 | Live liquidation cascade detector for the 5 majors |
| get_cascade_scan | $0.05 | Full-universe cascade scan across 780+ USDT perps |
| get_liquidation_leaders | $0.02 | Top symbols by liquidation USD right now |
| get_liquidation_stats | $0.004 | 1h/24h liquidation totals, long/short split |
| get_positioning | $0.004 | SOL+BTC long/short ratio + open interest |
| get_trade_context | $0.01 | Full market state in one call |
| get_token_risk | $0.01 | SPL token rug-risk signals |
| get_liq_history | $0.05 | Historical liquidation tape, time-bucketed |
| get_liq_heatmap | $0.05 | Liquidation heatmap by price level from our tape |
| get_cascade_history | $0.03 | Past liquidation cascades from our tape |
| get_squeeze_score | $0.10 | FLAGSHIP: 0-100 short-squeeze / long-flush signal |
| get_venue_liq_share | $0.02 | Which venue is flushing whom |
| get_funding_cross | $0.01 | Funding for any USDT perp across Bybit + OKX + Hyperliquid |
| get_funding_extremes | $0.02 | Most crowded funding trades across 780+ perps |
| get_open_interest | $0.01 | Open interest for any USDT perp with 1h/24h change |
| get_oi_spike_scan | $0.02 | Abnormal open-interest jumps across 780+ perps |
| get_long_short | $0.01 | Long/short account ratio for any USDT perp |
| get_basis | $0.01 | Perp-vs-spot basis for any USDT pair |
| get_volatility | $0.01 | Realized volatility for any USDT perp |
| get_funding_history | $0.005 | Funding-rate history for any USDT perp |
| get_top_movers | $0.01 | 24h top gainers and losers across 780+ perps |
| get_orderbook_imbalance | $0.01 | Bid/ask resting-liquidity imbalance |
| get_orderbook_walls | $0.01 | Largest resting orders each side of the book |
| get_whale_trades | $0.02 | Large prints from the live trade tape |
| get_spread_arb | $0.02 | Best bid/ask across Bybit, OKX and Hyperliquid |
| get_token_holders | $0.02 | Top holders of any SPL token with concentration |
| get_wallet_activity | $0.02 | Recent transactions of any Solana wallet, parsed |
| get_priority_fees | $0.005 | Solana priority-fee estimate, all levels |
| get_jito_tips | $0.005 | Jito bundle tip floor percentiles |
| get_sol_network | $0.005 | Solana network health: TPS, slot, epoch |
| get_tvl | $0.005 | TVL for any DeFi protocol or top-15 chains |
| get_stablecoin_flows | $0.01 | Total stablecoin supply with 7d/30d deltas |
| get_dex_quote | $0.005 | Live Jupiter swap quote for any SPL pair |
| get_peg_deviation | $0.02 | Tokenized-equity peg deviation vs the underlying last trade |
| get_peg_sessions | $0.03 | Peg deviation by session: open, premarket, afterhours, overnight, weekend |
| get_peg_universe | $0.05 | Tracked tokenized equities ranked by off-hours peg risk |
| get_exit_quote | $0.02 | Exit liquidity on seized Kamino collateral: what a liquidator actually realises vs the oracle mark |
45 paid tools + 7 free tools. Every call is metered individually in USDC over x402 — no bundles, no minimums. Calling all 45 paid tools once costs $0.76 — the entire market read for 76 cents.
The flagship is get_squeeze_score — a 0-100 short-squeeze / long-flush composite built from funding, crowding, OI build and the liq-skew of our exclusive tape. One number, one dime, answers "is this trade crowded and about to hurt someone."
| Tool | Price | Route | What you get |
|---|---|---|---|
get_squeeze_score | $0.1 | /api/squeeze-score | FLAGSHIP: short-squeeze / long-flush score 0-100 for any USDT perp |
get_liq_history | $0.05 | /api/liq-history | HISTORICAL liquidation tape, time-bucketed: total/long/short USD, prints, biggest print per bucket |
get_liq_heatmap | $0.05 | /api/liq-heatmap | Liquidation heatmap by PRICE LEVEL from our own tape: where leverage actually got flushed in the last N hours — USD, prints, long/short s… |
get_cascade_history | $0.03 | /api/cascade-history | PAST liquidation cascades reconstructed from our tape: clustered same-side flush events with start/end, prints, USD total, peak print |
get_venue_liq_share | $0.02 | /api/venue-liq-share | Which venue is flushing whom: per-exchange liquidation share (Bybit/OKX/Binance) with long/short split and biggest print, any symbol or w… |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_peg_universe | $0.05 | /api/peg-universe | Every tokenized US equity we track, ranked by off-hours peg risk: p95 and max deviation bps, market-open as control, median liquidity |
get_peg_sessions | $0.03 | /api/peg-sessions | Peg deviation by trading session — open, premarket, afterhours, overnight, weekend — worst off-hours window flagged |
get_peg_deviation | $0.02 | /api/peg-deviation | Peg deviation for one tokenized equity: on-chain DEX price vs the underlying last real trade, in bps |
Sampled every 5 minutes since 19 July 2026. Deviation is measured against the underlying's last real trade — outside US market hours that is the last print before the close, not a live quote. Dead pools are excluded rather than reported as perfect pegs.
| Tool | Price | Route | What you get |
|---|---|---|---|
get_exit_quote | $0.02 | /api/exit-quote | Exit liquidity on seized collateral: what a liquidator actually realises selling a Kamino reserve into live routing versus the oracle mark — max exitable USD, exitable fraction, haircut and liquidator margin in bps |
get_exit_method | free | /api/exit-method | How the measurement works and the row counts behind every paid answer, computed from the tape at request time |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_recent_liquidations | $0.003 | /api/liquidations | Recent liquidations across 780+ USDT perps (Bybit complete tape + OKX + Binance) |
get_cascade_alert | $0.01 | /api/cascade | Liquidation cascade detector for the 5 majors (SOL/BTC/ETH/XRP/DOGE) across Bybit+OKX+Binance |
get_cascade_scan | $0.05 | /api/cascade-scan | FULL-UNIVERSE cascade scan: 780+ USDT perps across Bybit+OKX+Binance |
get_liquidation_leaders | $0.02 | /api/liquidation-leaders | What is blowing up right now: top symbols by liquidation USD across 780+ USDT perps, with long/short split, biggest print and venue count |
get_liquidation_stats | $0.004 | /api/liquidation-stats | 1h/24h liquidation totals for the 5 majors (SOL/BTC/ETH/XRP/DOGE), long/short split, biggest print, per-exchange breakdown |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_funding_cross | $0.01 | /api/funding-cross | Funding for ANY USDT perp across Bybit + OKX + Hyperliquid in one call, with cross-venue spread and crowding read |
get_funding_extremes | $0.02 | /api/funding-extremes | Most crowded trades across 780+ USDT perps: top most-positive and most-negative funding with annualized %, 24h price move and OI |
get_open_interest | $0.01 | /api/open-interest | Open interest for ANY USDT perp: Bybit OI in base + USD with 1h/24h change, plus OKX OI |
get_oi_spike_scan | $0.02 | /api/oi-spike-scan | Abnormal open-interest jumps across 780+ USDT perps vs a 30min+ baseline — where new leverage is piling in, with funding and price context |
get_long_short | $0.01 | /api/long-short | Long/short account ratio for ANY USDT perp with 1h and 24h trend (retail crowding gauge) |
get_basis | $0.01 | /api/basis | Perp-vs-spot basis for any USDT pair: premium/discount %, contango/backwardation read, funding context |
get_volatility | $0.01 | /api/volatility | Realized volatility for any USDT perp: 7d and 30d annualized from daily closes, plus today's range |
get_funding_history | $0.005 | /api/funding-history | Funding-rate history for any USDT perp (up to 200 intervals): average, annualized, share of positive intervals — what the carry has actua… |
get_top_movers | $0.01 | /api/top-movers | 24h top gainers and losers across 780+ USDT perps with a liquidity floor, funding attached |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_orderbook_imbalance | $0.01 | /api/orderbook-imbalance | Bid/ask resting-liquidity imbalance within ±N bps of mid for any USDT perp: USD each side, ratio, skew read |
get_orderbook_walls | $0.01 | /api/orderbook-walls | Largest resting orders each side of the book for any USDT perp, with USD size and distance from mid |
get_whale_trades | $0.02 | /api/whale-trades | Large prints from the live trade tape for any USDT perp: trades over a USD threshold, buy/sell totals, net flow, dominant side |
get_spread_arb | $0.02 | /api/spread-arb | Best bid/ask for a USDT perp across Bybit, OKX and Hyperliquid, with the best cross-venue edge in bps (pre-fee) |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_sol_price | $0.001 | /api/sol-price | SOL spot price |
get_btc_price | $0.001 | /api/btc-price | BTC spot price |
get_funding_rate | $0.002 | /api/funding-rate | SOL+BTC perp funding rates |
get_market_snapshot | $0.003 | /api/market-snapshot | Full market snapshot in one call |
get_positioning | $0.004 | /api/positioning | SOL+BTC long/short account ratio + open interest with 1h/24h OI change |
get_trade_context | $0.01 | /api/trade-context | Full market state in one call: prices, funding, fear/greed, positioning, liquidations |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_wallet_holdings | $0.008 | /api/wallet-holdings/:wallet | Solana wallet holdings via Helius DAS |
get_token_metadata | $0.005 | /api/token-metadata/:mint | SPL token metadata via Helius DAS |
get_token_risk | $0.01 | /api/token-risk/:mint | Token rug-risk signals: mint/freeze authority status, top-holder concentration, risk flags |
get_token_holders | $0.02 | /api/token-holders/:mint | Top holders of any SPL token with per-account share and top1/top5/top10 concentration |
get_wallet_activity | $0.02 | /api/wallet-activity/:wallet | Recent transactions of any Solana wallet, parsed human-readable: type, protocol, description, fee, failures (Helius enhanced) |
get_priority_fees | $0.005 | /api/priority-fees | Solana priority-fee estimate right now, all levels (min to unsafeMax) in micro-lamports/CU, with a recommended tip |
get_jito_tips | $0.005 | /api/jito-tips | Jito bundle tip floor percentiles (p25-p99, SOL) — what landed bundles are actually paying, with a landing recommendation |
get_sol_network | $0.005 | /api/sol-network | Solana network health: recent average TPS, current slot, epoch and epoch progress |
| Tool | Price | Route | What you get |
|---|---|---|---|
get_tvl | $0.005 | /api/tvl | TVL for any DeFi protocol (with 1d/7d change) or top-15 chains ranking |
get_stablecoin_flows | $0.01 | /api/stablecoin-flows | Total stablecoin supply with 7d/30d deltas and top stables — the macro risk-on/risk-off dial for crypto |
get_dex_quote | $0.005 | /api/dex-quote | Live Jupiter swap quote for any SPL pair: output amount, price impact, route |
| Tool | Route |
|---|---|
get_fear_greed | /api/fear-greed |
get_last_liquidation | /api/last-liquidation (15-min delayed) |
get_cascade_forecast_free | MCP tool — full-quality SOL liquidation forecast, nothing withheld |
get_forecast_question | MCP tool — what the forecast answers and how to settle it yourself |
get_forecast_record | MCP tool — live settled track record with the raw rows |
get_exit_method | /api/exit-method |
pricing | MCP tool — lists everything with live prices |
Set AGENTFEED_PRIVATE_KEY to a funded Solana wallet and the agent pays per call automatically. Default spend cap $0.50/call (AGENTFEED_MAX_SPEND_PER_CALL to change).
x402 clients pay and retry automatically.
Point any MCP client at https://x402.ochinimus.app/mcp (Streamable HTTP, POST). Paid tools
return payment terms; an x402-capable client settles and retries.
Also available as an elizaOS plugin.
A multi-venue liquidation dataset — normalized, growing daily, free — ships with a full quality statement covering coverage dates, known gaps, exchange throttles, and field definitions: ochinimuse.gumroad.com/l/liqdata
Read DATASET_QUALITY.md before you use it. It tells you exactly where the data is wrong.