GET /crypto/open-interest - MarketDataset

Endpoint

GET https://api.marketdataset.ai/crypto/open-interest

Open interest (OI) is the total number of outstanding futures contracts. It measures market participation and conviction. Key patterns:

Rising OI + Rising price → Strong uptrend with new money entering
Rising OI + Falling price → Strong downtrend
Falling OI + Rising price → Short squeeze, potentially weak move
Falling OI + Falling price → Profit-taking, trend may be ending

Parameters

Name	Type	Required	Description
`symbol`	string	Yes	Futures symbol, e.g. `BTCUSDT`, `ETHUSDT`
`exchange`	string	No	Exchange (default: `binance`)
`interval`	string	No	`5m`, `1h`, `1d` (default: `1h`)
`start_date`	string	No	ISO 8601 date
`end_date`	string	No	ISO 8601 date
`limit`	integer	No	Records to return (default: `100`, max: `1000`)
`cursor`	string	No	Pagination cursor

Credit cost

$0.010 per request

Example request

curl "https://api.marketdataset.ai/crypto/open-interest?symbol=BTCUSDT&interval=1h&limit=10" \
  -H "X-API-KEY: sk_your_key"

import requests

response = requests.get(
    "https://api.marketdataset.ai/crypto/open-interest",
    params={"symbol": "BTCUSDT", "interval": "1h", "limit": 10},
    headers={"X-API-KEY": "sk_your_key"},
)
print(response.json())

Example response

{
  "open_interest": [
    {
      "symbol": "BTCUSDT",
      "exchange": "binance",
      "interval": "1h",
      "open_interest": 84231.45,
      "open_interest_value": 5743821234.12,
      "timestamp": "2024-11-01T15:00:00+00:00"
    }
  ],
  "next_page_url": null,
  "meta": {
    "request_id": "req_abc123",
    "credits_used": 0.01,
    "credits_remaining": 49.99
  }
}

Fields

Field	Description
`open_interest`	Total open contracts (in base currency, e.g. BTC)
`open_interest_value`	Total open contracts value in USD