Contents

Cross-venue funding spreads

Cross-venue funding spread per coin: the venue with the highest and the lowest annualised funding (current rates or predicted next rates), the spread per year and per day and the smaller open interest of the two legs.

GET/api/v1/funding/spreadsEvery key

Description

A difference between published rates, not an executable return (fees, price moves, funding times). Licence review: a spread involving Binance / Bybit is listed only when at least 3 venues quote the coin and both ends are exchanges whose rates are withheld (a published rate at one end plus the spread would give the other exchange’s rate); such legs keep their venue, their own fundingApr and openInterestUsd are null (meta.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 /funding/spreads
Parameter	Description
`coin`string	Only this coin (optional).
`basis`string	current (default) \| predicted.one of current, predicted · default current
`minOiUsd`number	Minimum open interest of the thinner leg in USD, default 0.≥ 0 · default 0
`limit`integer	Number of items, default 100, clamped to 1–500.1–500 · default 100
`fields`string	Comma-separated fields of every item to return, e.g. coin,high,low,spreadApr (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/spreads
Field	Description
`[].coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`[].basis`"current" \| "predicted"	current = published rates now, predicted = predicted next rates.
`[].high`object	-
`[].high.venue`"hyperliquid" \| "lighter" \| "binance" \| "bybit" \| "okx"	Trading venue.
`[].high.fundingApr`number · nullable	Annualised funding, fraction; null for an exchange whose raw rates are withheld during the licence review (meta.restricted).
`[].high.intervalHours`number · nullable	Funding interval in hours (null when unknown).
`[].high.openInterestUsd`number · nullable	Open interest on this venue; null when unknown or withheld (USD).
`[].low`object	-
`[].low.venue`"hyperliquid" \| "lighter" \| "binance" \| "bybit" \| "okx"	Trading venue.
`[].low.fundingApr`number · nullable	Annualised funding, fraction; null for an exchange whose raw rates are withheld during the licence review (meta.restricted).
`[].low.intervalHours`number · nullable	Funding interval in hours (null when unknown).
`[].low.openInterestUsd`number · nullable	Open interest on this venue; null when unknown or withheld (USD).
`[].spreadApr`number	high − low, annualised fraction.
`[].spreadDaily`number	Spread per day (spreadApr / 365), fraction.
`[].minOpenInterestUsd`number · nullable	Smaller open interest of the two legs; null when a leg is withheld (USD).
`[].venues`integer	Venues with a rate for this coin.
`[].updatedAt`string (ISO 8601)	Newest data time of this item (ISO 8601 UTC).

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 spread (how it is computed and its limits)

Request

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

Example response

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

{
  "data": [
    {
      "coin": "BTW",
      "basis": "current",
      "high": {
        "venue": "bybit",
        "fundingApr": null,
        "intervalHours": null,
        "openInterestUsd": null
      },
      "low": {
        "venue": "binance",
        "fundingApr": null,
        "intervalHours": null,
        "openInterestUsd": null
      },
      "spreadApr": 0.6816156,
      "spreadDaily": 0.00186744,
      "minOpenInterestUsd": null,
      "venues": 2,
      "updatedAt": "2026-10-27T13:11:50.718Z"
    },
    {
      "coin": "JCT",
      "basis": "current",
      "high": {
        "venue": "binance",
        "fundingApr": null,
        "intervalHours": null,
        "openInterestUsd": null
      },
      "low": {
        "venue": "bybit",
        "fundingApr": null,
        "intervalHours": null,
        "openInterestUsd": null
      },
      "spreadApr": 0.3818703,
      "spreadDaily": 0.00104622,
      "minOpenInterestUsd": null,
      "venues": 2,
      "updatedAt": "2026-10-27T13:11:50.718Z"
    }
  ],
  "meta": {
    "updatedAt": "2026-10-27T13:11:50.718Z",
    "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 fundingSpreads() / funding_spreads()

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.