API
Programmatic Access
RESTful API with authenticated access. JSON responses, sub-second latency, 10-second data freshness. Built for algo traders and institutional desks.
Endpoints
All endpoints require API key authentication via the X-API-Key header.
GET/v1/heatmap— Liquidation fuel zones, exchange-weighted, cumulative curves
GET/v1/market— Price, OI, funding, L/S ratio, live liquidations, gravity bias
GET/v1/whales— Whale trade activity, buy/sell pressure, recent large trades
GET/v1/price_history— Per-minute price with liquidation + whale overlays (up to 72h)
GET/v1/density— Wall density scoring, leverage distribution per cluster
GET/v1/sentiment— Composite sentiment, whale playbook phase, cascade probability
GET/v1/status— Server health, collector status, data freshness
JSON responses, no XML
Sub-second response time
10-second data freshness
Rate-limited per key
CORS enabled
Example Response — /v1/heatmap
{
"btc_price": 76542.80,
"heatmap_total_fuel_above": 9523.95,
"heatmap_total_fuel_below": 12857.69,
"heatmap_above": [
{"price": 76600, "fuel_btc": 18.41, "distance": 57.2, "avg_leverage": 27.1, "density": 0.42},
{"price": 76680, "fuel_btc": 54.10, "distance": 137.2, "avg_leverage": 21.3, "density": 0.67}
],
"open_interest": {
"total_btc": 195016, "binance": 105151, "bybit": 54959, "okx": 33937
},
"zones_above": [
{"start": 76600, "end": 76840, "fuel_btc": 142.3, "distance": 97}
],
"nearest_cluster_below": {"price": 75800, "fuel_btc": 607.47, "distance": 742.8}
}