Skip to main content
API Reference3 min read
Reference tables for exchange IDs, symbol formats, interval values, and tenor values used across the API. Use the metadata endpoints to discover available exchanges, symbols, and market metadata programmatically.

​
Exchanges

Pass exchange IDs via the exchange query parameter. Values are case-sensitive.

​
Crypto — Derivatives

Exchange IDExchange
BINANCE_FUTURESBinance USDT-M Futures
BINANCE_DELIVERYBinance Coin-M Futures
BYBITBybit Perpetual
OKEX_SWAPOKX Perpetual Swaps
OKEX_FUTURESOKX Futures
DERIBITDeribit
BITMEXBitMEX
BITGETBitget
BITFINEX_DERIVATIVESBitfinex Derivatives
GATE_IO_FUTURESGate.io Futures
HYPERLIQUID_FUTURESHyperliquid Futures
HYPERLIQUID_HIP3Hyperliquid HIP-3
HUOBI_DMHuobi DM
HUOBI_DM_SWAPHuobi DM Swap
HUOBI_DM_LINEAR_SWAPHuobi DM Linear Swap
CMECME Group

​
Crypto — Spot

Exchange IDExchange
BINANCEBinance
BYBIT_SPOTBybit Spot
COINBASECoinbase
OKEXOKX Spot
BITFINEXBitfinex
GATE_IOGate.io
BITSTAMPBitstamp
UPBITUpbit
HUOBIHuobi
HYPERLIQUIDHyperliquid Spot

​
Prediction Markets

Exchange IDExchange
POLYMARKETPolymarket

​
Equities

Exchange IDExchange
NYSENew York Stock Exchange
NASDAQNasdaq
FINRAFINRA
CBOECboe
IEXIEX
LTSELong-Term Stock Exchange
MIAX_PEARLMIAX Pearl
MEMBERS_EXCHANGEMembers Exchange
OTC_EQUITY_SECURITYOTC Equity

​
Commodities

Exchange IDExchange
CBOTChicago Board of Trade
NYMEXNYMEX
COMEXCOMEX
ICEICE
LMELondon Metal Exchange
LBMALondon Bullion Market
PLATTSS&P Global Platts

​
FX

Exchange IDExchange
INTERBANK_FXInterbank FX

​
Categories

category tells you what kind of market the instrument is. It describes the trading venue’s market class, not the API data type. Use SPOT for the underlying asset traded directly, and PERPETUAL for non-expiring derivative contracts.
ValueDescription
SPOTSpot market. You are trading the asset itself for immediate settlement, such as BTC-USD on Coinbase.
PERPETUALPerpetual futures / swap market. You are trading a derivative contract with no expiry, such as BTCUSDT on Binance Futures.
Categories describe the instrument itself. For example, TRADE_AGG data can exist for both SPOT and PERPETUAL markets, while data such as funding rates and open interest only applies to PERPETUAL markets.

​
Side

Used in per-side data types like TRADE_AGG and LIQUIDATION_AGG. Returned in the series identifier to distinguish buy vs. sell data.
ValueDescription
BUYBuy side
SELLSell side
You can filter by side using the side query parameter: 
# Get only buy-side candles
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600&side=BUY" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"

​
Symbol formats

There are three ways to specify which instrument you want data for: The exchange-native trading pair symbol. This is the most precise way to target a specific instrument. 
# Binance Futures BTC perpetual
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600" -H "X-Kiyotaka-Key: YOUR_API_KEY"

# Coinbase BTC spot
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=COINBASE&rawSymbol=BTC-USD&interval=HOUR&from=1774800000&period=3600" -H "X-Kiyotaka-Key: YOUR_API_KEY"
Symbols are exchange-specific. BTCUSDT on Binance Futures is not the same as BTCUSDT on Bybit. Always pair rawSymbol with the correct exchange.

​
coin

The base asset. Returns data for all matching instruments on the specified exchange(s). 
# All BTC pairs on Binance Futures
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&coin=BTC&interval=HOUR&from=1774800000&period=3600" -H "X-Kiyotaka-Key: YOUR_API_KEY"
Useful for heatmap queries where you want aggregated data across all pairs for an asset.

​
normalizedSymbol

A cross-exchange normalized market symbol. Use this when you want the same market represented in a consistent format across exchanges, such as BTC-USDT or BTC-USD. 
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&normalizedSymbol=BTC-USDT&interval=HOUR&from=1774800000&period=3600" -H "X-Kiyotaka-Key: YOUR_API_KEY"
Use rawSymbol when you need the exchange-native market identifier. Use normalizedSymbol when you want a normalized market identifier like BTC-USDT across exchanges. Use coin when you want broader coverage across pairs.

​
tokenName

Some market-independent datasets use tokenName alongside coin instead of exchange or symbol filters. 
curl "https://api.kiyotaka.ai/v1/points?type=TOKEN_SUPPLY_AGG&coin=BTC&tokenName=Bitcoin&interval=DAY&from=1775635290&period=604800" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
Use tokenName for token supply and dominance-style queries. In practice it usually matches the coinName returned by GET /v1/markets.

​
Intervals

Set the interval parameter to control aggregation granularity.
ValueDuration
MINUTE1 minute
FIVE_MINUTES5 minutes
FIFTEEN_MINUTES15 minutes
THIRTY_MINUTES30 minutes
HOUR1 hour
FOUR_HOURS4 hours
DAY1 day
WEEK1 week
Not all intervals are available for all data types. The API returns an error if you request an unsupported combination.

​
Tenors

Used by option summary types such as Implied Volatility and Skew. A tenor is the time-to-expiry bucket of the option summary series you want to query. For example, ONE_W means the one-week expiry bucket, while ONE_M means the one-month expiry bucket. Tenor is part of the market selection. It is different from interval, which controls how the returned data is time-bucketed.
ValueDescription
ONE_D1 day
THREE_D3 days
ONE_W1 week
ONE_M1 month
TWO_M2 months
THREE_M3 months
SIX_M6 months
ONE_Y1 year
Use market discovery to find which tenor values are actually available for a given summary symbol.

​
Time range

Specify the query window with from and period:
ParameterTypeDescription
fromint64Start time as a Unix timestamp in seconds (inclusive).
periodint64Duration in seconds from the from timestamp.
For example, to query 6 hours of hourly candles starting from a specific time: 
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=21600" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
This returns data from 1774800000 to 1774821600 (6 hours = 21,600 seconds).

​
Sort direction

Control the ordering of returned data points.
ValueDescription
SORT_DIRECTION_ASCAscending (oldest first) — default
SORT_DIRECTION_DESCDescending (newest first)

​
Transforms

Transforms modify how data is processed before it reaches you. Use them to get USD-denominated values or aggregate data across multiple exchanges.

​
Coin vs. USD denomination

By default, values are returned in coin terms (e.g., volume in BTC). To get USD-denominated values, add transform.normalize.quote=USD: 
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=3600&transform.normalize.quote=USD" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
Applies to: Candles (volume), Open Interest, Liquidations, Volume Profile, Orderbook Heatmap, Liquidation Heatmap. Does not apply to: Funding Rate — rates are already normalized. Use transform.normalize.fundingInterval instead (see below).

​
Multi-exchange aggregation

To aggregate data across multiple exchanges into a single series, pass multiple exchange parameters with a group-by transform. Use coin instead of rawSymbol since symbols differ across exchanges: 
curl "https://api.kiyotaka.ai/v1/points?type=TRADE_SIDE_AGNOSTIC_AGG&exchange=BINANCE_FUTURES&exchange=BYBIT&exchange=OKEX_SWAP&coin=BTC&interval=HOUR&from=1774800000&period=3600&transform.groupBy.type=GROUP_BY_TYPE_SUM" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
Multi-exchange aggregation requires Advanced or Enterprise tier. When groupBy is specified without an explicit transform.normalize.quote, USD normalization is applied automatically so values are comparable across exchanges.

​
GroupBy types per data type

Data TypeGroupBy TypeDescription
CandlesGROUP_BY_TYPE_SUMSums volume, preserves OHLC extremes
Open InterestGROUP_BY_TYPE_SUMSums OI across exchanges
Funding RateGROUP_BY_TYPE_OPEN_INTEREST_WEIGHTED_AVGOI-weighted average rate
LiquidationsGROUP_BY_TYPE_SUMSums liquidation volume
Volume ProfileGROUP_BY_TYPE_SUMSums volume per price level
TPOGROUP_BY_TYPE_SUMSums TPO data
Orderbook HeatmapGROUP_BY_TYPE_SUMCombines orderbook depth
Funding rate uses open interest weighted average (OIWA) instead of sum — this produces a more accurate cross-exchange rate by weighting each exchange proportionally to its OI.

​
Funding rate normalization

Funding rates can be normalized to a specific interval: 
curl "https://api.kiyotaka.ai/v1/points?type=FUNDING_RATE_AGG&exchange=BINANCE_FUTURES&rawSymbol=BTCUSDT&interval=HOUR&from=1774800000&period=28800&transform.normalize.fundingInterval=28800000" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"
The fundingInterval value is in milliseconds. The default is 28800000 (8 hours).