Get historical market data

Retrieve historical market data for OKX.

byOKX API V5

144calls

N/Alatency

Discover -> Inspect -> Call

Call setup

Tool IDokx_api_v5.public.market-data-history.list.v5.6b2d6ffc

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

modulestringRequired

Data module type 1: Tick-by-tick trade history 2: 1-minute candlestick 3: Funding rate 4: 400-level orderbook 5: 5000-level orderbook (from Nov 1, 2025) 6: 50-level orderbook (will gradually be deprecated, please use module = 4 ,5 instead)

instTypestringRequired

Instrument type SPOT FUTURES SWAP OPTION

instIdListstringOptional

List of instrument IDs, e.g. BTC-USDT , or ANY for all instruments (ANY is only supported for module = 1 , 2 , 3 & dateAggrType = daily ) Multiple instrument IDs should be separated by commas, e.g. BTC-USDT,ETH-USDT Maximum length = 10 Only applicable when instType = SPOT

instFamilyListstringOptional

List of instrument families, e.g. BTC-USDT , or ANY for all instruments (ANY is only supported for module = 1 , 2 , 3 & dateAggrType = daily ) Multiple instrument families should be separated by commas, e.g. BTC-USDT,ETH-USDT Maximum length = 10 (= 1when module = 6 & instType = OPTION ) Only applicable when instType ≠ SPOT

dateAggrTypestringRequired

Date aggregation type daily (not supported for module = 3 & instFamilyList ≠ ANY ) monthly (not supported for module = 6 )

beginstringRequired

Begin timestamp. Unix timestamp format in milliseconds (inclusive) Maximum range: 20 days for daily, 20 months for monthly

endstringRequired

End timestamp. Unix timestamp format in milliseconds (inclusive) When module = 6 & instType = OPTION , only returns data for the day specified by end