market module

May 18, 2026 · View on GitHub

Market data tools. No API key required.

Tools

ToolDescription
market_get_tickerSingle instrument ticker (last price, 24h volume, bid/ask)
market_get_tickersAll tickers for an instrument type (SPOT / SWAP / FUTURES / OPTION)
market_get_orderbookOrder book depth
market_get_candlesCandlestick data — automatically routes to historical endpoint for older time ranges (back to 2021)
market_get_index_tickerIndex ticker for an underlying (e.g. BTC-USD)
market_get_index_candlesIndex candlestick data
market_get_price_limitPrice limit (upper/lower) for a contract
market_get_funding_rateCurrent funding rate for a perpetual contract
market_get_funding_rate_historyHistorical funding rates
market_get_mark_priceMark price for derivatives
market_get_open_interestOpen interest across instruments
market_get_tradesRecent trade history
market_get_pair_spreadPair 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_candlesK线 — 自动根据时间范围切换历史端点(可查询至 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