Staking indices

What is this endpoint for?

This endpoint is used for staking indices, which are custom products whose value is derived from a combination of price data and yield data. The underlying quantity increases daily according to the APR of the asset, and the index value is obtained by multiplying the quantity by the asset price.

Endpoints

gRPC

gateway-v0-grpc.kaiko.ovh

http

gateway-v0-http.kaiko.ovh

API (testing)

https://gateway-v0-http.kaiko.ovh/api/stream/staking_rates_v1

Parameters

Parameter	Description	Examples
index_code	The ticker of the staking rate	KAIKO_STK_ETHUSD_LDNLF

Fields

Field	Description
indexCode	The ticker identifying the staking index.
commodity	The publication type.
interval	A nested object containing the requested time interval.
startTime	The start time of the interval.
endTime	The end time of the interval.
composition	A nested object containing the inputs used to calculate the index price.
quantity	A nested object containing the quantity inputs.
value	The quantity used in the index calculation.
baseQuantity	The base quantity used to derive quantity.value.
utilizationRate	The utilization rate used in the quantity calculation.
underlyingPrice	A nested object containing the underlying price input.
name	The name of the price series used as the underlying price.
price	The underlying asset price used in the calculation.
tsEvent	The publication timestamp of the underlying price.
apr	A nested object containing the APR input.
name	The name of the APR series used in the calculation.
value	The APR value used in the calculation.
forwardFilled	Indicates whether the APR value was forward-filled.
tsEvent	The publication timestamp of the APR value.
price	The calculated staking index price.
tsEvent	The exact time of the publication.

Request examples

Python

Make sure to read our Python quick-start guide before starting.

 # This is a code example. Configure your parameters below #

from __future__ import print_function

import logging
import os

import grpc

from google.protobuf.json_format import MessageToJson

from kaikosdk import sdk_pb2_grpc
from kaikosdk.stream.staking_rates_v1 import request_pb2 as pb_staking_rates


def staking_rates_v1_request(channel: grpc.Channel):
    try:
        with channel:
            stub = sdk_pb2_grpc.StreamStakingRatesServiceV1Stub(channel)

            responses = stub.Subscribe(pb_staking_rates.StreamStakingRatesServiceRequestV1(
                index_code="KK_STK_ETHUSD_LDNLF"
            ))

            for response in responses:
                print("Received message %s" % (MessageToJson(response, including_default_value_fields=True)))

    except grpc.RpcError as e:
        print(e.details(), e.code())


def run():
    credentials = grpc.ssl_channel_credentials(root_certificates=None)
    call_credentials = grpc.access_token_call_credentials(os.environ['KAIKO_API_KEY'])
    composite_credentials = grpc.composite_channel_credentials(credentials, call_credentials)
    channel = grpc.secure_channel('gateway-v0-grpc.kaiko.ovh', composite_credentials)

    staking_rates_v1_request(channel)


if __name__ == '__main__':
    logging.basicConfig()
    run()

Python (Replay)

# This is a code example. Configure your parameters below #

from __future__ import print_function

from datetime import datetime, timedelta
import logging
import os

from google.protobuf.timestamp_pb2 import Timestamp
import grpc

from google.protobuf.json_format import MessageToJson

from kaikosdk import sdk_pb2_grpc
from kaikosdk.stream.staking_rates_v1 import request_pb2 as pb_staking_rates


def staking_rates_v1_request(channel: grpc.Channel):
    try:
        # start of date configuration #
        start = Timestamp()
        start.FromDatetime(datetime.utcnow() - timedelta(days=3))
        end = Timestamp()
        end.FromDatetime(datetime.utcnow())
        # end of date configuration #

        stub = sdk_pb2_grpc.StreamStakingRatesServiceV1Stub(channel)

        responses = stub.Subscribe(pb_staking_rates.StreamStakingRatesServiceRequestV1(
            index_code="KK_STK_ETHUSD_LDNLF",
            interval={
                'start_time': start,
                'end_time': end
            }
        ))

        for response in responses:
            print("Received message %s" % (MessageToJson(response, including_default_value_fields=True)))

    except grpc.RpcError as e:
        print(e.details(), e.code())


def run():
    credentials = grpc.ssl_channel_credentials(root_certificates=None)
    call_credentials = grpc.access_token_call_credentials(os.environ['KAIKO_API_KEY'])
    composite_credentials = grpc.composite_channel_credentials(credentials, call_credentials)
    channel = grpc.secure_channel('gateway-v0-grpc.kaiko.ovh', composite_credentials)

    staking_rates_v1_request(channel)


if __name__ == '__main__':
    logging.basicConfig()
    run()

cURL (Replay)

cURL requests are intended for testing purposes only.

curl -X POST "https://gateway-v0-http.kaiko.ovh/api/stream/staking_rates_v1" -H  "accept: application/json" -H  "X-Api-Key: $MARKET_DATA_API_KEY" -H  "Content-Type: application/json" -d '{  "indexCode": "KK_STK_ETHUSD_LDNLF", "interval": { "startTime": "2026-04-21T11:00:00Z", "endTime": "2026-04-24T22:00:00Z" } }'

Response Example

{
	"result": {
		"indexCode": "KK_STK_ETHUSD_LDNLF",
		"commodity": "SIC_DAILY_FIXING",
		"interval": {
			"startTime": "2026-04-22T14:00:00Z",
			"endTime": "2026-04-22T15:00:00Z"
		},
		"composition": {
			"quantity": {
				"value": 0.035460005259701076,
				"baseQuantity": 0.03544209350535485,
				"utilizationRate": 0.42
			},
			"underlyingPrice": {
				"name": "KK_RFR_ETHUSD_LDNLF",
				"price": 2405.6083636363633,
				"tsEvent": "2026-04-22T15:00:02.190418795Z"
			},
			"apr": {
				"name": "eth-apr-2-d",
				"value": 0.0276,
				"forwardFilled": true,
				"tsEvent": "2026-04-21T00:00:00Z"
			}
		},
		"price": 85.30288522732634,
		"tsEvent": "2026-04-22T15:00:05.029978898Z"
	}
}