Contents

Risk radar events

Risk radar events (whale moves, big liquidations, cascades, funding extremes, OI spikes, hacks, depegs, TVL drops, CEX outflows), newest first.

GET/api/v1/radar/eventsEvery keyPaginated

Description

Licence review: single liquidation orders reported by Binance / Bybit (big_liquidation, the record "largest single liquidation") are not published (also not in the stream and webhooks; a page can then hold fewer than limit items, so keep paging with meta.nextCursor); their funding / open-interest events keep venue and direction without the exchange’s figures; cascades and market-wide extremes leave out per-exchange amounts and keep their totals only where the total does not give one exchange’s amount.

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 /radar/events
Parameter	Description
`kinds`string	Comma-separated: whale_open, whale_close, whale_liquidated, big_liquidation, liq_cascade, funding_extreme, funding_flip, oi_spike, hack, depeg, tvl_drop, cex_outflow, hl_market_change, hl_manipulation, hl_adl, oracle_deviation, vault_drawdown, liq_extreme, protocol_outflow, incident, big_transfer, stablecoin_mint, stablecoin_burn, dex_whale_trade, risk_wallet_move, risk_wallet_listed (optional).
`minSeverity`integer	1 info, 2 notable, 3 major, 4 critical; default 1.1–4 · default 1
`coin`string	Coin name as on Hyperliquid (BTC, ETH, kPEPE, HIP-3 names like xyz:TSLA); case-insensitive.
`since`string	ISO 8601 time; only events after it (optional, a polling cursor). Clamped to the plan history (free key 30 days, keyless 24 h; meta.warnings says so).ISO 8601, e.g. 2026-10-23T12:00:00Z
`limit`integer	Number of items, default 50, clamped to 1–500.1–500 · default 50
`cursor`string	Next page: the value of meta.nextCursor from the previous response (keep the other parameters unchanged). Cursors are signed: an edited cursor answers 400; paging stops at the plan history.
`fields`string	Comma-separated fields of every item to return, e.g. id,ts,kind,severity,coin,title (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 /radar/events
Field	Description
`[].id`integer	Stable id of the item; on paginated feeds the order key together with ts.
`[].ts`string (ISO 8601)	Time of the event (ISO 8601 UTC).
`[].kind`string (enum)	Risk radar event kind.
`[].severity`"1" \| "2" \| "3" \| "4"	1 info, 2 notable, 3 major, 4 critical.
`[].coin`string · nullable	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`[].title`string	One-line factual title in our own words.
`[].body`string · nullable	Details in our own words, or null.
`[].data`any	Kind-specific details (JSON) or null.
`[].source`string · nullable	Data source (radar, defillama, …).

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

Auto-deleveraging (ADL) (how it is computed and its limits)

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/radar/events?minSeverity=2&limit=20"

Example response

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

{
  "data": [
    {
      "id": 5468,
      "ts": "2026-10-27T13:11:00.282Z",
      "kind": "funding_extreme",
      "severity": 1,
      "coin": "xyz:PURRDAT",
      "title": "xyz:PURRDAT funding at +128% APR on Hyperliquid",
      "body": "Hourly rate +0.0146% (longs pay shorts) · open interest $11.6M · mark $9.2451.",
      "data": {
        "venue": "hyperliquid",
        "fundingApr": 1.28301588,
        "fundingHourly": 0.000146463,
        "openInterestUsd": 11556929.71,
        "mark": 9.2451
      },
      "source": "hyperliquid"
    },
    {
      "id": 5467,
      "ts": "2026-10-27T13:10:12.766Z",
      "kind": "whale_close",
      "severity": 1,
      "coin": "BTC",
      "title": "Whale reduced BTC short by $1.1M on Hyperliquid (now $8M)",
      "body": "0x01e2…e977 · size 100.00 BTC · mark $80,154 · entry $80,324 · liq. price $97,456 · 5x cross. Change seen between polls at 13:02 UTC and 13:10 UTC.",
      "data": {
        "venue": "hyperliquid",
        "address": "0x01e273fc08012db1b75e8ca93f8139bfac2ee977",
        "label": null,
        "accountValue": 1602940,
        "action": "decrease",
        "side": "short",
        "prevSide": "short",
        "usd": 1078098.55,
        "usdDelta": -1078098.55,
        "sizeDelta": -13.45034,
        "size": 100,
        "prevSize": 113.45034,
        "positionUsd": 8015400,
        "prevPositionUsd": 9093498.55,
        "price": 80154,
        "entryPx": 80324.3,
        "liqPx": 97456.3192644,
        "leverage": 5,
        "leverageType": "cross",
        "pnlUsd": null,
        "pnlBasis": null,
        "prevPolledAt": "2026-10-27T13:02:51.706Z",
        "polledAt": "2026-10-27T13:10:12.766Z",
        "markMin": null,
        "markMax": null,
        "positionEventId": 224941
      },
      "source": "hyperliquid"
    }
  ],
  "meta": {
    "updatedAt": "2026-10-27T13:11:00.282Z",
    "source": "hyperliquid",
    "sources": [
      "hyperliquid"
    ],
    "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",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-27T13:14:00.000Z"
    },
    "nextCursor": "<cursor>",
    "nextUrl": "https://api.blockmetric.io/v1/radar/events?cursor=<cursor>",
    "restricted": [
      "binance",
      "bybit"
    ]
  }
}

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

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.