market module
May 18, 2026 · View on GitHub
Market data tools. No API key required.
Tools
| Tool | Description |
|---|---|
market_get_ticker | Single instrument ticker (last price, 24h volume, bid/ask) |
market_get_tickers | All tickers for an instrument type (SPOT / SWAP / FUTURES / OPTION) |
market_get_orderbook | Order book depth |
market_get_candles | Candlestick data — automatically routes to historical endpoint for older time ranges (back to 2021) |
market_get_index_ticker | Index ticker for an underlying (e.g. BTC-USD) |
market_get_index_candles | Index candlestick data |
market_get_price_limit | Price limit (upper/lower) for a contract |
market_get_funding_rate | Current funding rate for a perpetual contract |
market_get_funding_rate_history | Historical funding rates |
market_get_mark_price | Mark price for derivatives |
market_get_open_interest | Open interest across instruments |
market_get_trades | Recent trade history |
market_get_pair_spread | Pair spread statistics (abs + ratio: mean/stdDev/median/min/max) between two instruments over a lookback window |
Example prompts
- "What is the current BTC-USDT price?"
- "Show me the BTC-USDT-SWAP orderbook top 10 levels"
- "Get hourly candles for ETH-USDT for the last 24 hours"
- "What is the funding rate for BTC-USDT-SWAP?"
- "Show open interest for all SWAP instruments"
- "Get the spread statistics between BTC-USDT-SWAP and ETH-USDT-SWAP over the last week"
Startup (no key needed)
{
"mcpServers": {
"okx-market": {
"command": "okx-trade-mcp",
"args": ["--modules", "market"]
}
}
}
CLI
okx market ticker BTC-USDT
okx market tickers SPOT
okx market orderbook BTC-USDT --sz 10
okx market candles BTC-USDT --bar 1H --limit 24
okx market candles BTC-USDT --bar 1D --after 1672531200000 # candles before 2023-01-01
okx market funding-rate BTC-USDT-SWAP
okx market funding-rate BTC-USDT-SWAP --history --limit 10
okx market mark-price --instType SWAP --instId BTC-USDT-SWAP
okx market open-interest --instType SWAP
okx market trades BTC-USDT --limit 20
okx market index-ticker --instId BTC-USD
okx market price-limit BTC-USDT-SWAP
okx market instruments --instType SPOT
Supported candle intervals: 1m 3m 5m 15m 30m 1H 2H 4H 6H 12H 1D 1W 1M
market 模块
行情数据工具。无需 API Key。
工具列表
| 工具 | 说明 |
|---|---|
market_get_ticker | 单币对行情(最新价、24h 量、买一/卖一) |
market_get_tickers | 某类型全部行情(SPOT / SWAP / FUTURES / OPTION) |
market_get_orderbook | 盘口深度 |
market_get_candles | K线 — 自动根据时间范围切换历史端点(可查询至 2021 年) |
market_get_index_ticker | 指数行情(如 BTC-USD) |
market_get_index_candles | 指数K线 |
market_get_price_limit | 合约涨跌停价 |
market_get_funding_rate | 永续合约当前资金费率 |
market_get_funding_rate_history | 历史资金费率 |
market_get_mark_price | 衍生品标记价格 |
market_get_open_interest | 持仓量 |
market_get_trades | 最新成交记录 |
示例提示词
- "BTC-USDT 当前价格是多少?"
- "显示 BTC-USDT-SWAP 盘口前10档"
- "获取 ETH-USDT 最近24小时的1小时K线"
- "BTC-USDT-SWAP 的资金费率是多少?"
- "显示所有 SWAP 的持仓量"
启动配置(无需 Key)
{
"mcpServers": {
"okx-market": {
"command": "okx-trade-mcp",
"args": ["--modules", "market"]
}
}
}
CLI
okx market ticker BTC-USDT
okx market tickers SPOT
okx market orderbook BTC-USDT --sz 10
okx market candles BTC-USDT --bar 1H --limit 24
okx market candles BTC-USDT --bar 1D --after 1672531200000 # 查询 2023-01-01 之前的历史K线
okx market funding-rate BTC-USDT-SWAP
okx market funding-rate BTC-USDT-SWAP --history --limit 10
okx market mark-price --instType SWAP --instId BTC-USDT-SWAP
okx market open-interest --instType SWAP
okx market trades BTC-USDT --limit 20
okx market index-ticker --instId BTC-USD
okx market price-limit BTC-USDT-SWAP
okx market instruments --instType SPOT
K线周期:1m 3m 5m 15m 30m 1H 2H 4H 6H 12H 1D 1W 1M