Coming soon · Developer API

The whole tape,in one API.

Everything the HODLChart terminal sees, streamed to your code. Aggregated order flow, liquidity, and liquidations from 20+ exchanges, behind one clean, fast endpoint. Build the edge into your own systems.

Join the API waitlist

Preview the endpoints

REST + WebSocket · Endpoints below are a preview

hodlchart-api · v1

200 · 12ms

$ curl https://api.hodlchart.com/v1/orderflow/BTC-PERP
    -H "Authorization: Bearer sk_live_..."

{
  "symbol": "BTC-PERP",
  "price": 67241.5,
  "cvd": { "spot": 1240, "perp": -820 },
  "liquidations": { "longs": 4.2e6, "shorts": 0.9e6 },
  "funding": 0.0121,
  "venues": ["binance", "bybit", "okx"],
  "ts": 1720000000
}

What it exposes

The terminal's data, as an endpoint.

The same aggregated engine behind the HODLChart terminal and Sonar, normalized into one clean schema. No wrangling 20 exchange APIs. One key, one shape.

Order flow & CVD

Aggregated buy/sell aggression

Liquidity & depth

Order book heatmap snapshots

Liquidation feed

Clusters and prints, live

Funding & OI

Positioning across venues

OHLCV

Every timeframe, one schema

WebSocket streams

Real-time, sub-second

20+ venues, one shape

Normalized, not raw

Keyed & rate-limited

Simple bearer auth

New to the data? Read the guides on order flow, liquidity heatmaps, liquidations, and funding.

Real-time

Snapshot it, or stream it live.

Pull a clean snapshot over REST, or subscribe to the same order-flow feed that powers the charts and get every print the second it happens.

REST for snapshots, WebSocket for the live tape
One normalized schema across every venue
Sub-second streaming, built on the same feed as the terminal
Simple bearer auth, generous limits for builders

stream.js · WebSocket

LIVE

const ws = new WebSocket("wss://api.hodlchart.com/v1/stream");

ws.onopen = () => ws.send(JSON.stringify({
  op: "sub",
  channel: "liquidations",
  symbol: "BTC-PERP"
}));

ws.onmessage = (e) => {
  const liq = JSON.parse(e.data);
  // { side: "long", usd: 4.2e6, px: 67180 }
};

Developer FAQ

For the builders.

The honest state of the API: what's coming, when, and what you'll be able to build on it.

01When will the API be available?

It's on the way, rolling out alongside HODLChart 1.0. Join the waitlist and you'll be first to get a key when access opens, ahead of the public launch.

02Will the API be free?

Early access builders get generous free limits while we're in beta. Paid tiers for higher throughput will come later, and waitlist members lock in founding terms.

03REST, WebSocket, or both?

Both. REST for clean snapshots and historical pulls, WebSocket for the live tape: order flow, liquidations, and funding streamed the second they print.

04What data will it cover?

The same aggregated engine behind the terminal: order flow and CVD, liquidity/depth, liquidation feeds, funding and open interest, and OHLCV, normalized across 20+ venues.

05How does authentication work?

A simple bearer key per project. It's read-only market data, so your API keys never touch an exchange account.

Build on the tape.

The API is coming soon. Join the waitlist and you'll get a key before it opens to the public, plus founding terms locked in.

Join the API waitlist

Coming soon · Read-only market data