AgentFeed

远程 MCP 服务器，提供 102 个工具：加密货币市场数据、Solana 交易前检查、制裁筛查、论文和实用工具。通过 x402 使用 USDC 按次付费，无需 API 密钥。

访问 ochinimus.app

托管 MCP 服务器

npx add-mcp 'https://x402.ochinimus.app/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

AgentFeed

Crypto market data for AI agents (liquidations, funding, open interest, prices), Solana pre-trade checks, OFAC sanctions screening, scholarly papers, utilities and fixed-purpose language tasks (OCR, translate, summarize, extract, classify, prompt-injection check, transcribe). 95 paid data routes, 10 prepaid key packs and 8 free routes. Every route is a GET that returns JSON.

How to pay

No API key or account is needed: payment is per call, in USDC, over x402 v2 on every rail and x402 v1 on Base and Solana. Bots that cannot pay x402 can buy a prepaid key once ($0.25, $1, $5, $20; page at /keys) and send it as X-AgentFeed-Key: each call then costs half the route price, minimum $0.0005, drawn from the balance (GET /api/keys/balance, free). A 30-day bot pass for /api/liq-feed is $25 flat, with nothing drawn per call (/api/keys/buy-pass). A 24-hour day pass for /api/liq-feed and /api/liquidations is $1 flat (/api/keys/buy-day-pass), each route one call every 10 seconds per key (6 a minute): at that price a default x402 client buys it as is. A 30-day signals pass is one flat key for the briefs and the perp signal routes (/api/morning-brief, /api/move-alert, /api/anomaly-flag, /api/market-state, /api/signal-board, /api/coin-signal/{coin}, /api/oi-spike-scan, /api/liq-heatmap): $25 (/api/keys/buy-signals-pass), or $1 for 24 hours (/api/keys/buy-signals-day-pass), each route one call every 60 seconds per key, nothing drawn per call. A stock x402 client (@x402/fetch) refuses a payment over $1 until its spend cap is raised (spendControls.maxAmountPerPayment), which the $5, $20, $25, $25 purchases need.

  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": "<name>", "data": { ... }, "paid": true }.

8 rails are accepted on every paid route:

  • Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp) — USDC
  • Base (eip155:8453) — USDC
  • Polygon (eip155:137) — USDC
  • Arbitrum (eip155:42161) — USDC
  • Arc (eip155:5042) — USDC
  • Optimism (eip155:10) — USDC
  • Monad (eip155:143) — USDC
  • Avalanche (eip155:43114) — USDC

On request, a route's 402 also offers one of: Celo (eip155:42220, USDC), HyperEVM (eip155:999, USDC), Unichain (eip155:130, USDC), Scroll (eip155:534352, USDC), SKALE Base (eip155:1187947933, USDC.e), BNB Chain (eip155:56, AUSD), Ethereum (eip155:1, USDC), Robinhood Chain (eip155:4663, USDG), World Chain (eip155:480, USDC); on routes priced $0.005 or more also Sei (eip155:1329, USDC), X Layer (eip155:196, USDC). Ask with GET /api/| (the | may be sent as %7C); a payment on any of them is accepted on the plain URL as well.

MPP tempo/charge is offered on every paid route, in WWW-Authenticate of the same 402: Tempo mainnet (chain 4217), OUSD or USDC.e at the route's price, pull mode only (sign the transfer, the server broadcasts it after a response below 400, so a failed call is never charged; no fee payer).

MPP (solana/charge) is also offered on the same 402, in WWW-Authenticate, for: GET /api/sol-price, GET /api/btc-price.

Machine-readable:

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
  • GET /api/sample — free, not payment-gated
  • GET /api/sample/token-risk — free, not payment-gated
  • GET /api/keys/balance — free, not payment-gated
  • GET /api/status — free, not payment-gated

Paid data routes (95, $3.267 for one call of each)

Briefs: what changed and the level to watch

  • GET /api/anomaly-flag — $0.02 Use when an agent needs one check for what is abnormal across Hyperliquid perps right now. Returns funding, liquidation and open-interest anomalies in one ranked list, using the thresholds of /api/market-state, or nothing abnormal with what was checked. If a source is stale and nothing else was found it answers 503 rather than an all-clear, and is never billed.
  • GET /api/morning-brief — $0.03 Use when an agent needs a one-answer summary of the last 8 hours in BTC, ETH, SOL and HYPE. Returns the items ranked by how abnormal each is: price move against the coin's own usual 8-hour move, funding, open interest, liquidations (total, long/short split, biggest print), Fear and Greed, today's macro releases with UTC times, and the nearest liquidation cluster as the level to watch. A stale source is left out and named; with no sampler it answers 503, never billed.
  • GET /api/move-alert — $0.02 Use when an agent needs to know which Hyperliquid perps moved unusually. Returns each coin whose 5-minute, 1-hour or 4-hour price move, or 1-hour open-interest change, is past its own measured tail (tiers from the coin's own history, sample size printed), labelled event-driven when a scheduled FOMC, CPI, NFP or PCE release explains it. An empty list is a valid answer. Stale inputs answer 503, never billed.

Package and transaction checks

  • GET /api/honeypot-check — $0.01 — params: token, chain Use when an agent needs to know whether a token on Base, BNB Chain or Ethereum can be sold before it buys. Returns a verdict from our own buy-then-sell simulation on the token's deepest pool, with the buy and sell tax measured. Also: whether a wallet transfer works, bytecode flags (mintable, blacklist, proxy, pausable, owner), where simulation and bytecode disagree, and the block. Uniswap, Aerodrome and PancakeSwap pools. No pool found is a finding; RPC failure answers 503.
  • GET /api/pkg-check — $0.02 — params: name, ecosystem, version Use when an agent needs to know if an npm or PyPI version has a published advisory. Returns flagged (any OSV advisory for that exact version), highest severity, advisories, release, scripts, downloads, name-squat flags. 404 or 503: not charged.
  • GET /api/tx-precheck — $0.05 — params: chain, tx, to, data, value, from Use when an agent needs to see what a Solana or Base transaction does before signing it. Returns simulated balance changes, programs or contracts, approvals, new accounts, token-risk reads and warnings. 503 if it cannot simulate: not charged.

Tokenized treasury and credit yields

  • GET /api/rwa-yields — $0.02 — params: product Use when an agent needs the realized 7-day and 30-day yield of tokenized treasury and credit products, computed from issuer on-chain prices. Returns NAV, yields, contract and method. A failed read answers 503, not charged.

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; the token price is read on-chain. latest.reference is null: the underlying's reference price is not returned (its source does not allow redistribution), only the deviation computed from it.
  • 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-backtest — $0.5 — params: symbol, side, min_usd, window_min, cooldown_min, limit Use when an agent needs what price did after past liquidation cascades. Returns a symbol's events with 15 m, 1 h, 4 h and 24 h forward returns, n, mean, median, hit rate, a bootstrap interval and a random-time baseline. Not charged on 400, 404 or 503.
  • 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 our whole multi-venue liquidation tape, over 6 million liquidations, refit every 6 hours; no exchange publishes that history, so it cannot be rebuilt. 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/coin-signal/BTC — $0.004 — params: coin (path: replace the example value) Signal for one Hyperliquid perp, for trading bots. Everything on the signal board for the coin (price changes, funding, open interest, liquidations with their z-score, whale net position and tilt, flags) plus the 15-minute liquidation cascade probability from our forecast model, the nearest liquidation cluster above and below price from the 24 h liquidation heatmap, and the top 3 whale positions (side, size, entry, liquidation price). BTC, ETH, SOL, HYPE or any other Hyperliquid perp. Poll every 1-5 minutes. An unknown coin answers 400 with the supported list and a stale source answers 503; neither is billed.
  • 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 multi-venue liquidation 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. If our recording is stale it answers 503 and is never billed.
  • GET /api/signal-board — $0.01 — params: n, coins Signal board for trading bots: the Hyperliquid perp market in one table, ranked by open interest in USD (30 coins by default, up to 60, or the coins you list). Per coin: mark, 1h and 24h price change, funding (hourly and annualised), open interest in USD with its 1h and 24h change, liquidations in the last hour by side with a z-score against the coin's own last 7 days, the whale net position and tilt of the top 250 Hyperliquid accounts, and flags: crowded_long (funding_ann_pct >= 30 and oi_chg_24h_pct >= 5), crowded_short (funding_ann_pct <= -10 and oi_chg_24h_pct >= 5), squeeze_risk (crowded_short and (chg_1h_pct >= 1 or liq_1h_short_usd >= 2 x liq_1h_long_usd with liq_1h_short_usd >= 50000)), liq_spike (liq_z >= 3 and liq_1h_long_usd + liq_1h_short_usd >= 50000). Poll every 1-5 minutes: one call is the whole market structure, answered from our own caches, each source named with its as_of. A source past its staleness limit answers 503 and is never billed.
  • GET /api/squeeze-score — $0.1 — params: symbol Short squeeze score and long flush score, 0-100, for any Hyperliquid perp. Composite of Hyperliquid funding (35), whale crowding (25: the net-long share of the top 250 Hyperliquid accounts in the coin, not retail), the 24h open-interest build from our own 5-minute sampler (20) and liquidation skew from our own tape (20). One number for whether a trade is crowded and about to hurt someone. A symbol nothing lists answers 400; while the open-interest record is under 24 hours deep, or Hyperliquid or the whale snapshot is unavailable, it answers 503; both are never billed. A listed coin none of the top 250 accounts holds returns 200 with a decline naming the missing input.

Market and positioning

  • GET /api/btc-price — $0.001 BTC price / Bitcoin spot price in USD, live, read on-chain: the median of three Uniswap V3 reads on Base and Ethereum (cbBTC/USDC, and cbBTC and WBTC through WETH/USDC), computed from chain state. Returns the price, the read time and the pools that answered.
  • GET /api/eth-price — $0.001 ETH spot price in USD, read on-chain from the two deepest WETH/USDC Uniswap V3 pools, on Ethereum and on Base. Returns their median plus each pool's own price, so a caller can see the spread between chains. Computed from chain state; no exchange feed.
  • GET /api/hl-whales — $0.02 — params: coin, top Use when an agent needs to know how the biggest Hyperliquid traders are positioned. Returns the open perp positions of the largest Hyperliquid accounts aggregated per coin: net long or short USD, account counts, size-weighted entries, notional-weighted distance to liquidation, notional within 10% of liquidation and uPnL. With coin=BTC: whale liquidation levels in 5% price bands and the largest positions. Refreshed every 5 minutes; stale data answers 503.
  • GET /api/market-snapshot — $0.005 Crypto market snapshot in one call: SOL and BTC spot prices read on-chain from DEX pools, both Hyperliquid 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 the perp's basis against the Hyperliquid oracle, realized vol 7d and 30d, funding with its 30-day z-score, open interest and its changes, the top Hyperliquid accounts' net-long share, 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. When nothing of the market itself could be built it answers 503 and is never billed.
  • GET /api/positioning — $0.005 Positioning for SOL and BTC perps on Hyperliquid: open interest with its 1h and 24h change, and the net-long share of the top 250 Hyperliquid accounts. For any other Hyperliquid perp use /api/open-interest.
  • GET /api/price — $0.001 — params: symbol Use when an agent needs a spot price without choosing a venue. Returns the on-chain DEX price for SOL, BTC or ETH, the median of deep USDC pools on Solana, Ethereum and Base read from chain state, and the pools that served it. Any other symbol answers 400 with the supported list and is never billed.
  • GET /api/sol-price — $0.001 SOL price / Solana spot price in USD, live, read on-chain: the median of the two deepest SOL/USDC pools on Solana (Orca Whirlpool, Raydium CLMM), computed from chain state. Returns the price, the read time and the pools that answered.
  • GET /api/trade-context — $0.01 Crypto trading context in one call: SOL and BTC prices read on-chain from DEX pools, perp funding rates, Fear & Greed, positioning (open interest and the top Hyperliquid accounts' net-long share) 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 venues, 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 at once, not just the majors: symbol, side liquidated, USD total, prints, duration, severity. Computed from our own multi-venue liquidation tape.
  • GET /api/liq-feed — $0.001 — params: symbols, since, next Use when an agent needs liquidation pressure as it happens. Returns 5-second buckets per symbol of long and short USD liquidated across venues, the dominant side and pressure against the symbol's own baseline, from a gap-free cursor. Calls are paced per caller: one every 5 seconds (one bucket) for an x402 payer or a prepaid pack key, one every 10 seconds for a pass key, except while an answer says has_more; a call that comes too early is a 429 with Retry-After and is never billed.
  • 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 Hyperliquid funding and open interest (with 1h/24h change from our 5-minute sampler) and 24h liquidations with long/short split and biggest print from our own tape. A symbol nothing lists answers 400 and a failed read answers 503; neither is ever billed.
  • 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 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 basis for any Hyperliquid perp: its mark price against Hyperliquid's oracle price (the validators' weighted median of spot venues), as a premium or discount in %, with a contango or backwardation read and the funding context.
  • GET /api/funding-extremes — $0.02 — params: limit, min_turnover_usd Funding rate extremes across every Hyperliquid perp above a liquidity floor: 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 Hyperliquid perp, up to 200 hourly settlements: 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 Hyperliquid perps above a liquidity floor, each with 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 radar over every Hyperliquid perp: 337 on 13 Oct 2026, 178 on the main dex and 159 on the HIP-3 dexes (stocks, indices, commodities, FX). Per perp: the current funding at its 8h equivalent, its 30-day z-score against its own settled history, the dex and asset class, and a flag on any |z| of 2 or more, most extreme first. By default it returns the perps with $10M and up of open interest; min_oi_usd changes that and 0 returns them all. Precomputed every 5 minutes with as_of; a snapshot older than 15 minutes answers 503 and is never billed.
  • GET /api/funding-rate — $0.005 — params: symbol Funding rate for any Hyperliquid perp: 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. The whole table with 30-day z-scores: /api/funding-radar.
  • GET /api/oi-spike-scan — $0.02 — params: limit Open interest spikes across every Hyperliquid perp: coins whose open interest moved abnormally in the last hour against their own previous day, with the 1h, 4h and 24h change (in coin units, so a price move does not count), a spike z-score, the price move and funding. Read from our own 5-minute sampler: it answers 503 and is never billed until that record is 24 hours deep.
  • GET /api/open-interest — $0.01 — params: symbol Open interest for ANY Hyperliquid perp: OI in base units and in USD with the mark price, and its 1h and 24h change from our own 5-minute sampler (null until that record reaches back so far). /api/positioning adds the whale net-long share for SOL and BTC.
  • GET /api/tradfi-perps — $0.005 — params: symbol Use when an agent needs a 24/7 price for a stock, index, commodity or currency outside market hours. Returns Hyperliquid HIP-3 perp markets: oracle and mark price, premium, hourly and 8h funding, open interest, 24h change and the dex. With symbol (TSLA, GOLD, EUR or xyz:TSLA): every live market for it. Without: the whole list. Prices are each market's own HIP-3 oracle and mark.
  • GET /api/tradfi-radar — $0.02 — params: class, 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 the Hyperliquid HIP-3 dexes (trade[XYZ], Paragon, Markets by Kinetiq, Entropy), with funding at its 8h equivalent, a 30-day funding z-score, open interest and its 24h change, mark minus oracle basis and 24h volume. Filter by asset class. Precomputed every 5 minutes; stale data answers 503.

Microstructure and screeners

  • GET /api/orderbook-imbalance — $0.01 — params: symbol, bps Orderbook imbalance for any Hyperliquid 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 Hyperliquid perp: the largest resting orders on each side of the book, with USD size and distance from mid.
  • GET /api/top-movers — $0.01 — params: limit, min_turnover_usd Top gainers and losers over 24h across every Hyperliquid 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 Hyperliquid perp: 7-day and 30-day annualized from daily candles, plus today's range in %. A position-sizing input.

Solana on-chain

  • GET /api/base-launches — $0.02 — params: min_liq_usd, limit Use when an agent needs the newest token launches on Base. Returns pools created on Base in the last 24 hours on Uniswap V4, V3, V2 and Aerodrome, newest first, with launchpad, liquidity and volume. Each carries its pair, creation time, launchpad named from the V4 hook (Zora, Clanker, Doppler, Flaunch), quote-side liquidity, 24h volume and swaps, and our honeypot simulation for the busiest. Read from Base logs every minute; a snapshot older than 5 minutes answers 503.
  • GET /api/jito-tips — $0.005 Jito tips sampled on-chain: p25 to p99 in SOL of the newest transfers into Jito's tip accounts, what landed bundles actually paid, refreshed every 15 minutes (the age is in the answer), with a landing recommendation.
  • GET /api/priority-fees — $0.005 Solana priority fees right now: percentiles from min to max of the per-slot minimum fee paid on the busiest SOL/USDC pools over the last ~150 slots, in micro-lamports per compute unit, with a recommended level. For bots that need their transactions to land.
  • GET /api/sol-holder-clusters/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.008 — params: mint (path: replace the example value) Use when an agent needs to know whether a Solana token's holders are one owner. Returns the account that first funded each of the top 20 wallets, the clusters sharing a funder and their supply share. A shared funder can be an exchange.
  • GET /api/sol-network — $0.005 Solana network health: recent average TPS, the current slot, the current epoch and epoch progress in %.
  • GET /api/sol-token-check/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.025 — params: mint (path: replace the example value) Use when an agent needs a pre-trade check on a Solana token. Returns mint and freeze authority, Token-2022 traps, top holders, deepest pool and USD depth, the price impact of $100 and $1,000 buys, pump.fun progress, and a verdict with every rule.
  • GET /api/sol-token-flow/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.008 — params: mint (path: replace the example value), swaps Use when an agent needs to know who is trading a Solana token. Returns the unique traders over its latest swaps, top-5 share of volume, round-trip wallets, share of brand-new buyer wallets and launch-slot bundle size for mints under 7 days.
  • GET /api/token-holders/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.02 — params: mint (path: replace the example value) 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/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.005 — params: mint (path: replace the example value) SPL token metadata for any Solana mint: name, symbol, URI, decimals, total supply, mint and freeze authority, token program, and whether the metadata is still mutable. Read from the mint account and its metadata account.
  • GET /api/token-risk/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 — $0.01 — params: mint (path: replace the example value) 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, and a list of risk flags. Not a honeypot or LP-lock checker.
  • GET /api/wallet-activity/Gack9UtqfeZxFA1LqeqjLgC3JGuD7rS6CsSHKoXsD4Tu — $0.02 — params: wallet (path: replace the example value), limit Solana wallet activity: recent transactions for any address, each with the wallet's SOL and token balance changes, the fee, failures and the programs invoked. Read from the chain and summarised by us.
  • GET /api/wallet-holdings/Gack9UtqfeZxFA1LqeqjLgC3JGuD7rS6CsSHKoXsD4Tu — $0.008 — params: wallet (path: replace the example value) Solana wallet holdings for any address: native SOL with its USD value at AgentFeed's own on-chain SOL price, every SPL token with mint, symbol and amount (no token prices), and an NFT count. Balances and on-chain metadata via 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/fx-rates — $0.002 — params: base Use when an agent needs official daily exchange rates. Returns the ECB euro foreign exchange reference rates for about 30 currencies, as published or as crosses for another base, plus Hyperliquid HIP-3 FX and commodity marks. The ECB rates are available free of charge on the ECB's website; they are for information only, not for transactions.
  • 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.

Claim and fact checking

  • GET /api/claim-check — $0.15 — params: claim, urls Use when an agent needs a short claim checked against sources. Returns SUPPORTED, CONTRADICTED or INSUFFICIENT, with every supporting line quoted word for word from a filing, Wikipedia article or URL. No readable source answers 404 or 503, not charged.

Check another x402 endpoint

  • GET /api/x402-lint — $0.05 — params: url, method Use when an agent needs to check an x402 endpoint's payment challenge before paying it. Returns a verdict, a 0 to 100 score and 32 checks, paywall bypass included. Never pays. An unreachable endpoint answers 503 and a refused URL 400, neither charged.
  • GET /api/x402-test — $1 — params: url, method Use when an agent needs proof that an x402 endpoint takes a real payment. Returns PASS, FAIL or INCONCLUSIVE with the receipt after paying it once from our own wallet, up to $0.05, in Base or Solana USDC. A 503 or 404 is not charged.

Website and infrastructure checks

  • GET /api/domain/wikipedia.org — $0.005 — params: domain (path: replace the example value) Use when an agent needs the basic facts about a domain. Returns its DNS A, AAAA, MX, NS and TXT records and the live TLS certificate: issuer, alternative names, validity dates and days to expiry. Public hosts only; no registrar data.
  • GET /api/site-signals — $0.02 — params: url Use when an agent needs the technical facts of one website. Returns its TLS certificate, DNS records, a security-header grade over 8 checks, tech stack and social links. A bad URL (400) or unreachable site (503) is not charged.

SEC filings and insider trades

  • GET /api/company-check — $0.25 — params: q, site Use when an agent needs to check a US-listed company. Returns a verdict line and the SEC facts behind it: going-concern language, delisting-notice 8-Ks, overdue reports, insider Form 4 direction. EDGAR down (503) or a foreign filer (404) is not charged.
  • GET /api/insider-trades — $0.01 — params: ticker, days Use when an agent needs what a company's insiders bought and sold. Returns one row per transaction from the company's recent SEC Form 4 filings: insider, role, transaction code and meaning, shares, price, value, shares owned after and date, plus open-market buy and sale totals for the window. Source: SEC EDGAR Form 4 filings.
  • GET /api/sec-8k — $0.01 — params: hours Use when an agent needs the material events US companies disclosed in the last hours. Returns the 8-K filings filed across the market in the window, with company, CIK, filing time, accession number, the 8-K item codes and titles (e.g. 2.02 results, 5.02 officer changes, 1.01 agreements) and a count per item. Source: SEC EDGAR current filings.
  • GET /api/sec-filings — $0.005 — params: ticker, form, limit Use when an agent needs a US company's latest SEC filings. Returns the most recent EDGAR filings for a ticker, optionally one form type (10-K, 10-Q, 8-K, 4, S-1, 13F-HR), with filing date, report date, accession number, description, 8-K item codes and links to the document and the filing index. Source: SEC EDGAR public filings.

Compliance and verification

  • GET /api/email-verify — $0.005 — params: email Use when an agent needs to know whether an email address can plausibly receive mail. Returns syntax, MX, disposable-domain, role-account and free-provider checks with a deliverable_likely, risky or undeliverable verdict and its reasons. No SMTP probe.
  • GET /api/injection-check — $0.004 — params: text Use when an agent needs untrusted text screened for prompt-injection attempts. Returns no_injection_found, suspicious or malicious for up to 4,000 characters, with the matched rules (role tags, hidden Unicode, encoded payloads) and a model's view.
  • GET /api/sanctions-check/6wjqWWra8ombzaw6VHrG5xpQ972jCYF6bbHiFCbWmr4U — $0.008 — params: address (path: replace the example value) Use when an agent needs to screen a crypto wallet before paying or being paid. Returns an exact match of a Bitcoin, Ethereum, Tron, Solana or other address against the OFAC SDN list, with entry, program and list date. No match is not a clearance.

Research and reference

  • GET /api/paper/10.1038%2Fnature14539 — $0.005 — params: doi (path: replace the example value) Use when an agent needs the paper behind a DOI. Returns title, year, authors, venue, citation count, open-access URL and the abstract where OpenAlex holds it (CC0 data). The DOI goes in the path as written, slash included: /api/paper/10.1038/nature14539.
  • GET /api/papers — $0.015 — params: q, year_from, limit Use when an agent needs scholarly papers on a topic. Returns OpenAlex works (CC0 data) for a search: title, year, DOI, authors, venue, citation count and open-access link, up to 25, optionally from a given year. Cached 24 hours.
  • GET /api/wiki — $0.005 — params: title, lang Use when an agent needs a reliable plain-text summary of a topic. Returns the Wikipedia summary and lead section for a page title in any language, with the CC BY-SA 4.0 licence, the article URL and the authors link. Cached 24 hours.

Web, document and audio extraction

  • GET /api/extract — $0.025 — params: url, schema Use when an agent needs named fields from a page or PDF. Returns JSON for a schema of up to 20 fields (string, number, boolean, date, string[]), with null for anything the document does not state, never an invented value.
  • GET /api/ocr — $0.04 — params: url Use when an agent needs the text inside an image. Returns the text of a PNG, JPEG, WebP or GIF (5 MB, 4096 px a side) in reading order, as blocks with their line breaks, plus the detected language. It transcribes; it never follows text in the image.
  • GET /api/pdf-markdown — $0.01 — params: url Use when an agent needs the text of a PDF as markdown. Returns the text of the one PDF URL you pass, page by page as markdown, with title, page count and word count. http or https, 10 MB, 10 s; robots.txt honoured and private addresses refused. A file that is not a PDF, a PDF with no text layer (a scan), or an unreachable URL, is never charged.
  • GET /api/summarize — $0.02 — params: url, length Use when an agent needs the gist of a web page or PDF. Returns a short or medium summary with key points, and says whether the document was cut at 20,000 tokens and how much was read. Uses only what the document says.
  • GET /api/transcribe — $0.02 — params: url Use when an agent needs the words in an audio file. Returns the text, timed segments and the spoken language for mp3, wav, m4a, ogg or webm audio (10 MB, 5 minutes, checked from the file). Cached 24 hours by the audio itself.
  • GET /api/web-markdown — $0.005 — params: url Use when an agent needs the readable text of a web page as markdown. Returns the main content of the one URL you pass as clean markdown (Mozilla Readability, then turndown), with title, final URL, fetch time and word count. http or https on ports 80 and 443, 5 MB, 10 s; robots.txt honoured and private addresses refused. A blocked or unreachable URL is never charged.

Text and language

  • GET /api/classify — $0.005 — params: text, labels Use when an agent needs text sorted into its own categories. Returns a score per label that sums to 1 and the best label, for up to 4,000 characters and 2 to 20 labels. Labels are names, never instructions. Cached 24 hours.
  • GET /api/translate — $0.04 — params: to, text Use when an agent needs text in another language. Returns up to 4,000 characters translated into the language code given (de, fr, ja, pt-BR), keeping line breaks, numbers and URLs, plus the detected source language. It never obeys the text.

Utilities

  • GET /api/convert — $0.005 — params: value, from, to Use when an agent needs an exact unit conversion. Returns the value converted between units of length, mass, volume, time, data, speed, area, pressure, energy or temperature, to 12 significant digits. Mixing categories is a 400, never billed.
  • GET /api/hash — $0.005 — params: alg, data, as Use when an agent needs a hash it should not compute itself. Returns SHA-256, Keccak-256 (the Ethereum hash) or BLAKE2b-512 of UTF-8 text or hex bytes, as hex and 0x-hex. Input up to 2 KB; over that is a 400, never billed.
  • GET /api/qr — $0.005 — params: data, format Use when an agent needs a QR code for a link, address or payment string. Returns an SVG or PNG (base64 and data URI) at error-correction level M, scaled for scanning. Input up to 2 KB; over that is a 400, never billed.
  • GET /api/time — $0.005 — params: tz, at Use when an agent needs an exact time conversion with the right daylight-saving rules. Returns an ISO time or epoch in any IANA time zone: local time with offset, weekday, abbreviation, DST flag and epoch. Defaults to now in UTC.

Prepaid key packs (10)

Credit, not data: one x402 payment buys a key whose balance pays for calls at half the route price.

  • GET /api/keys/buy-trial — $0.25
  • GET /api/keys/buy-1 — $1
  • GET /api/keys/buy-5 — $5
  • GET /api/keys/buy-20 — $20
  • GET /api/keys/buy-pass — $25
  • GET /api/keys/buy-day-pass — $1
  • GET /api/keys/buy-signals-pass — $25
  • GET /api/keys/buy-signals-day-pass — $1
  • GET /api/keys/topup-5 — $5
  • GET /api/keys/topup-20 — $20

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 like GET, with no body. The paid surface is GET-only.
  • Rate limit, per caller per minute: 240 for GET and POST /mcp, 2400 for every other method, 120 for the discovery documents (/openapi.json, /llms.txt, /SKILL.md and the /.well-known files) and 1200 for an unpaid GET on a priced route (the plain 402 challenge). A 429 carries Retry-After.
  • A route that cannot reach its upstream returns an error rather than a stale or invented value.