Markets

Get historical oracle (spot) prices for crypto chart pre-population

Returns per-symbol resolution-price history over [end_ms - minutes*60*1000, end_ms] (end_ms defaults to now; clamped to now if a future value is given). Each request names one oracle source so settlement feeds are never mixed. Symbols must be the wire ids for that source (bare btc-usd for Binance; btc-usd-polymarket-chainlink, btc-usd-kalshi-cfb, btc-usd-hyperliquid-mark, or a -polymarket-twap30/-polymarket-twap60 suffix for venue series). When source is omitted, it is inferred from the wire symbols — mixed sources are rejected. Only Binance gaps may be backfilled from Binance REST; every other source returns an empty array for a missing span. Responses are cached briefly. The internal store can lag real time by a few seconds.

get/markets/crypto/oracle-history

Request

  • Base URL
    https://data.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Query parameters

symbolsstring required

Comma-separated, case-insensitive wire symbols for a single source. Logical assets are btc-usd, eth-usd, sol-usd, xrp-usd, doge-usd, hype-usd, bnb-usd; venue sources append their suffix (for example btc-usd-polymarket-chainlink). Kalshi CF Benchmarks supports BTC, ETH, SOL, XRP, DOGE, HYPE, and BNB.

source'binance' | 'hyperliquid_mark' | 'kalshi_cfbenchmarks' | 'polymarket_chainlink' | 'polymarket_twap30' | 'polymarket_twap60'

Resolution feed identity. Omit only for legacy clients that encode the source in the wire symbol; new callers should pass it explicitly.

minutesinteger

Minutes of history to fetch (max 24h).

full_resolutionboolean

Return raw 1-second history without downsampling.

end_msinteger

End timestamp in epoch ms (clamped to server "now"). Omit for the live edge. Used for chunked/paginated backward loading.

Response

Price-history points per symbol, sorted ascending by timestamp.

MarketsOracleHistoryResponse required

Price-history points keyed by oracle symbol (btc-usd/eth-usd/sol-usd/xrp-usd), each array sorted ascending by timestamp.

Changes

No recorded changes to this operation across all 1 revision of this API.