FOREX conversion

Convert your USD reference rate into a currency of your choosing.

What is this endpoint for?

This endpoint retrieves a Reference Rate and converts it from USD into a local currency of your choosing using Forex Reference Rate as the source. This endpoint is for the following asset classes:

• Equity
• Fixed income
• Foreign exchange
• Commodities
• Real estate
• Digital assets

Available currencies: EUR / GBP / CHF / JPY / KRW / CAD / CNH / CNY / SGD / MXN / BRL

Endpoints

gRPC Stream

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

gRPC Replay

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

Request parameters

Requesting multiple tickers at the same time To configure multiple tickers in the same stream, provide the index_codes as a comma separated list eg ["KK_RFR_AAPLUSD_EUR", "KK_RFR_A005930KRW_USD"]

Stream

Parameter	Description	Examples
index_code	The Kaiko Capital Market Reference Rate ticker. You can find a full list of our tickers here.	"KK_RFR_AAPLUSD_EUR"

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
indexCode	The ticker identifying the rate.
price	The price of the Reference Rate in the converted currency.
tsEvent	The exact time of converted reference rate publication.
composition
.underlying
.name	The ticker identifying the Reference Rate
.price	The price of original Reference Rate publication.
.tsEvent	The exact time of original Reference Rate publication.
.fxRate
.name	The ticker identifying the forex Reference Rate
.price	The price of forex Reference Rate publication
.tsEvent	The exact time of forex Reference Rate publication

Request examples

cURL

cURL requests are intended for testing purposes only.

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

cURL - Replay

grpcurl
  -H "Authorization: Bearer $KAIKO_API_KEY" \
  -d '{
    "index_codes": ["KK_RFR_A005930KRW_USD"],
    "start_time": "2026-05-18T02:00:00Z",
    "end_time": "2026-05-18T02:00:05Z"
  }' \
  gateway.equ.kaiko.io:443 \
  kaiko.equities.EquitiesService/ReplayForexRates

Response Example

{
  "indexCode": "KK_RFR_A005930KRW_USD",
  "price": 187.37048153198643,
  "tsEvent": "2026-05-18T02:00:04.376377752Z",
  "composition": {
    "underlying": {
      "name": "KK_RFR_A005930KRW",
      "price": 282056.2806693604,
      "tsEvent": "2026-05-18T02:00:04.358065922Z"
    },
    "fxRate": {
      "name": "KK_RFR_USDKRW",
      "price": 1505.34,
      "tsEvent": "2026-05-18T02:00:03.512848896Z"
    }
  }