Contents

Screener (every coin)

Screener: one row per Hyperliquid coin with price change 1h / 24h (Hyperliquid mark), open interest of the enabled venues and its change 1h / 24h, current and predicted Hyperliquid funding (annualised), tracked Hyperliquid long/short and Binance top-trader ratio, liquidations of the last 24 h, the nearest big liquidation cluster (signed distance, USD, side), RSI(14) of 1h and 4h candles and 24 h realised volatility (annualised; computed for the 80 largest coins by open interest, else null).

GET/api/v1/screenerEvery key

Description

Licence review: lsBinanceTop is null and coins without a Hyperliquid market are left out (meta.restricted); open interest summed over venues stays, except where exactly one withheld exchange is in the sum (then oiUsd is null: the total minus Hyperliquid would be that exchange’s value).

Who can call it

Available with every key and keyless (X-Blockmetric-Access: public). Keys of Free accounts get free-tier data (real-time feeds, 30 days of history, heatmap over time for every coin over the last 24 hours, liquidation levels now for every coin, the same as the free web plan); Pro and Desk keys the data of their plan; API Dev / API Pro raise the limits.

No key: 24 h
Free: 30 days
Pro: 365 days
Desk: 1095 days
API Dev: 365 days
API Pro: 1095 days

History window per plan. Limits: Authentication & limits.

Parameters

Parameters of /screener
Parameter	Description
`coin`string	Only this coin (optional).
`sort`string	oi (default) \| change1h \| change24h \| oiChange1h \| oiChange24h \| funding \| fundingPred \| ls \| liq24h \| cluster \| rsi1h \| rsi4h \| vol \| coin; missing values sort last.one of oi, change1h, change24h, oiChange1h, oiChange24h, funding, fundingPred, ls, liq24h, cluster, rsi1h, rsi4h, vol, coin · default oi
`dir`string	desc (default) \| asc.one of asc, desc · default desc
`minOiUsd`number	Minimum open interest in USD, default 0.≥ 0 · default 0
`limit`integer	Number of items, default 100, clamped to 1–500.1–500 · default 100
`fields`string	Comma-separated fields of every item to return, e.g. coin,mark,change24h,oiUsd,fundingApr,rsi1h (case-insensitive). All other fields are left out, so large lists get much smaller; an unknown name answers 400 with the list of fields. Default: every field.
`format`string	json (default: the { data, meta } envelope) \| csv (the rows with a header line; nested values as JSON text) \| ndjson (one JSON object per row and line). csv and ndjson carry the meta block in headers: Link rel="next" and X-Blockmetric-Next-Cursor (next page), X-Blockmetric-Next-After (forward polling), X-Blockmetric-Updated-At, X-Blockmetric-Warnings, X-Blockmetric-License. Errors stay JSON.one of json, csv, ndjson · default json

Response fields

Every success is { data, meta }; these are the fields of data. meta is the same on every endpoint.

Response fields of /screener
Field	Description
`[].coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`[].mark`number · nullable	Hyperliquid mark; for a coin without a Hyperliquid market the mark of the enabled exchange with the largest open interest.
`[].change1h`number · nullable	Price change in 1 h, fraction.
`[].change24h`number · nullable	Price change in 24 h, fraction.
`[].oiUsd`number · nullable	Open interest of the enabled venues (USD).
`[].oiChange1h`number · nullable	Open interest change in 1 h (venues with a value at both times), fraction.
`[].oiChange24h`number · nullable	Open interest change in 24 h, fraction.
`[].volume24hUsd`number · nullable	Hyperliquid 24 h volume (coins without a Hyperliquid market: summed over the exchanges that report one) (USD).
`[].fundingApr`number · nullable	Hyperliquid funding now, annualised fraction (null for a coin without a Hyperliquid market).
`[].fundingPredApr`number · nullable	Predicted next Hyperliquid funding, annualised fraction.
`[].lsHl`number · nullable	Tracked Hyperliquid long USD / short USD.
`[].lsBinanceTop`number · nullable	Binance top traders long/short (positions); null when Binance is switched off.
`[].liq24hUsd`number · nullable	Liquidations in 24 h (CEX as reported, Hyperliquid confirmed by fills) (USD).
`[].liq24hLongUsd`number · nullable	Long liquidations in 24 h (USD).
`[].liq24hShortUsd`number · nullable	Short liquidations in 24 h (USD).
`[].clusterDistance`number · nullable	Signed distance mark → nearest big liquidation cluster, fraction (−0.03 = 3 % below).
`[].clusterUsd`number · nullable	USD in that cluster (USD).
`[].clusterSide`"long" \| "short" · nullable	Dominant side of the cluster.
`[].rsi1h`number · nullable	RSI(14) of 1h candles, 0–100.
`[].rsi4h`number · nullable	RSI(14) of 4h candles, 0–100.
`[].vol24h`number · nullable	24 h realised volatility of 1h closes, annualised fraction.
`[].maxLeverage`integer · nullable	Maximum leverage the venue allows on this market.

Errors

400invalid_param Invalid parameter
401unauthorized Missing or invalid API key
403plan_required Plan does not include this
403scope_required Key not scoped for this API
403ip_not_allowed Address not on the IP allowlist of the key
403origin_not_allowed Key used from a browser origin it does not allow
403source_restricted Exchange data not redistributed
403https_required https required
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Methodology

Open interest (how it is computed and its limits)
RSI (14) (how it is computed and its limits)
Realised volatility (how it is computed and its limits)

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/screener?sort=oi&limit=20"

Example response

HTTP 200Real data from 2026-10-27 13:11 UTC

{
  "data": [
    {
      "coin": "BTC",
      "mark": 80213,
      "change1h": 0.0040556272,
      "change24h": 0.000688641654337,
      "oiUsd": 16446120328.18,
      "oiChange1h": 0.0045461206,
      "oiChange24h": 0.0368906985,
      "volume24hUsd": 2288160809.64,
      "fundingApr": 0.1095,
      "fundingPredApr": 0.1095,
      "lsHl": 0.9684562624,
      "lsBinanceTop": null,
      "liq24hUsd": 20272992.33,
      "liq24hLongUsd": 10729795.17,
      "liq24hShortUsd": 9543197.16,
      "clusterDistance": -0.1179733958,
      "clusterUsd": 111932021.19,
      "clusterSide": "long",
      "rsi1h": 57.1619899374,
      "rsi4h": 32.6956309664,
      "vol24h": 0.3393247089,
      "maxLeverage": 40
    },
    {
      "coin": "ETH",
      "mark": 2329.29,
      "change1h": 0.0067381251,
      "change24h": 0.0047405426,
      "oiUsd": 9985278064.77,
      "oiChange1h": 0.006078191,
      "oiChange24h": 0.0244856051,
      "volume24hUsd": 852734460.37,
      "fundingApr": 0.1095,
      "fundingPredApr": 0.1095,
      "lsHl": 0.9831029407,
      "lsBinanceTop": null,
      "liq24hUsd": 14616024.28,
      "liq24hLongUsd": 5920035.9,
      "liq24hShortUsd": 8695988.38,
      "clusterDistance": -0.0662390686,
      "clusterUsd": 106766633.66,
      "clusterSide": "long",
      "rsi1h": 59.0517061828,
      "rsi4h": 33.6493956044,
      "vol24h": 0.4253224428,
      "maxLeverage": 25
    }
  ],
  "meta": {
    "updatedAt": "2026-10-27T13:11:52.327Z",
    "source": "hyperliquid,binance,bybit",
    "sources": [
      "hyperliquid",
      "binance"
    ],
    "plan": "api_dev",
    "delayMinutes": 0,
    "commercial": false,
    "license": {
      "id": "internal",
      "display": false,
      "attributionRequired": false,
      "attribution": null,
      "redistribution": false,
      "mauCap": null,
      "terms": "https://blockmetric.io/terms#api-license"
    },
    "attribution": {
      "text": "Data by Blockmetric · Source: Blockmetric Research · Binance · Bybit",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-27T13:14:00.000Z"
    },
    "restricted": [
      "binance",
      "bybit"
    ]
  }
}

Lists shortened to their first items (1 more in the real response).

More options: open in the explorer · SDK method screener() / screener()

Code snippets in these docs are licensed under MIT-0: copy them into your own code without attribution. The SDKs, CLI and MCP server will be, once published, Apache-2.0; the name Blockmetric is not licensed (forks must be renamed). Data from the API is governed by the API terms; third-party exchange data by the exchange’s terms.