Reference Data

What is this endpoint for?

This endpoint retrieves a list of our Capital Market Single-Asset Rates. You can learn more about Kaiko Rates and Indices here.

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	Category to which the rate belongs . i.e . Reference Rate or Benchmark Reference Rate
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
launch_date	Date when the rate was launched and entered into production.
exposition	"Public" : Indicates that it is open reference data accessible to all users.

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_AAPLUSD",
      "rateName": "Kaiko Apple USD Equity Reference Rate",
      "pair": "AAPL-USD",
      "exchanges": [
        "nutp",
        "xcta",
        "boat"
      ],
      "baseAsset": {
        "assetCode": "aapl",
        "assetClass": "Equity",
        "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"
    },
    {
      "indexCode": "KK_RFR_700HKD",
      "rateName": "Kaiko TENCENT HKD Equity Reference Rate",
      "pair": "700-HKD",
      "exchanges": [
        "xhkg"
      ],
      "baseAsset": {
        "assetCode": "700",
        "assetClass": "Equity",
        "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"
    },
  ]
}