okx-market

name okx-market description OKX cryptocurrency market data interface. Uses the OKX V5 REST API to retrieve spot, derivatives, index, and other crypto market data, including real-time prices, candlesticks, funding rates, open interest, and more. No authentication required, free to use. category data-source OKX Market Overview The OKX V5 REST API provides comprehensive cryptocurrency market data covering spot, perpetual swaps, delivery futures, options, and more. All market-data endpoints are public and can be called directly without authentication. The data comes from OKX, the world's second-largest cryptocurrency exchange. Quick Start Install a Python runtime (Python 3.9+ recommended) and the required requests dependency. pip install requests pandas No account registration or token configuration is required. Market-data endpoints are fully open. Review the endpoint documentation below and locate the interface you need. Use Python code to retrieve data according to the documentation. Example for the spot ticker endpoint: import requests import pandas as pd BASE_URL = "https://www.okx.com/api/v5" # Get the latest BTC-USDT market quote resp = requests.get( f" {BASE_URL} /market/ticker" , params={ "instId" : "BTC-USDT" }) data = resp.json()[ "data" ][ 0 ] print ( f"BTC last price: {data[ 'last' ]} 24h change: { float (data[ 'last' ])/ float (data[ 'open24h' ])* 100 - 100 : .2 f} %" ) Parameter Format Reference Instrument format ( instId ) : Spot: BTC-USDT , ETH-USDT Perpetual swap: BTC-USDT-SWAP , ETH-USDT-SWAP Delivery futures: BTC-USDT-250328 (expiry date in YYMMDD ) Options: BTC-USD-250328-95000-C (expiry-strike-C/P) Index: BTC-USD , ETH-USD Candlestick interval ( bar ) : 1m , 3m , 5m , 15m , 30m , 1H , 2H , 4H , 6H , 12H , 1D , 1W , 1M Instrument type ( instType ) : SPOT (spot), SWAP (perpetual), FUTURES (delivery), OPTION (option) Timestamp : millisecond Unix timestamp (for example 1773763200000 ) Response format : JSON. code=0 indicates success, and data is returned in the data field Link convention: every link to references/ in this document is written relative to this document (for example references/... ) — the form GitHub resolves when someone opens the file in a browser. The read_file tool resolves the same string against the skill that owns it, so the agent and a human reader reach one file. When adding new skill docs, always use the relative form, and keep reference paths unique across skills: a path two skills both carry is reported as ambiguous rather than guessed. Python Script Examples Market data retrieval example Candlestick data retrieval example Market Data Endpoint List ID Endpoint Path Title (Detailed Documentation) Category Description 1 /market/ticker Single Ticker Spot Market Retrieve the latest market data for a single trading instrument, including last price, bid/ask, 24h volume, and more 2 /market/tickers Batch Tickers Spot Market Retrieve all market data for a given instrument class ( SPOT / SWAP / FUTURES / OPTION ) in batch 3 /market/candles Candlestick Data Spot Market Retrieve candlestick (OHLCV) data with multiple supported intervals 4 /market/trades Recent Trades Spot Market Retrieve recent trade-level details 5 /public/instruments Instrument List Spot Market Retrieve metadata for all tradable instruments, including minimum order size and price precision 6 /market/books Order Book Depth Spot Market Retrieve bid/ask order book depth data 7 /public/funding-rate Funding Rate Derivatives Market Retrieve current and historical funding rates for perpetual contracts 8 /public/funding-rate-history Historical Funding Rate Derivatives Market Retrieve historical funding-rate data for perpetual contracts 9 /public/mark-price Mark Price Derivatives Market Retrieve mark prices for derivatives, used for PnL and liquidation calculations 10 /public/open-interest Open Interest Derivatives Market Retrieve open-interest data for derivatives 11 /public/price-limit Price Limit Derivatives Market Retrieve the current maximum and minimum price limits for derivatives 12 /market/index-tickers Index Tickers Index Market Retrieve index price market data 13 /market/index-candles Index Candles Index Market Retrieve index candlestick data