Contents

Cross-venue funding board

Cross-venue funding board: one row per coin with funding of every venue, APR spread between venues and the largest absolute APR of the venues shown.

GET/api/v1/fundingEvery key

Description

Sorted by Hyperliquid open interest. Licence review: raw rows of Binance and Bybit (single liquidations, prints, order books, tickers, funding and ratios per exchange, exchange candles) are not redistributed through the API while the review of their terms is pending. Asking for such a venue answers 403 source_restricted, and meta.restricted lists the withheld venues. Aggregates (sums over venues, our own figures) stay. aprSpread is then null unless at least 3 venues quote the coin and neither end of the spread is a rate shown here (otherwise it would give an exchange's own rate).

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 /funding
Parameter	Description
`coin`string	Only this coin (optional).
`limit`integer	Number of items, default 500, clamped to 1–500.1–500 · default 500
`fields`string	Comma-separated fields of every item to return, e.g. coin,aprSpread,maxAbsApr (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 /funding
Field	Description
`[].coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`[].hlOpenInterestUsd`number · nullable	Hyperliquid open interest (sort key) (USD).
`[].byVenue`object	Funding per venue; venues without the coin are missing.
`[].byVenue.hyperliquid`object	-
`[].byVenue.hyperliquid.fundingHourly`number · nullable	Hourly funding rate, fraction.
`[].byVenue.hyperliquid.fundingApr`number · nullable	Annualised funding, fraction.
`[].byVenue.hyperliquid.openInterestUsd`number · nullable	Open interest (USD).
`[].byVenue.hyperliquid.mark`number · nullable	Mark price.
`[].byVenue.hyperliquid.updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).
`[].byVenue.lighter`object	-
`[].byVenue.lighter.fundingHourly`number · nullable	Hourly funding rate, fraction.
`[].byVenue.lighter.fundingApr`number · nullable	Annualised funding, fraction.
`[].byVenue.lighter.openInterestUsd`number · nullable	Open interest (USD).
`[].byVenue.lighter.mark`number · nullable	Mark price.
`[].byVenue.lighter.updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).
`[].byVenue.binance`object	-
`[].byVenue.binance.fundingHourly`number · nullable	Hourly funding rate, fraction.
`[].byVenue.binance.fundingApr`number · nullable	Annualised funding, fraction.
`[].byVenue.binance.openInterestUsd`number · nullable	Open interest (USD).
`[].byVenue.binance.mark`number · nullable	Mark price.
`[].byVenue.binance.updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).
`[].byVenue.bybit`object	-
`[].byVenue.bybit.fundingHourly`number · nullable	Hourly funding rate, fraction.
`[].byVenue.bybit.fundingApr`number · nullable	Annualised funding, fraction.
`[].byVenue.bybit.openInterestUsd`number · nullable	Open interest (USD).
`[].byVenue.bybit.mark`number · nullable	Mark price.
`[].byVenue.bybit.updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).
`[].byVenue.okx`object	-
`[].byVenue.okx.fundingHourly`number · nullable	Hourly funding rate, fraction.
`[].byVenue.okx.fundingApr`number · nullable	Annualised funding, fraction.
`[].byVenue.okx.openInterestUsd`number · nullable	Open interest (USD).
`[].byVenue.okx.mark`number · nullable	Mark price.
`[].byVenue.okx.updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).
`[].aprSpread`number · nullable	Highest minus lowest annualised funding across every venue that quotes the coin (also withheld exchanges), fraction. null with fewer than two venues, and while exchange rows are withheld also unless at least 3 venues quote the coin and neither end of the spread is a rate shown in byVenue (it would give the rate of one exchange).
`[].maxAbsApr`number · nullable	Largest absolute annualised funding of any venue, fraction.

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

Funding rate (how it is computed and its limits)

Request

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

Example response

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

{
  "data": [
    {
      "coin": "BTC",
      "hlOpenInterestUsd": 3468696429.07,
      "byVenue": {
        "hyperliquid": {
          "fundingHourly": 0.0000125,
          "fundingApr": 0.1095,
          "openInterestUsd": 3468696429.07,
          "mark": 80213,
          "updatedAt": "2026-10-27T13:11:52.327Z"
        }
      },
      "aprSpread": 0,
      "maxAbsApr": 0.1095
    },
    {
      "coin": "ETH",
      "hlOpenInterestUsd": 2602687934.92,
      "byVenue": {
        "hyperliquid": {
          "fundingHourly": 0.0000125,
          "fundingApr": 0.1095,
          "openInterestUsd": 2602687934.92,
          "mark": 2329.29,
          "updatedAt": "2026-10-27T13:11:52.327Z"
        }
      },
      "aprSpread": 0.053655,
      "maxAbsApr": 0.1095
    }
  ],
  "meta": {
    "updatedAt": "2026-10-27T13:11:52.327Z",
    "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"
    },
    "restricted": [
      "binance",
      "bybit"
    ]
  }
}

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

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.