Contents

Taker flow (CVD) and volume profile

Taker flow of one coin: buy / sell volume of the aggressor per bar, delta and cumulative volume delta (CVD), summed over the perpetual venues, per venue (Binance spot separately where collected), by print size (under $10k, $10k–100k, $100k–1M, $1M and more; a print = the fills of one taker order) and for tracked Hyperliquid whales (USD they bought minus sold, either side of the trade), plus the volume profile (taker volume by price, point of control, 70 % value area) of the window.

GET/api/v1/flow/{coin}Every key

Description

Free keys: BTC, ETH and HYPE, last 24 hours. Coins without a Hyperliquid market answer 404. Licence review: byVenue shows Hyperliquid only; total, bySize and the profile still sum every venue, in bars of at least 5 minutes (venue=hyperliquid keeps 1-minute bars); venue=binance|bybit answers 403 source_restricted.

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 /flow/{coin}
Parameter	Description
`coin`string · pathrequired	Coin name, e.g. BTC (case-insensitive).
`venue`string	hyperliquid \| binance \| bybit (optional).one of hyperliquid, binance, bybit
`hours`integer	Window in hours, default 24 (free key 1), clamped to the plan history (Pro / API Dev 168, Desk / API Pro 9600).1–9600 · default 24
`stepMinutes`integer	Bar size 1 \| 5 \| 15 \| 60 \| 240 \| 1440 minutes (default: ≤ 360 bars; windows older than 8 days use hourly bars). At most 1,440 bars per call: a finer size is coarsened to the next one that fits (e.g. stepMinutes=1 over 48 hours → 5-minute bars); the answer names the size used in stepMinutes.one of 1, 5, 15, 60, 240, 1440

Response fields

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

Response fields of /flow/{coin}
Field	Description
`coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`stepMinutes`integer	Bar / column width in minutes.
`from`string (ISO 8601)	Start of the window (ISO 8601 UTC) or the sending side of a movement.
`to`string (ISO 8601)	End of the window (ISO 8601 UTC) or the receiving side of a movement.
`total[]`array of objects	Perpetual venues summed. Can have gaps: bars without collected data are left out (never sent as 0).
`total[].t`string (ISO 8601)	Bar start.
`total[].buyUsd`number	Taker buys (USD).
`total[].sellUsd`number	Taker sells (USD).
`total[].delta`number	Buys minus sells (USD).
`total[].cvd`number	Cumulative delta since the window start (USD).
`byVenue[]`array of objects	Split per venue.
`byVenue[].venue`"hyperliquid" \| "binance" \| "bybit"	Venue of the order-flow data.
`byVenue[].market`"perp" \| "spot"	perp = perpetual futures, spot = spot market.
`byVenue[].points[]`array of objects	Bars of the series, oldest first.
`byVenue[].points[].t`string (ISO 8601)	Bar start.
`byVenue[].points[].buyUsd`number	Taker buys (USD).
`byVenue[].points[].sellUsd`number	Taker sells (USD).
`byVenue[].points[].delta`number	Buys minus sells (USD).
`byVenue[].points[].cvd`number	Cumulative delta since the window start (USD).
`byVenue[].buyUsd`number	Taker buys (USD).
`byVenue[].sellUsd`number	Taker sells (USD).
`bySize[]`array of objects	Perpetual venues summed, per print size.
`bySize[].bucket`"lt10k" \| "10k_100k" \| "100k_1m" \| "gt1m"	Print size: lt10k, 10k_100k, 100k_1m, gt1m.
`bySize[].label`string	Display label: a public label with a cited source, else the self-chosen leaderboard name (unverified).
`bySize[].points[]`array of objects	Bars of the series, oldest first. Can have gaps like total.
`bySize[].points[].t`string (ISO 8601)	Start of the bucket or bar (ISO 8601 UTC).
`bySize[].points[].delta`number	Buys minus sells (USD).
`bySize[].points[].cvd`number	Cumulative delta (USD).
`bySize[].buyUsd`number	Taker buys (USD).
`bySize[].sellUsd`number	Taker sells (USD).
`whales`object · nullable	Tracked Hyperliquid whales (either side of the trade).
`whales.points[]`array of objects	Bars of the series, oldest first.
`whales.points[].t`string (ISO 8601)	Bar start.
`whales.points[].buyUsd`number	Taker buys (USD).
`whales.points[].sellUsd`number	Taker sells (USD).
`whales.points[].delta`number	Buys minus sells (USD).
`whales.points[].cvd`number	Cumulative delta since the window start (USD).
`whales.buyUsd`number	Bought by tracked whales (USD).
`whales.sellUsd`number	Sold by tracked whales (USD).
`totals`object	Sums over the rows of this object.
`totals.buyUsd`number	Taker buys (USD).
`totals.sellUsd`number	Taker sells (USD).
`totals.delta`number	Buys minus sells (USD).
`totals.trades`integer	Prints.
`updatedAt`string (ISO 8601) · nullable	Newest data time of this item (ISO 8601 UTC).
`profile`object	-
`profile.coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`profile.from`string (ISO 8601)	Start of the window (ISO 8601 UTC) or the sending side of a movement.
`profile.to`string (ISO 8601)	End of the window (ISO 8601 UTC) or the receiving side of a movement.
`profile.step`number	Price step of the levels.
`profile.levels[]`array of objects	Price levels, ascending.
`profile.levels[].px`number	Lower edge.
`profile.levels[].buyUsd`number	Taker buys (USD).
`profile.levels[].sellUsd`number	Taker sells (USD).
`profile.totalUsd`number	Volume (USD).
`profile.poc`number · nullable	Point of control (level with the most volume).
`profile.valueArea`object · nullable	Smallest range around the POC with 70 % of the volume.
`profile.valueArea.lo`number	Lower edge.
`profile.valueArea.hi`number	Upper edge.
`profile.venues[]`array of "hyperliquid" \| "binance" \| "bybit"	Venues covered by this view.

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
404not_found Not found
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Methodology

CVD (cumulative volume delta) (how it is computed and its limits)

Request

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

Example response

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

{
  "data": {
    "coin": "BTC",
    "stepMinutes": 5,
    "from": "2026-10-27T12:10:00.000Z",
    "to": "2026-10-27T13:13:53.000Z",
    "total": [
      {
        "t": "2026-10-27T12:10:00.000Z",
        "buyUsd": 8807814,
        "sellUsd": 3490221,
        "delta": 5317593,
        "cvd": 5317593
      },
      {
        "t": "2026-10-27T12:15:00.000Z",
        "buyUsd": 42452634,
        "sellUsd": 11270515,
        "delta": 31182119,
        "cvd": 36499712
      }
    ],
    "byVenue": [
      {
        "venue": "hyperliquid",
        "market": "perp",
        "points": [
          {
            "t": "2026-10-27T12:10:00.000Z",
            "buyUsd": 3179356,
            "sellUsd": 973729,
            "delta": 2205627,
            "cvd": 2205627
          },
          {
            "t": "2026-10-27T12:15:00.000Z",
            "buyUsd": 11418801,
            "sellUsd": 802719,
            "delta": 10616083,
            "cvd": 12821710
          }
        ],
        "buyUsd": 74715068,
        "sellUsd": 74758104
      }
    ],
    "bySize": [
      {
        "bucket": "lt10k",
        "label": "under $10k",
        "points": [
          {
            "t": "2026-10-27T12:10:00.000Z",
            "delta": 527521,
            "cvd": 527521
          },
          {
            "t": "2026-10-27T12:15:00.000Z",
            "delta": 1823841,
            "cvd": 2351362
          }
        ],
        "buyUsd": 36401406,
        "sellUsd": 42947433
      },
      {
        "bucket": "10k_100k",
        "label": "$10k–100k",
        "points": [
          {
            "t": "2026-10-27T12:10:00.000Z",
            "delta": 491300,
            "cvd": 491300
          },
          {
            "t": "2026-10-27T12:15:00.000Z",
            "delta": 5835707,
            "cvd": 6327008
          }
        ],
        "buyUsd": 126480550,
        "sellUsd": 124510402
      }
    ],
    "whales": {
      "points": [
        {
          "t": "2026-10-27T12:10:00.000Z",
          "buyUsd": 2785171,
          "sellUsd": 3707111,
          "delta": -921940,
          "cvd": -921940
        },
        {
          "t": "2026-10-27T12:15:00.000Z",
          "buyUsd": 7444496,
          "sellUsd": 8987568,
          "delta": -1543072,
          "cvd": -2465012
        }
      ],
      "buyUsd": 98106310,
      "sellUsd": 59848803
    },
    "totals": {
      "buyUsd": 635091915,
      "sellUsd": 474350621,
      "delta": 160741294,
      "trades": 75575
    },
    "updatedAt": "2026-10-27T13:12:00.000Z",
    "profile": {
      "coin": "BTC",
      "from": "2026-10-27T12:13:53.000Z",
      "to": "2026-10-27T13:13:54.000Z",
      "step": 50,
      "levels": [
        {
          "px": 79850,
          "buyUsd": 1662982,
          "sellUsd": 536582
        },
        {
          "px": 79900,
          "buyUsd": 15664109,
          "sellUsd": 2782483
        }
      ],
      "totalUsd": 1101659798,
      "poc": 80200,
      "valueArea": {
        "lo": 80150,
        "hi": 80400
      },
      "venues": [
        "hyperliquid",
        "binance"
      ]
    }
  },
  "meta": {
    "updatedAt": "2026-10-27T13:12:00.000Z",
    "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 flow() / flow()

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.