{"service":"agentfeed","description":"Live crypto market data for AI agents - liquidations, positioning, funding, prices, token risk. Paid per-call in USDC via x402 on Solana or Base; /api/sol-price and /api/btc-price also carry an MPP solana/charge challenge on the same 402. No API keys.","x402":{"active":true,"network":"mainnet","chains":["solana:mainnet","eip155:8453"]},"mpp":{"active":true,"intent":"solana/charge","routes":["GET /api/sol-price","GET /api/btc-price"]},"free_tools":["get_fear_greed","get_last_liquidation","get_exit_method","get_forecast_record"],"coverage":{"perp_markets_7d":860,"venues":[{"exchange":"binance","symbols":736},{"exchange":"bybit","symbols":683},{"exchange":"okx","symbols":427}],"window_days":7,"measured_at":"2026-10-07T02:01:02.457Z"},"discovery":{"openapi":"https://x402.ochinimus.app/openapi.json","well_known":"https://x402.ochinimus.app/.well-known/x402","manifest":"https://x402.ochinimus.app/.well-known/x402.json","llms_txt":"https://x402.ochinimus.app/llms.txt","skill_md":"https://x402.ochinimus.app/SKILL.md","icon":"https://x402.ochinimus.app/icon.png","samples":"https://x402.ochinimus.app/api/sample","forecast_record":"https://x402.ochinimus.app/api/forecast-record"},"links":{"github":"https://github.com/seekdaseek/agentfeed","elizaos_plugin":"https://www.npmjs.com/package/@seekdaseek/plugin-agentfeed","smithery":"https://smithery.ai/servers/ochinimus/agentfeed","dataset":"https://ochinimuse.gumroad.com/l/liqdata","studio":"https://ochinimus.app"},"tools":[{"name":"get_sol_price","route":"GET /api/sol-price","price_usdc":0.001,"description":"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."},{"name":"get_btc_price","route":"GET /api/btc-price","price_usdc":0.001,"description":"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."},{"name":"get_funding_rate","route":"GET /api/funding-rate","price_usdc":0.002,"description":"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."},{"name":"get_market_snapshot","route":"GET /api/market-snapshot","price_usdc":0.003,"description":"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."},{"name":"get_wallet_holdings","route":"GET /api/wallet-holdings/:wallet","price_usdc":0.008,"description":"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."},{"name":"get_token_metadata","route":"GET /api/token-metadata/:mint","price_usdc":0.005,"description":"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."},{"name":"get_recent_liquidations","route":"GET /api/liquidations","price_usdc":0.003,"description":"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."},{"name":"get_cascade_alert","route":"GET /api/cascade","price_usdc":0.01,"description":"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."},{"name":"get_cascade_scan","route":"GET /api/cascade-scan","price_usdc":0.05,"description":"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."},{"name":"get_liquidation_leaders","route":"GET /api/liquidation-leaders","price_usdc":0.02,"description":"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."},{"name":"get_liquidation_stats","route":"GET /api/liquidation-stats","price_usdc":0.004,"description":"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."},{"name":"get_positioning","route":"GET /api/positioning","price_usdc":0.004,"description":"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."},{"name":"get_trade_context","route":"GET /api/trade-context","price_usdc":0.01,"description":"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."},{"name":"get_token_risk","route":"GET /api/token-risk/:mint","price_usdc":0.01,"description":"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."},{"name":"get_cascade_forecast","route":"GET /api/cascade-forecast","price_usdc":0.02,"description":"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."},{"name":"get_liq_history","route":"GET /api/liq-history","price_usdc":0.05,"description":"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."},{"name":"get_liq_heatmap","route":"GET /api/liq-heatmap","price_usdc":0.05,"description":"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."},{"name":"get_cascade_history","route":"GET /api/cascade-history","price_usdc":0.03,"description":"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."},{"name":"get_squeeze_score","route":"GET /api/squeeze-score","price_usdc":0.1,"description":"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."},{"name":"get_venue_liq_share","route":"GET /api/venue-liq-share","price_usdc":0.02,"description":"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."},{"name":"get_funding_cross","route":"GET /api/funding-cross","price_usdc":0.01,"description":"Funding rate for ANY USDT perp across Bybit, OKX and Hyperliquid in one call, with the cross-venue spread and a crowding read."},{"name":"get_funding_extremes","route":"GET /api/funding-extremes","price_usdc":0.02,"description":"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."},{"name":"get_open_interest","route":"GET /api/open-interest","price_usdc":0.01,"description":"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."},{"name":"get_oi_spike_scan","route":"GET /api/oi-spike-scan","price_usdc":0.02,"description":"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."},{"name":"get_long_short","route":"GET /api/long-short","price_usdc":0.01,"description":"Long/short ratio for ANY USDT perp: the retail long and short account percentages from Bybit with 1h and 24h trend. The crowding gauge."},{"name":"get_basis","route":"GET /api/basis","price_usdc":0.01,"description":"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."},{"name":"get_volatility","route":"GET /api/volatility","price_usdc":0.01,"description":"Realized volatility for any USDT perp: 7-day and 30-day annualized from daily closes, plus today's range in %. A position-sizing input."},{"name":"get_funding_history","route":"GET /api/funding-history","price_usdc":0.005,"description":"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."},{"name":"get_top_movers","route":"GET /api/top-movers","price_usdc":0.01,"description":"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."},{"name":"get_orderbook_imbalance","route":"GET /api/orderbook-imbalance","price_usdc":0.01,"description":"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."},{"name":"get_orderbook_walls","route":"GET /api/orderbook-walls","price_usdc":0.01,"description":"Orderbook walls for any USDT perp: the largest resting orders on each side of the book, with USD size and distance from mid."},{"name":"get_whale_trades","route":"GET /api/whale-trades","price_usdc":0.02,"description":"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."},{"name":"get_spread_arb","route":"GET /api/spread-arb","price_usdc":0.02,"description":"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."},{"name":"get_token_holders","route":"GET /api/token-holders/:mint","price_usdc":0.02,"description":"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."},{"name":"get_wallet_activity","route":"GET /api/wallet-activity/:wallet","price_usdc":0.02,"description":"Solana wallet activity: recent transactions for any address, parsed human-readable — type, protocol, description, fee and failures. Helius enhanced transactions."},{"name":"get_priority_fees","route":"GET /api/priority-fees","price_usdc":0.005,"description":"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."},{"name":"get_jito_tips","route":"GET /api/jito-tips","price_usdc":0.005,"description":"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."},{"name":"get_sol_network","route":"GET /api/sol-network","price_usdc":0.005,"description":"Solana network health: recent average TPS, the current slot, the current epoch and epoch progress in %."},{"name":"get_tvl","route":"GET /api/tvl","price_usdc":0.005,"description":"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."},{"name":"get_stablecoin_flows","route":"GET /api/stablecoin-flows","price_usdc":0.01,"description":"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."},{"name":"get_dex_quote","route":"GET /api/dex-quote","price_usdc":0.005,"description":"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."},{"name":"get_peg_deviation","route":"GET /api/peg-deviation","price_usdc":0.02,"description":"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."},{"name":"get_peg_sessions","route":"GET /api/peg-sessions","price_usdc":0.03,"description":"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."},{"name":"get_peg_universe","route":"GET /api/peg-universe","price_usdc":0.05,"description":"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."},{"name":"get_exit_quote","route":"GET /api/exit-quote","price_usdc":0.02,"description":"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."},{"name":"get_eth_price","route":"GET /api/eth-price","price_usdc":0.001,"description":"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."},{"name":"get_base_gas","route":"GET /api/base-gas","price_usdc":0.001,"description":"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."},{"name":"get_base_balance","route":"GET /api/base-balance","price_usdc":0.002,"description":"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."},{"name":"get_perp","route":"GET /api/perp","price_usdc":0.001,"description":"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."},{"name":"get_liq_pulse","route":"GET /api/liq-pulse","price_usdc":0.001,"description":"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."},{"name":"get_funding_pulse","route":"GET /api/funding-pulse","price_usdc":0.001,"description":"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."},{"name":"get_spot","route":"GET /api/price","price_usdc":0.001,"description":"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."}]}