Reference data

What is this endpoint for?

This endpoint returns a list of all our Reference Rates for the following asset classes:

• Equity

• Fixed income

• Foreign exchange

• Commodities

• Real estate

• Digital assets

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

Endpoint

gateway.equ.kaiko.io:443 kaiko.equities.EquitiesService.ReferenceData

Query parameters

Parameter	Required	Description	Example
tickers	No	Array of tickers identifying the rate	["KK_RFR_AAPLUSD", "KK_RFR_TSLAUSD"]
base_asset_codes	No	Array of base asset codes	["aapl", "tsla"]
base_asset_classes	No	Array of base asset classes	["Equity", "ETF", "Commodities", "Foreign Exchange"]
base_asset_isins	No	Array of base asset isin codes	["US0378331005"]
quote_asset_codes	No	Array of quote asset codes	["usd", "hkd"]
timezones	No	Array of IANA timezones	["America/New_York", "Asia/Seoul"]

Response Fields

Field	Description
indexCode	The ticker of the rate.
rateName	Extensive name format of the rate issued
pair	Short name format of the rate issued
exchanges	The exchanges involved in the computation.
baseAsset
.assetCode	The asset code of base asset
.name	Full name of the base asset
.isin	The ISIN code of the base asset
.bbgCompId	The issuer ID on Bloomberg
.timezone	IANA timezone of the main trading venue
.taxonomy
.taxonomyVersion	Kaiko Taxonomy version
.kaikoTaxonomyCode	Kaiko Taxonomy code
.assetClass	The asset class of base asset
.instrumentType	The instrument type of base asset
.marketPhase	The Market Phase of base asset
.marketVenue	The Market Venue of base asset
.geoRegion	The main trading region of base asset
.geoCountry	The main trading country of base asset
quoteAsset
.assetCode	The asset code of quote asset
.name	Full name of the quote asset
dissemination	Frequency of publication of the rate
timezone	IANA timezone of the dissemination
launchDate	Date when the rate was launched and entered into production.
exposition	"Public" : Indicates that it is open reference data accessible to all users.
streamEndpoint	The name of method for subscription
methodology	The applied calculation methodology section in rulebook
assetCalendar	The applied market calendar.

Request example

cURL

grpcurl \
  -d '{
    "tickers":            ["KK_RFR_AAPLUSD", "KK_RFR_700HKD"],
    "base_asset_codes":   ["aapl", "700"],
    "base_asset_classes": ["equity", "etf"],
    "base_asset_isins":   ["US0378331005", "KYG875721634"],
    "quote_asset_codes":  ["usd", "hkd"],
    "timezones":          ["America/New_York", "Asia/Hong_Kong"]
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService.ReferenceData

Response example

JSON

{
  "entries": [
    {
      "indexCode": "KK_RFR_700HKD",
      "rateName": "Kaiko TENCENT HKD Equity Reference Rate",
      "pair": "700-HKD",
      "exchanges": [
        "xhkg"
      ],
      "baseAsset": {
        "assetCode": "700",
        "name": "TENCENT",
        "isin": "KYG875721634",
        "bbgCompId": "BBG000BJ35F4",
        "timezone": "Asia/Hong_Kong",
        "taxonomy": {
          "taxonomyVersion": "1.0",
          "kaikoTaxonomyCode": "EQ.STK.SPOT.XCHG.HK",
          "assetClass": "Equity",
          "instrumentType": "Stock",
          "marketPhase": "Spot",
          "marketVenue": "Exchange",
          "geoRegion": "Asia-Pacific",
          "geoCountry": "HK"
        }
      },
      "quoteAsset": {
        "assetCode": "hkd",
        "name": "Hong Kong Dollar"
      },
      "dissemination": "Real-time",
      "timezone": "Asia/Hong_Kong",
      "launchDate": "2026-03-25",
      "exposition": "Public",
      "streamEndpoint": "/StreamIndex",
      "methodology": "3.1.1",
      "assetCalendar": "equities"
    },
    {
      "indexCode": "KK_RFR_AAPLUSD",
      "rateName": "Kaiko Apple USD Equity Reference Rate",
      "pair": "AAPL-USD",
      "exchanges": [
        "nutp",
        "xcta",
        "boat"
      ],
      "baseAsset": {
        "assetCode": "aapl",
        "name": "Apple",
        "isin": "US0378331005",
        "bbgCompId": "BBG000B9XRY4",
        "timezone": "America/New_York",
        "taxonomy": {
          "taxonomyVersion": "1.0",
          "kaikoTaxonomyCode": "EQ.STK.SPOT.XCHG.US",
          "assetClass": "Equity",
          "instrumentType": "Stock",
          "marketPhase": "Spot",
          "marketVenue": "Exchange",
          "geoRegion": "Americas",
          "geoCountry": "US"
        }
      },
      "quoteAsset": {
        "assetCode": "usd",
        "name": "US Dollar"
      },
      "dissemination": "Real-time",
      "timezone": "America/New_York",
      "launchDate": "2026-01-01",
      "exposition": "Public",
      "streamEndpoint": "/StreamIndex",
      "methodology": "3.1.1",
      "assetCalendar": "equities"
    }
  ]
}