# Subscribe

## What is this endpoint for? <a href="#what-is-this-endpoint-for" id="what-is-this-endpoint-for"></a>

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

## Endpoint

{% tabs %}
{% tab title="gRPC" %}

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

{% endtab %}
{% endtabs %}

## Request parameters

<table><thead><tr><th width="184">Parameter</th><th width="400">Description</th><th>Examples</th></tr></thead><tbody><tr><td><code>index_codes</code></td><td>The Kaiko Reference Rate ticker. You can find a full list of our tickers <a href="https://www.kaiko.com/indices/reference-rates#table">here</a>.</td><td><code>KK_RFR_AAPLUSD</code></td></tr></tbody></table>

{% hint style="info" %}
**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](https://docs.kaiko.com/kaiko-indices/reference-rates-others/subscribe/corporate-action-reference-data).
{% endhint %}

## Response fields

<table><thead><tr><th width="210">Field</th><th width="537">Description</th></tr></thead><tbody><tr><td><code>indexCode</code></td><td>The ticker identifying the rate.</td></tr><tr><td><code>commodity</code></td><td>The type of publication. Either real-time or fixings</td></tr><tr><td><code>interval</code></td><td>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, <code>startTime</code> and <code>endTime</code> will be separated by <code>15s</code>.</td></tr><tr><td><code>quote</code></td><td>The quote asset used for the rate denomination.</td></tr><tr><td><code>bases</code></td><td>The list of base assets included in the rate and their weight. For reference rates, this will always be a single asset. </td></tr><tr><td><code>exchanges</code></td><td>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.</td></tr><tr><td><code>percentages</code></td><td>The different distribution levels included in the price computation.</td></tr><tr><td><code>price</code></td><td>The value of the rate in the quote denomination.</td></tr><tr><td><code>pairs</code></td><td>The list of pairs combined with additional details included in the computation.</td></tr><tr><td><code>sessionDetector</code></td><td><p>The status of market session for US (in Eastern Time):   </p><ul><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_EARLY_HOURS</code></mark> : 4:00AM - 9:30AM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_REGULAR_HOURS</code></mark> <mark style="color:$primary;">:</mark> 9:30AM - 4:00PM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_LATE_HOURS</code></mark> : 4:00PM - 8:00PM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_OVERNIGHT</code></mark> <mark style="color:$primary;">:</mark> 8:00PM - 4:00AM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_CLOSED_HOURS</code></mark> <mark style="color:$primary;">:</mark> For weekend and holidays, last trading day 8:00PM - the day prior to the next trading day 8:00PM</li></ul><p>The status of market session for Hong Kong (in Hong Kong Time):</p><ul><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_REGULAR_HOURS</code></mark> <mark style="color:$primary;">:</mark> 9:30AM - 12:00PM, 1PM - 4PM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_CLOSED_HOURS</code></mark> <mark style="color:$primary;">:</mark> 12:00PM - 1:00 PM, 4PM - 9:30AM next day</li></ul><p>The status of market session for Korea (in Korea Standard Time):</p><ul><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_REGULAR_HOURS</code></mark> <mark style="color:$primary;">:</mark> 9:00AM - 15:20PM</li><li><mark style="color:blue;"><code>INDEX_SESSION_DETECTOR_CLOSED_HOURS</code></mark> <mark style="color:$primary;">:</mark> 15:20PM - 9:00AM next day</li></ul></td></tr><tr><td><code>tsEvent</code></td><td>The exact time of price publication.</td></tr></tbody></table>

## Request examples

{% tabs %}
{% tab title="cURL" %}
**cURL requests are intended for testing purposes only.**

{% code overflow="wrap" %}

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

{% endcode %}
{% endtab %}
{% endtabs %}

## Response Example

```json
{
  "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"
  }
}
```