Get Depth For Coin
GET/v1/cryptodata/liquidity/depth/{coin}
Per-coin depth history (rolling, up to 24h). Free: BTC only; Pro + Pro Plus: any tracked coin. **Tracked universe is the top 25 Hyperliquid perps by 24h notional** (re- selected each sweep), not every coin — an untracked coin 404s. The current set is the ``coins`` list on ``/liquidity/depth``. ``minutes`` is a **time** window measured back from now, not a row count. Sampling runs on a ~2-minute timer and can skip, so ``count`` is the number of snapshots that actually landed in the window — expect roughly ``minutes / 2``, fewer after a stall. Each record carries ``ts`` so staleness is visible. Each record carries ``depth_usd.bid`` / ``depth_usd.ask`` per band (10/25/50/100 bps) plus ``imbalance_10bps``. ``levels_truncated`` flags, per band per side, when the deepest level in HL's ~20-level snapshot still sat inside the band — that band's ``depth_usd`` is then a lower bound on the true resting depth, not the depth.
Price
$0.01/ callEdge cache
Off
Uptime 24h
100.00%
p95
417ms
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| coin* | path | string | |
| minutes | query | integer = 60 | Trailing wall-clock minutes of history (max 24h) |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/BTC"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/BTC" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/BTC")).json();
console.log(data);# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests
session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/BTC").json())curl "https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/BTC" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
How do I get get depth for coin from CryptoDataAPI?
Send GET https://api.realtimeapi.ai/v1/cryptodata/liquidity/depth/{coin}. Pay $0.01 per request with x402, or send an X-API-Key header.
What does GET /liquidity/depth/{coin} cost?
$0.01 per successful request in USDC on Base. Failed requests are never charged.
Can I call this endpoint from an MCP client?
Yes. Connect any MCP client to the RealtimeAPI server and use call_feed with this endpoint's URL, or get_quote to check the price first.