Open Interest API Endpoint — Outstanding Total Contracts Open

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://api.hyblockcapital.com/oauth2/token

Scopes:

all-Access to all resources

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

or

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://api.hyblockcapital.com/v2/openInterest?coin=BTC&exchange=binance_perp_stable&timeframe=1m&limit=50&startTime=1780272000&endTime=1780358400&sort=asc&marketTypes=all&advanceFilter=none' \
--header 'x-api-key: <api-key>'

Responses

🟢200OK

application/json

Request was successful

Bodyapplication/json

Example

{
    "data": [
        {
            "close": 3297517559.4792995,
            "high": 3297517559.4792995,
            "low": 3297517559.4792995,
            "open": 3298101915.6755,
            "openDate": 1665047820
        }
    ],
    "metadata": {
        "exchanges": [
            "bitmex_perp_coin",
            "bybit_perp_coin",
            "bitfinex_perp_stable",
            "deribit_perp_stable",
            "phemex_perp_stable",
            "huobi_perp_coin",
            "okx_perp_coin",
            "okx_qtrly",
            "binance_perp_stable",
            "binance_perp_coin",
            "bybit_perp_stable",
            "bitget_perp_stable",
            "bitget_perp_coin",
            "okx_perp_stable",
            "hyperliquid_perp_stable",
            "hyperliquid_xyz",
            "lighter_perp_stable"
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

🟠429Too Many Requests

🔴500Internal Server Error