AI导哈

加密货币市场数据协议服务器

OKX MCP是一个提供实时加密货币市场数据访问的协议服务器，支持查询行情、订单簿、交易历史等多种金融数据。

  • by solenyaresearch0000
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 solenyaresearch0000/okx-mcp

使用说明

OKX MCP-模型上下文协议服务器

一种模型上下文协议（MCP）服务器，提供对OKX加密货币交易所的实时市场数据访问。

特性

从OKX查询市场数据，包括：

  • 票务数据 -当前价格、数量、高/低
  • 订货簿 -多个价格水平的出价和要价
  • 交易历史 -最近的价格和数量交易
  • OHLCV蜡烛 -技术分析的历史价格数据
  • 交易工具 -列出所有可用配对及其详细信息
  • 账户余额 -您的账户持有量（需要身份验证）
  • 指数价格 -期货和永久指数价格
  • 24小时统计 -数量和价格变化指标
  • 期权链 -任何标的资产的所有可用看涨和看跌期权
  • 期权报价机 -特定期权合约的当前市场数据
  • 选项历史记录 -历史期权价格和交易量趋势

安装

此服务器已安装并配置。要将其与Claude Code一起使用：

claude mcp list  # Verify OKX MCP is connected

配置

OKX MCP已经在您的Claude Code设置中配置了您的API凭据：

{
  "okx": {
    "type": "stdio",
    "command": "node",
    "args": ["/home/user/Desktop/claude/okx-mcp/index.js"],
    "env": {
      "OKX_API_KEY": "your-api-key",
      "OKX_API_SECRET": "your-api-secret",
      "OKX_API_PASSPHRASE": "your-api-passphrase"
    }
  }
}

可用工具

get_ticker

获取交易对的当前市场数据。

参数：

  • symbol （必填）：交易对符号（例如。， BTC-USDT, ETH-USDT)

例子： 获取比特币价格

Query: Get the current price of BTC-USDT

获取订单_预订

获取交易对的订单簿（出价和要价）。

参数：

  • symbol （必填）：交易对符号
  • depth （可选）：级别数（1、5、10、20）。默认值：20

例子： 检查买入/卖出压力

Query: Show me the order book for ETH-USDT with depth of 10

get_recent_trades

获取特定交易对的最近交易。

参数：

  • symbol （必填）：交易对符号
  • limit （可选）：交易次数（1-100）。默认值：20

例子： 查看最近的活动

Query: Get the last 50 trades for SOL-USDT

get_handles

获取历史OHLCV烛台数据以进行技术分析。

参数：

  • symbol （必填）：交易对符号
  • timeframe （必填）：蜡烛时间框架
    • 会议纪要： 1m, 5m, 15m, 30m
    • 小时： 1H, 2H, 4H, 6H, 8H, 12H
    • 每日/每周/每月： 1D, 1W, 1M
  • limit （可选）：蜡烛数量（1-100）。默认值：20

例子： 分析价格趋势

Query: Get 1-hour candles for BTC-USDT over the last 24 hours

get_仪器

获取OKX上所有可用交易工具/对的列表。

参数：

  • tradeType （必填）：交易对类型
    • SPOT：现货交易
    • FUTURES：永久和有日期的期货
    • SWAP：永久掉期合约
    • OPTION：期权合约
  • state （可选）：按状态筛选(live, suspend, preopen).默认设置：实时
  • limit （可选）：结果数量。默认值：100

例子： 查找可用配对

Query: List all live spot trading pairs on OKX

get_count_balance

获取所有资产的OKX账户余额。

参数： 无

例子： 检查您的持有量

Query: What's my account balance on OKX?

get_index_price

获取特定交易工具的指数价格。

参数：

  • symbol （必填）：交易对符号或指数名称（例如。， BTC-USDT, BTC)

例子： 检查永久指数

Query: Get the index price for BTC perpetual contracts

24h体积

获取24小时交易量和价格变化统计数据。

参数：

  • symbol （必填）：交易对符号

例子： 分析市场活动

Query: Get the 24-hour volume and change for DOGE-USDT

get_options_chain

获取给定标的资产和到期日的所有可用期权（看涨期权和看跌期权）。包括买卖价格、罢工和合同细节。

参数：

  • underlying （必填）：基础资产（例如。， BTC, ETH, SOL).使用基础货币，而不是完整货币对。
  • expiration （可选）：YYYYMMDD格式的到期日期（例如。， 20251215 2025年12月15日）。错过所有的赎罪日。

例子： 查找可用选项

Query: Show me all available BTC call and put options
Query: Get all ETH options expiring on 2025-12-31

get_options_ticker

获取特定期权合约的当前市场数据。包括买入价/卖出价、交易量、未平仓合约、标价和指数价。

参数：

  • symbol （必填）：完整选项符号（例如。， BTC-USDT-20251215-40000-C 拨打40000个电话，或 BTC-USDT-20251215-40000-P 对于一个put）

例子： 监控期权价格

Query: Get current market data for BTC-USDT-20251231-50000-C

获取_选项_历史

获取历史期权市场数据，包括价格、交易量和未平仓合约随时间的变化。

参数：

  • symbol （必填）：完整选项符号（例如。， BTC-USDT-20251215-40000-C)
  • period （必填）：要检索的历史时期
    • 1D：1天的数据
    • 1W：1周的数据
    • 1M：1个月的数据

例子： 分析期权趋势

Query: Get 1-day historical data for BTC-USDT-20251231-50000-C

例子

寻找最佳交易对

I need to find which altcoin has the highest 24h volume. Show me the top 10 spot trading pairs.

监控价格走势

Get BTC-USDT 5-minute candles for the last 2 hours to see if we're in an uptrend.

检查市场深度

Show me the order book for ETH-USDT to see if there's strong buy support.

分析最近的交易

What was the volume of the last 30 trades for SOL-USDT? Are buyers or sellers more aggressive?

监控您的投资组合

What's my current account balance on OKX?

分析期权市场

Show me all available BTC options with their strike prices and expiration dates.

监控期权波动

Get the current price and market data for BTC-USDT-20251231-50000-C (BTC 50K call expiring end of year).

研究选项趋势

Get 1-week historical data for ETH-USDT-20251231-2000-P to see how this put option has moved.

API文档

有关OKX API端点的更多详细信息：

  • 官方OKX API文档：https://www.okx.com/docs-v5/en/

选项API详细信息

关于OKX选项的重要发现：

仪器系列

OKX按以下方式组织选项 instFamily:

  • BTC-USD：以BTC结算的比特币期权
  • ETH-USD：以ETH结算的以太坊期权
  • BTC-USDT：以USDT结算的比特币期权（稳定币）
  • ETH-USDC：以美元结算的以太坊期权（稳定币）

仪器ID格式

选项使用以下格式： {BASE}-{QUOTE}-{EXPIRY}-{STRIKE}-{TYPE}

示例：

  • BTC-USD-251128-126000-C -BTC看涨期权，行使126000美元，于2025年11月28日到期
  • ETH-USDC-260130-4000-P -ETH看跌期权，行使4000美元，于2026年1月30日到期
  • SOL-USDC-251215-200-C -SOL电话，罢工200美元，2025年12月15日到期

哪里：

  • 到期：YYMMDD格式（例如。， 251128 =2025年11月28日）
  • 罢工：以报价货币表示的执行价格
  • 类型: C 对于呼叫， P for put

定价货币⚠️ 关键的

OKX期权以结算货币定价，而不是报价货币！

示例 BTC-USD-251128-126000-C:

  • 结算货币(settleCcy): 比特币
  • 标记价格： 0.0017 = 0.0017英热单位 （不是美元！）
  • 美元价值： 0.0017 BTC × $105,900/BTC = $180.03 USD

始终检查 settleCcy 仪器详细信息中的字段！

合同规范

每份期权合约都有：

  • ctVal：合同价值（通常 1)
  • ctMult：合同乘数（通常 0.01 BTC-USD期权）
  • settleCcy：结算货币（期权支付的货币）
  • tickSz：最小价格增量（例如。， 0.0001 BTC）

合同详细信息示例：

{
  "instId": "BTC-USD-251128-126000-C",
  "instFamily": "BTC-USD",
  "stk": "126000",
  "settleCcy": "BTC",
  "ctVal": "1",
  "ctMult": "0.01",
  "tickSz": "0.0001"
}

获取选项数据

列出仪器系列的所有选项：

curl "https://www.okx.com/api/v5/public/instruments?instType=OPTION&instFamily=BTC-USD"

获取特定选项的股票代码/定价：

curl "https://www.okx.com/api/v5/market/ticker?instId=BTC-USD-251128-126000-C"

可用到期日：

curl "https://www.okx.com/api/v5/public/instruments?instType=OPTION&instFamily=BTC-USD"
# Then extract unique YYMMDD values from instrument IDs

常见的陷阱

  1. 错误的货币假设：假设价格以BTC计价时以美元计价

    • ❌ 错误： mark_price = 0.0017 → “期权价格为0.0017美元”
    • ✅ 正确的 mark_price = 0.0017 → “期权成本0.0017 BTC=180美元”

  2. 缺少instFamily参数：选项需要 instFamily，不仅 uly

    • ❌ 错误： instType=OPTION&uly=BTC-USD
    • ✅ 正确的 instType=OPTION&instFamily=BTC-USD

  3. 仪器ID无效：必须与精确格式匹配

    • ❌ 错误： BTC-USD-11282025-126000-CALL
    • ✅ 正确的 BTC-USD-251128-126000-C

流动性票据

根据经验测试（2025年11月）：

  • 更好的流动性：去抑制通常具有更好的流动性选择
  • OKX优势：可提供更多到期日期，与现货/期货集成
  • 最适合：程序化访问、研究、回溯测试
  • 罢工报道：范围很广，通常为现货价格的50%-200%

故障排除

MCP未连接

验证服务器是否正在运行：

OKX_API_KEY=your-key OKX_API_SECRET=your-secret OKX_API_PASSPHRASE=your-pass node index.js

速率限制

OKX API有费率限制。如果您遇到速率限制错误，请稍等片刻，然后再发出下一个请求。

无效凭证

在Claude Code MCP配置中双击您的API凭证。确保：

  • API密钥正确
  • API机密正确
  • API密码短语正确（准确区分大小写的字符串）

相关 MCP