API explorer

Pick an endpoint, fill in parameters, send. Requests run on our server through the real API, with your own key when you are logged in or without a key on the free tier. No key ever reaches the page.

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/heatmap/BTC/wallets?clusters=3"

Try it

EndpointTracked Hyperliquid wallets whose position in this coin has its liquidation price in a band right now: size, side, leverage, liquidation price and its signed distance from the mark (liqDistance, fraction), with a link to the wallet page (url). The same positions the live heatmap columns are built from (the newest poll of each wallet, minutes old; a long whose liquidation price is already at or above the mark, or a short at or below it, is left out as on the heatmap). Reconstructed or daily columns have no wallets: wallets are listed for now only. Ask for one band with lo and hi, the heatmap row holding a price with price, or the N largest levels above and below the mark of the current liquidation map with clusters (the default, clusters=3, when none of them is given; each with its wallets; longLevelUsd / shortLevelUsd = the USD of that level in the map). positions, longUsd and shortUsd count every tracked position in the band, wallets lists the largest (limit). Only wallets we track, not every account on Hyperliquid. Same plan rule as /liqmap/{coin}.

coin * string

lo number

hi number

price number

clusters integer

side string

minUsd number

limit integer

Keyless free tier: 24 h of history, a few requests a minute per address.

Get a free key for 30 days of history and your own limits.

Choose an endpoint, fill in parameters and send. The response appears here with its status, headers and timing.

Parameters, response fields and a real example of every endpoint: API reference.