Subscribe

How to configure a Kaiko Reference Rates [Beta].

What is this endpoint for?

This service is for any Reference Rates from an asset class that is not crypto.

Endpoint

gRPC

gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService/StreamIndex

Request parameters

Parameter	Description	Examples
index_codes	The Kaiko Reference Rate ticker. You can find a full list of our tickers here.	KK_RFR_AAPLUSD

Requesting multiple tickers at the same time To configure multiple tickers in the same stream, provide the indexCode as a comma-separated list, e.g. ["KK_RFR_AAPLUSD", "KK_RFR_TSLAUSD"] . Note: if subscribing to an equity Reference Rate, users should also subscribe to the corporate action reference data.

Response fields

Field	Description
indexCode	The ticker identifying the rate.
commodity	The type of publication. Either real-time or fixings
interval	The time period in which transaction data are considered for the calculation of the rate. If a rate's calculation methodology has an interval of 15 seconds, startTime and endTime will be separated by 15s.
quote	The quote asset used for the rate denomination.
bases	The list of base assets included in the rate and their weight. For reference rates, this will always be a single asset.
exchanges	The exchanges involved in the computation. This list may change every quarter during the rebalancing period and depending on the new results of the Kaiko Exchange Ranking.
percentages	The different distribution levels included in the price computation.
price	The value of the rate in the quote denomination.
pairs	The list of pairs combined with additional details included in the computation.
sessionDetector	The status of market session (in Central Standard Time): INDEX_SESSION_DETECTOR_EARLY_HOURS : 4:00AM - 9:30AM INDEX_SESSION_DETECTOR_REGULAR_HOURS : 9:30AM - 4:00PM INDEX_SESSION_DETECTOR_LATE_HOURS : 4:00PM - 8:00PM INDEX_SESSION_DETECTOR_OVERNIGHT : 8:00PM - 4:00AM INDEX_SESSION_DETECTOR_CLOSED_HOURS : For weekend and holidays, last trading day 8:00PM - the day prior to the next trading day 8:00PM
tsEvent	The exact time of price publication.

Request examples

cURL

cURL requests are intended for testing purposes only.

grpcurl -H "Authorization: Bearer your_api_key" -d '{"index_codes": ["KK_RFR_AAPLUSD"], "commodities": []}' gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService/StreamIndex

Response Example

{
  "index": {
    "indexCode": "KK_RFR_AAPLUSD",
    "commodity": "INDEX_COMMODITY_REAL_TIME",
    "interval": {
      "startTime": "2026-01-30T16:01:44Z",
      "endTime": "2026-01-30T16:01:59Z"
    },
    "quote": "usd",
    "bases": [
      {
        "asset": "aapl",
        "weight": 1
      }
    ],
    "exchanges": [
      "nutp",
      "boat",
      "xcta"
    ],
    "percentages": [
      {
        "percentage": 1,
        "price": 254.8586666666667,
        "pairs": [
          {
            "pair": "aapl-usd",
            "weight": 1,
            "instruments": [
              {
                "partition": "0",
                "price": 254.89666666666668,
                "volume": 12750,
                "count": "58",
                "underlyingTrade": {
                  "volume": 300,
                  "exchange": "nutp",
                  "id": "019c0fa3-9a36-77b9-9c7f-c0e79be94469",
                  "datetime": "2026-01-30T16:01:46.025693Z"
                }
              },
              {
                "partition": "1",
                "price": 254.895,
                "volume": 15200,
                "count": "67",
                "underlyingTrade": {
                  "volume": 100,
                  "exchange": "nutp",
                  "id": "019c0fa3-a222-78ef-a733-3cd1a4cbab76",
                  "datetime": "2026-01-30T16:01:48.054573Z"
                }
              },
              {
                "partition": "2",
                "price": 254.81,
                "volume": 22500,
                "count": "101",
                "underlyingTrade": {
                  "volume": 150,
                  "exchange": "nutp",
                  "id": "019c0fa3-b17b-7fde-9591-ea858d3ad2c0",
                  "datetime": "2026-01-30T16:01:51.980566Z"
                }
              },
              {
                "partition": "4",
                "price": 254.85666666666665,
                "volume": 150,
                "count": "1",
                "underlyingTrade": {
                  "volume": 150,
                  "exchange": "nutp",
                  "id": "019c0fa3-c4c0-7b73-b83b-88385d9e9f89",
                  "datetime": "2026-01-30T16:01:56.915Z"
                }
              },
              {
                "partition": "3",
                "price": 254.87,
                "volume": 3000,
                "count": "17",
                "underlyingTrade": {
                  "volume": 150,
                  "exchange": "nutp",
                  "id": "019c0fa3-ba8f-7ad3-890a-525d3eade5ea",
                  "datetime": "2026-01-30T16:01:54.303Z"
                }
              }
            ]
          }
        ]
      }
    ],
    "sessionDetector": "INDEX_SESSION_DETECTOR_REGULAR_HOURS",
    "tsEvent": "2026-01-30T16:01:59.085746807Z",
    "sequenceId": "d5udbtrpd0uc72rjbjf0",
    "lastIngestTime": "2026-01-30T16:01:58.545644421Z"
  }
}