Open Interest history (aggregated)

GET 
/api/v1/open-interest/history-aggregated

Historical Open Interest time series for a single token, broken down per exchange and aggregated to a fixed bucket (avg within bucket). The default lookback depends on the requested interval — 7 days for 1h, 30 days for 4h, 1 year for 1d — so callers don't have to hand-tune from/to for typical queries. The response also includes token metadata (icon, symbol, name) so a single call paints the whole header strip.

Request

Query Parameters

token_id stringrequired

Token id

interval string
Possible values: [5m, 15m, 1h, 4h, 1d]
Aggregation interval
Default value: 1h
from integer

Start unix-ms (default: depends on interval — 7d for 1h, 30d for 4h, 1y for 1d)

to integer

End unix-ms (default: now)

Header Parameters

X-DTMX-APIKEY stringrequired

Your DataMaxi+ API key

Responses

200

OK

application/json

Schema

Schema

data

object

Data is keyed by exchange id → time-series points ordered by t asc.

property name*

object[]

Array [

oi number

oiUsd number

t integer

]

exchange_url

object

property name* string

token

object

cmc_id string

specifies cmc id of the token

icon string

specifies the token icon url path

id string

specifies the unique id

name string

specifies the name of token

symbol string

specifies the token symbol

Example (from schema)

{
  "data": {},
  "exchange_url": {},
  "token": {
    "cmc_id": "string",
    "icon": "string",
    "id": "string",
    "name": "string",
    "symbol": "string"
  }
}

400

Bad Request

application/json

Schema

Schema

error string

error specifies the error message

Example (from schema)

{
  "error": "string"
}

Loading...