Get Quant Positioning Ladder
GET/v1/cryptodata/quant/positioning/ladder
Full-universe liquidation ladder for one coin, split by account class (Pro Plus). Every account >= $100k in the HL universe, binned on a 0.5%-of-mark grid (clamped ±50%): * `bins` / `flip` — all classes (the full book); * `bins_directional` / `flip_directional` — market-maker + vault liqs excluded (the cleaner walls; MM liquidations are hedged noise); * `bins_by_class` — `{market_maker, whale, other}` on the same grid; an account's class is its primary tag, so the three sum to `bins`; * `levels` — the 3 nearest non-empty all-class clusters above and below mark: `{price, dist_pct (signed vs mark), total_usd, side (dominant liquidation side — long = downside fuel), n_accounts}`. Same builder as the archived `liquidation_map` snapshot type (which carries `bins_by_class` from 2026-09-09), so live and history agree. `positions_as_of` is the liqmap poll cycle the ladder is built from.
Price
$0.01/ callEdge cache
300s
Uptime 24h
100.00%
p95
1.25s
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| symbol* | query | string | One coin, e.g. BTC or kPEPE (case-insensitive) |
Code
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/cryptodata/quant/positioning/ladder?symbol=BTC"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/cryptodata/quant/positioning/ladder?symbol=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/quant/positioning/ladder?symbol=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/quant/positioning/ladder?symbol=BTC").json())curl "https://api.realtimeapi.ai/v1/cryptodata/quant/positioning/ladder?symbol=BTC" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
How do I get get quant positioning ladder from CryptoDataAPI?
Send GET https://api.realtimeapi.ai/v1/cryptodata/quant/positioning/ladder. Pay $0.01 per request with x402, or send an X-API-Key header.
What does GET /quant/positioning/ladder 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.