Composition data

What is this endpoint for?

This endpoint retrieves the historical compositions of our Reference Rates, determined by our periodic rate rebalances. You can learn more about our Reference Rates here.

Endpoint

https://us.market-api.kaiko.io/v2/data/index.v1/digital_asset_rates_compo

Request parameters

Parameter
Required
Description
Example

index_code

Yes

The desired rate

KK_BRR_BTCUSD

start_time

No

Starting time in ISO 8601 (inclusive).

2023-01-25T00:00:00.000Z

end_time

No

Ending time in ISO 8601 (exclusive).

2023-04-25T00:00:00.000Z

Response Fields

Field
Description

index_code

The ticker of the rate

start_period

Start of the composition period

end_period

End of the composition period

exchanges

Exchanges used during the composition period **

window_seconds

Calculation window in seconds for the period

partition_seconds

Partition size in seconds for the period

result

Status of the query

** These are the exchanges that constitute the eligible universe of trading venues for the queried rate and time.

For each publication of a rate, the methodology will use trade data from these source exchanges based on actual trading activity.

Being listed as a source exchange does not guarantee that trades from exchange will be included in any given rate calculation. For the specific exchanges used for each publication, use the replication data endpoint.

Request example

curl -H "X-Api-Key: $KAIKO_API_KEY" \
     -H 'Accept: application/json' \
    "https://us.market-api.kaiko.io/v2/data/index.v1/digital_asset_rates_compo?index_code=KK_BRR_BTCUSD&start_time=2025-06-01T00:00:00Z"

Response example

{
  "query": {
    "data_version": "v1",
    "request_time": "2025-09-22T12:39:25.097Z",
    "start_time": "2025-02-01T00:00:00Z",
    "end_time": "2025-04-01T00:00:00Z"
  },
  "time": "2025-09-22T12:39:25.107Z",
  "timestamp": 1758544765107,
  "data": [
    {
      "index_code": "KK_BRR_BTCUSD",
      "start_period": "2025-03-24T21:04:22.523Z",
      "end_period": "2025-06-23T21:06:13.244716Z",
      "exchanges": [
        "cbse",
        "gmni",
        "krkn",
        "lmax",
        "stmp"
      ],
      "window_seconds": 15,
      "partition_seconds": 3
    },
    {
      "index_code": "KK_BRR_BTCUSD",
      "start_period": "2025-01-07T22:00:58.271494Z",
      "end_period": "2025-03-24T21:29:22.526544Z",
      "exchanges": [
        "cbse",
        "gmni",
        "krkn",
        "lmax",
        "stmp"
      ],
      "window_seconds": 15,
      "partition_seconds": 3
    },
    {
      "index_code": "KK_BRR_ETHUSD",
      "start_period": "2025-03-24T21:04:22.523Z",
      "end_period": "2025-06-23T21:06:13.244716Z",
      "exchanges": [
        "cbse",
        "crco",
        "krkn",
        "lmax",
        "stmp"
      ],
      "window_seconds": 15,
      "partition_seconds": 3
    },
    {
      "index_code": "KK_BRR_ETHUSD",
      "start_period": "2025-01-07T22:00:58.271494Z",
      "end_period": "2025-03-24T21:29:22.526544Z",
      "exchanges": [
        "cbse",
        "crco",
        "krkn",
        "lmax",
        "stmp"
      ],
      "window_seconds": 15,
      "partition_seconds": 3
    }
  ],
  "result": "success"
}

Last updated

Was this helpful?