Subscribe

What is this endpoint for?

Get a live feed / 7-days replay for any Reference Rate from the following asset classes:

• Equity (unless "instrument type" is "futures")
• Fixed income
• Foreign exchange
• Commodities
• Real estate
• Digital assets

For crypto rates, please see the crypto section of the documentation.

Endpoint

gRPC Stream

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

gRPC Replay

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

Request parameters

Requesting multiple tickers at the same time To configure multiple tickers in the same call, provide the index_codes as a comma-separated list, e.g. ["KK_RFR_AAPLUSD", "KK_RFR_TSLAUSD"] .

Subscribe

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

Replay

Parameter	Description	Examples
index_codes	The list of Kaiko Reference Rate ticker. You can find a full list of our tickers here.	KK_RFR_AAPLUSD
start_time	Start date of exDate in ISO 8601 (exclusive).	2026-04-22T05:04:32.000Z
end_time	Start date of exDate in ISO 8601 (inclusive).	2026-04-22T05:04:33.000Z

Response fields

Field	Description
index_codes	The list of tickers 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.
.startTime	The start time of the data interval
.endTime	The end time of the data interval
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.
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. INDEX_SESSION_DETECTOR_EARLY_HOURS INDEX_SESSION_DETECTOR_REGULAR_HOURS INDEX_SESSION_DETECTOR_LATE_HOURS INDEX_SESSION_DETECTOR_OVERNIGHT INDEX_SESSION_DETECTOR_CLOSED_HOURS Please refer to Market calendar and trading endpoint for daily session schedule.
tsEvent	The exact time of price publication.

Request examples

cURL Stream

cURL requests are intended for testing purposes only.

grpcurl \
  -H "Authorization: Bearer $KAIKO_API_KEY" \
  -d '{
    "index_codes": ["KK_RFR_TSLAUSD"]
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService/StreamIndex

cURL Replay

cURL requests are intended for testing purposes only.

grpcurl \
  -H "Authorization: Bearer $KAIKO_API_KEY" \
  -d '{
    "index_codes": ["KK_RFR_TSLAUSD"],
    "start_time":  "2026-04-27T20:04:32.000Z",
    "end_time":    "2026-04-27T20:04:33.000Z"
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService/ReplayIndex

Response Example

{
  "index": {
    "indexCode": "KK_RFR_TSLAUSD",
    "commodity": "INDEX_COMMODITY_REAL_TIME",
    "interval": {
      "startTime": "2026-04-27T20:04:17Z",
      "endTime": "2026-04-27T20:04:32Z"
    },
    "quote": "usd",
    "bases": [
      {
        "asset": "tsla",
        "weight": 1
      }
    ],
    "exchanges": [
      "nutp",
      "boat",
      "xcta"
    ],
    "percentages": [
      {
        "percentage": 1,
        "price": 378.03249999999997,
        "pairs": [
          {
            "pair": "tsla-usd",
            "weight": 1,
            "instruments": [
              {
                "partition": "2",
                "price": 378.025,
                "volume": 40,
                "count": "1",
                "underlyingTrade": {
                  "volume": 40,
                  "exchange": "nutp",
                  "id": "019dd08b-0635-7077-a949-0c4aa816bedd",
                  "datetime": "2026-04-27T20:04:25.247777Z"
                }
              },
              {
                "partition": "3",
                "price": 378.035,
                "volume": 240,
                "count": "2",
                "underlyingTrade": {
                  "volume": 200,
                  "exchange": "nutp",
                  "id": "019dd08b-0d81-7cd5-914c-5a4c62cdbcb3",
                  "datetime": "2026-04-27T20:04:27.122012Z"
                }
              },
              {
                "partition": "4",
                "price": 378.035,
                "volume": 200,
                "count": "1",
                "underlyingTrade": {
                  "volume": 200,
                  "exchange": "nutp",
                  "id": "019dd08b-1833-7ef6-931e-2ef59a4bcb81",
                  "datetime": "2026-04-27T20:04:29.866528Z"
                }
              }
            ]
          }
        ]
      }
    ],
    "tsEvent": "2026-04-27T20:04:32.346558794Z",
    "sequenceId": "d7ns2k20qd5c72pg0220",
    "lastIngestTime": "2026-04-27T20:04:30.678413576Z"
  },
  "sessionDetector": "INDEX_SESSION_DETECTOR_LATE_HOURS"
}