指南

MCP server#

MCP Server 通过 Model Context Protocol 将全部 Market 能力暴露为可直接调用的工具(index-current-price、market-token-ranking、balance-total-value 等),Claude Desktop、Cursor 等任何支持 MCP 的客户端均可自动发现并原生调用,无需任何额外接入代码。Agent 只需一句"查一下以太坊上今天涨幅最大的代币",MCP Server 即可自动完成代币解析、行情拉取、结果汇总的完整链路。

MCP Server 的工具#

  • 行情价格工具dex-okx-index-current-pricedex-okx-index-historical-pricedex-okx-market-pricedex-okx-market-price-chains,跨 20+ 条链的实时与历史指数/DEX 价格。
  • K 线工具dex-okx-market-candlesticksdex-okx-market-candlesticks-history,从 1 分钟到日线的 OHLCV 数据,支持扩展回溯窗口。
  • 代币情报工具dex-okx-market-token-searchdex-okx-market-token-price-infodex-okx-market-token-rankingdex-okx-market-token-holder ,代币发现、元数据、实时指标与持仓集中度分析。
  • 交易数据工具dex-okx-market-trades,任意代币的最新链上交易记录。
  • 余额工具dex-okx-balance-chainsdex-okx-balance-total-token-balancesdex-okx-balance-specific-token-balancedex-okx-balance-total-value,多链钱包余额与 USD 资产组合估值。

快速开始#

# for cursor
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
    }
  }
}
# for Claude code
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
      "type": "http"
    }
  }
}

示例交互#

MCP Server 激活后,Agent 可响应以下自然语言查询:

OKB 现在多少钱?
# 调用 index-current-price
给我 OKB 最近一周的 4 小时 K 线
# 调用 market-candlesticks
X-layer 链上现在最热的代币是什么?
# 调用 market-token-ranking
X-layer 上持有 USDT 最多的地址是谁?
# 调用 market-token-holder
0xd8dA... 这个钱包的总资产价值是多少?
# 调用 balance-total-value