Skip to main content

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​

OK

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

Loading...