Okx

@pipeworx/okx

OKX v5 MCP — 无需密钥的公共市场端点。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• instruments(instType, uly?, instFamily?, instId?) — 列出交易品种（SPOT|MARGIN|SWAP|FUTURES|OPTION）
• ticker(instId) — 单个行情数据（例如 BTC-USDT）
• tickers(instType, uly?, instFamily?) — 按类型列出行情数据
• order_book(instId, sz?) — 订单簿
• candles(instId, bar?, after?, before?, limit?) — OHLC（bar 1m|3m|5m|15m|30m|1H|2H|4H|6H|12H|1D|1W|1M|3M）
• trades(instId, limit?) — 最近成交
• market_24hr(instId) — 24 小时行情
• index_tickers(quoteCcy?, instId?) — 指数行情
• funding_rate(instId) — 当前资金费率（永续掉期）
• funding_rate_history(instId, before?, after?, limit?) — 历史资金费率
• mark_price(instType, uly?, instId?) — 标记价格
• perp_metrics(instId, period?, buckets?) — 一次调用获取资金费率 + 未平仓量 + 主动买入/卖出（CVD）+ 多空账户比率
• open_interest(instId, instType?) — 未平仓合约数量、币本位规模、美元名义价值
• taker_volume(instId, period?, buckets?, unit?) — 主动买入与卖出量、买卖比率及该时间窗口内的 CVD
• long_short_ratio(instId, period?, buckets?) — 做多账户与做空账户的比率
• time() — 系统时间
• status() — 系统状态

数据源

https://www.okx.com/api/v5/public 和 /market

交易品种代码

上面的四个衍生品工具都接受常见格式的永续合约代码 — MASKUSDT（Binance 格式）、MASK、MASK/USDT、MASK-USDT 和 MASK-USDT-SWAP 均会解析为 OKX 合约 MASK-USDT-SWAP。每个响应都会注明交易平台和解析后的 instId，因为此处返回的是 OKX 自有合约数据，而非在 Binance 或 Bybit 上报价的币种数据，数字会因交易平台而异。Binance 的永续合约端点会拒绝来自 Cloudflare 出口的请求（403），因此我们无法提供 Binance 专属的主动买入/卖出明细。

对于未知合约，返回 {found: false, reason: "instrument_not_found"}，并附上解析后的 instId 和提示，而不是空的成功响应 — OKX 对无效交易品种本身会返回 HTTP 200 和 code: "51001"。

列顺序（主动交易量）

/rubik/stat/taker-volume-contract 返回 [ts, sellVol, buyVol] — 卖出量在前。 已于 2026-08-22 通过将实时 /market/trades 成交数据按 MASK-USDT-SWAP 分为 5 分钟区间，并与该端点逐项比对，确认此顺序无误。若将列顺序读反，CVD 的正负号会在不知不觉中被颠倒。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "okx": {
      "url": "https://gateway.pipeworx.io/okx/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/okx/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表所列：目前，单个工具包端点除了该工具包自有工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是判断某一天实际范围的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题 — 通过跨整个目录路由请求的 ask_pipeworx — 无需你再添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出的工具所属工具包不同；通过任一端点上的 ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/instruments \
  -H 'Content-Type: application/json' \
  -d '{"instType":"SPOT"}'

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/instruments。查找工具：POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

独立运行（无需网关账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需与网关往返通信：

{
  "mcpServers": {
    "okx": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-okx"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-okx

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，且仅提供此软件包的工具——不包含上述网关连接所添加的任何共享元工具。相同的源代码，相同的工具，不涉及 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上面的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Okx data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT