Crypto market data API

1. Make your first request, no key needed

   Paste this into a terminal. The header X-Blockmetric-Access: public runs it on the free tier without a key (24 h of history).

   cURLJavaScriptPython

   Copy

   curl -s -H "X-Blockmetric-Access: public" \
     "https://api.blockmetric.io/v1/liquidations/summary?hours=24"

   What you get back (a real response recorded with an API Dev key on 2026-10-27, lists shortened)

   {
     "data": {
       "hours": 24,
       "totalUsd": 87626913.95,
       "longUsd": 45040168.79,
       "shortUsd": 42586745.16,
       "count": 41720,
       "byVenue": [
         {
           "venue": "binance",
           "longUsd": 36832351.85,
           "shortUsd": 32523143.65,
           "count": 31025
         },
         {
           "venue": "bybit",
           "longUsd": 7730566.19,
           "shortUsd": 7924491.54,
           "count": 10689
         }
       ],
       "byCoin": [
         {
           "coin": "BTC",
           "longUsd": 10729795.17,
           "shortUsd": 9543197.16,
           "count": 1467
         },
         {
           "coin": "ETH",
           "longUsd": 5920035.9,
           "shortUsd": 8695988.38,
           "count": 1272
         }
       ],
       "largest": {
         "id": 240641,
         "ts": "2026-10-26T15:21:04.781Z",
         "venue": "hyperliquid",
         "coin": "BTC",
         "side": "short",
         "price": 80736.4290138,
         "qty": 22.9291,
         "usd": 1851213.65
       },
       "series": [
         {
           "t": "2026-10-26T13:00:00.000Z",
           "longUsd": 9339543.97,
           "shortUsd": 1113072.12
         },
         {
           "t": "2026-10-26T14:00:00.000Z",
           "longUsd": 2025809.46,
           "shortUsd": 3477513.42
         }
       ],
       "coveredSince": "2026-10-23T00:27:23.214Z",
       "updatedAt": "2026-10-27T13:12:16.218Z",
       "hourlySumsBefore": null
     },
     "meta": {
       "updatedAt": "2026-10-27T13:12:16.218Z",
       "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"
       ]
     }
   }

2. Get API key

   Sign up (free) and create a key under Account › API keys: 10 requests a minute, 1,000 a day and 30 days of history, personal use. Then send Authorization: Bearer $BLOCKMETRIC_API_KEY instead of the public header.

3. Go real time: stream or webhook

   API Pro pushes every radar event (big liquidations, cascades, whales near liquidation, exploits, depegs) as Server-Sent Events or as signed webhooks; API Dev includes webhooks too. Webhooks · Live stream

   cURLJavaScriptPython

   Copy

   curl -N -H "Authorization: Bearer $BLOCKMETRIC_API_KEY" \
     "https://api.blockmetric.io/v1/stream?kinds=big_liquidation,liq_cascade&minSeverity=2"

Step-by-step recipes with complete code in cURL, JavaScript and Python, real output and the plan each one needs.

Every coin your plan covers. All 35 endpoints

Authentication

Authorization: Bearer bm_live_… or x-api-key, from your server. See keys and limits.

Envelope

{ data, meta }; errors { error: { code, message, doc_url, request_id } }. See conventions.

Units

Times ISO 8601 UTC · money USD · funding, distances and *Pct fields as fractions (0.01 = 1 %).

Pagination

limit + cursor until meta.nextCursor is null. See pagination and caching.

Versioning

/api/v1 changes only additively; breaking changes ship as /api/v2 with six months of overlap. See the changelog.

• OpenAPI 3.1 · YAML for codegen and API tools
• Postman collection · .http file
• AI agents llms.txt, Markdown reference, MCP
• Historical data stored history in bulk
• Status data freshness and uptime

TypeScript / JavaScript, Python, CLI, MCP server are being prepared for release. Every example in the docs works today with plain HTTP: cURL, JavaScript or Python.

Every response carries meta.license and meta.attribution, the finished credit line with the sources of that response. Without a key: personal and non-commercial use; when you show the data, show the linked credit "Data by Blockmetric". Widgets, embeds, chart images and downloads: free for non-commercial and editorial use with the visible, linked credit "Data by Blockmetric"; third-party exchange values stay under the exchange's terms. What each plan may do: API pricing · Terms

Code: the SDKs, CLI and MCP server will be Apache-2.0 once published (the name Blockmetric is not licensed); code snippets and the examples are MIT-0.

<a href="https://blockmetric.io/" rel="noopener">Data by Blockmetric</a> · Source: Blockmetric Research · Binance · Bybit