Contents

Exchange on-chain flows

On-chain exchange flows: inflow, outflow and net (in − out) per exchange and asset over a window, from every scanned transfer into or out of the exchange’s own proof-of-reserves addresses (all sizes on Ethereum, Arbitrum and Base; large transactions on Bitcoin).

GET/api/v1/exchange-flowsEvery key

Description

Internal moves between two addresses of one exchange are left out. coverageFrom = first hour with data (earlier flows are unknown, not zero).

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 /exchange-flows
Parameter	Description
`hours`integer	Window in hours, default 24, clamped to 1–2160 and to the plan history.1–2160 · default 24
`exchange`string	Only this exchange, e.g. Binance (optional).
`asset`string	Only this asset family, e.g. BTC, ETH, USDT, USDC (optional).

Response fields

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

Response fields of /exchange-flows
Field	Description
`windowHours`integer	Window in hours.
`since`string (ISO 8601)	Start of the window (full hour).
`rows[]`array of objects	The rows of this view.
`rows[].exchange`string	Exchange name (as labelled from its own proof-of-reserves addresses).
`rows[].asset`string	Asset symbol (stablecoins, ETH, BTC …).
`rows[].chains[]`array of string	Chains involved.
`rows[].inUsd`number	Inflow (USD).
`rows[].outUsd`number	Outflow (USD).
`rows[].netUsd`number	In − out (USD).
`rows[].inAmount`number	Units of the asset that flowed in (priced and unpriced).
`rows[].outAmount`number	Units of the asset that flowed out.
`rows[].inCount`integer	Transfers in.
`rows[].outCount`integer	Transfers out.
`rows[].unpricedInCount`integer	Transfers in without a fresh price (not in any USD figure).
`rows[].unpricedOutCount`integer	Transfers out without a fresh price.
`rows[].unpricedInAmount`number	Units of the unpriced inflows.
`rows[].unpricedOutAmount`number	Units of the unpriced outflows.
`byExchange[]`array of objects	Totals per exchange over all assets (priced transfers only).
`byExchange[].exchange`string	Exchange name (as labelled from its own proof-of-reserves addresses).
`byExchange[].inUsd`number	Inflow (USD).
`byExchange[].outUsd`number	Outflow (USD).
`byExchange[].netUsd`number	In − out (USD).
`coverageFrom`string (ISO 8601) · nullable	First hour with data.
`updatedAt`string (ISO 8601) · nullable	Latest hour with data.

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

Request

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

Example response

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

{
  "data": {
    "windowHours": 24,
    "since": "2026-10-26T13:00:00.000Z",
    "rows": [
      {
        "exchange": "Binance",
        "asset": "BTC",
        "chains": [
          "bitcoin",
          "ethereum"
        ],
        "inUsd": 792332203.07,
        "outUsd": 1437054542.99,
        "inAmount": 9902.49893212,
        "outAmount": 18013.6408404,
        "inCount": 104,
        "outCount": 103,
        "unpricedInCount": 0,
        "unpricedOutCount": 0,
        "unpricedInAmount": 0,
        "unpricedOutAmount": 0,
        "netUsd": -644722339.93
      },
      {
        "exchange": "Binance",
        "asset": "USDC",
        "chains": [
          "arbitrum",
          "base"
        ],
        "inUsd": 878273639.87,
        "outUsd": 837616419.36,
        "inAmount": 878546014.508,
        "outAmount": 837853633.855,
        "inCount": 8093,
        "outCount": 5694,
        "unpricedInCount": 0,
        "unpricedOutCount": 0,
        "unpricedInAmount": 0,
        "unpricedOutAmount": 0,
        "netUsd": 40657220.51
      }
    ],
    "byExchange": [
      {
        "exchange": "Binance",
        "inUsd": 2591399030.16,
        "outUsd": 3290579582.33,
        "netUsd": -699180552.17
      }
    ],
    "coverageFrom": "2026-10-23T17:00:00.000Z",
    "updatedAt": "2026-10-27T13:00:00.000Z"
  },
  "meta": {
    "updatedAt": "2026-10-27T13:00:00.000Z",
    "source": "onchain-rpc,mempool,cex_por",
    "sources": [
      "cex_por",
      "publicnode"
    ],
    "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"
    }
  }
}

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

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

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.