GET /v1/open-interest

Retrieve open interest data from derivatives exchanges and prediction markets.

Min Tier: Free | Credits: 50 base + 3 per row returned

Parameters

Response

Response Headers

Example

Send your API key in the X-API-Key header (recommended) or as the api-key query parameter. Examples below use the header.

import requests

resp = requests.get(
    "https://kwery-api.com/v1/open-interest",
    headers={"X-API-Key": "YOUR_KEY"},
    params={
        "symbol": "BTC",
        "source": "binance_futures",
        "interval": "4h",
        "start": "2026-03-07T00:00:00Z",
        "end": "2026-03-08T00:00:00Z",
    },
)
data = resp.json()

Query parameter alternative: Add api-key=YOUR_KEY to the URL for quick tests; the header is recommended for production.

Example Response

{
  "data": [
    {
      "timestamp": "2026-03-07T00:00:00Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "interval": "4h",
      "open_interest": 52340.80,
      "open_interest_usd": 4938475200.00
    },
    {
      "timestamp": "2026-03-07T04:00:00Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "interval": "4h",
      "open_interest": 53100.20,
      "open_interest_usd": 5015118900.00
    },
    {
      "timestamp": "2026-03-07T08:00:00Z",
      "symbol": "BTC",
      "source": "binance_futures",
      "interval": "4h",
      "open_interest": 51890.45,
      "open_interest_usd": 4896523050.00
    }
  ],
  "meta": {
    "symbol": "BTC",
    "source": "binance_futures",
    "interval": "4h",
    "returned": 6,
    "next_cursor": null,
    "has_more": false
  }
}

Source-Specific Behavior

Binance Futures — open_interest is in the base asset (e.g. BTC). open_interest_usd is computed using the mark price at the snapshot time.

Hyperliquid — open_interest is in the base asset. open_interest_usd is derived from the Hyperliquid mark price.

Kalshi — open_interest is the number of open contracts. open_interest_usd is the notional value (contracts × $1 max payout). Useful for gauging prediction market conviction alongside probability.

Tier Access

Errors