x402-mcp

Name: x402 crypto market structure
Author: tunedforai

面向 AI 代理的跨交易所加密货币市场结构。涵盖 20 个交易所、26 种代币、9 种工具——包括订单流、CVD、鲸鱼活动、资金费率/持仓量 (OI)、7 年 OHLCV 数据、链上地址风险。通过 MCP 免费使用。

npm version License: MIT

x402-mcp 是一个 stdio MCP 服务器，它将 x402.tunedfor.ai（一个实时加密市场结构 API）公开为 9 种工具，任何兼容 MCP 的客户端（Claude Desktop、Cursor、Cline、Windsurf、Claude Code）均可调用。通过 MCP 免费用于测试和低频查询；对于需要更高吞吐量的生产级代理，可在相同端点使用付费 REST 服务。

安装

Claude Desktop / Cursor / Windsurf

添加到您的 MCP 配置中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，其他操作系统路径类似）：

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

Claude Code

claude mcp add x402 -- npx -y @tunedforai/x402-mcp

Cline / Continue / 其他 MCP 客户端

使用与 stdio 命令相同的 npx -y @tunedforai/x402-mcp 调用方式。

手动安装

npm install -g @tunedforai/x402-mcp
x402-mcp  # runs the stdio server

工具

所有 9 种工具均为无状态。无需 API 密钥，无需身份验证，无需设置。直接调用即可。

工具	返回内容	REST 等效项	通过 MCP 免费 / 付费 REST
`marketSnapshot`	实时价格、资金费率、持仓量 (OI)、买卖比率、恐慌贪婪指数	`POST /data`	免费 / $0.20
`marketAnalyze`	宏观环境、DXY、VIX、方向信号 + 置信度	`POST /analyze/market`	免费 / $0.25
`marketOrderflow`	跨交易所 CVD、鲸鱼活动、清算压力	`POST /analyze/orderflow`	免费 / $0.50
`marketFull`	快照 + 订单流 + LLM 合成分析	`POST /analyze/full`	免费 / $0.75
`addressRisk`	钱包风险评分（混币器、制裁、交易对手）。EVM + Solana	`POST /analyze/address`	免费 / $0.25
`history1h`	带有买卖流拆分的每小时 OHLCV。最多 5,000 根 K 线，7 年历史数据	`POST /data/history/1h`	免费 / $5.00
`history1d`	带有买卖流拆分的每日 OHLCV。最多 5,000 根 K 线，7 年历史数据	`POST /data/history/1d`	免费 / $5.00
`history5m`	5 分钟 OHLCV。高分辨率日内数据	`POST /data/history/5m`	免费 / $1.00
`apiInfo`	定价、快速入门、迁移详情	`GET /api_info`	免费

代币覆盖范围

快照层级 (17 种代币): BTC, ETH, SOL, XRP, BNB, DOGE, ADA, AVAX, LINK, ATOM, DOT, ARB, SUI, OP, LTC, AMP, ZEC
订单流 + 历史数据层级 (26 种代币): 上述所有代币 + NEAR, AAVE, BCH, HBAR, SHIB, TON, TRX, UNI, XLM

示例

交易前检查

You: marketSnapshot BTC
LLM: BTC at $74,180. Buy ratio 58% — bullish lean. Funding rate +0.012%
     (mild long bias). Open interest $14.2B. Fear & Greed: 32 (Fear).
     Snapshot 12 sec old.

跨交易所订单流

You: marketOrderflow ETH
LLM: ETH cross-exchange CVD: -$1.2M last hour (sell-side dominant).
     Whale activity: 8 large bars across Binance/Coinbase/Bybit.
     Liquidations: $890K longs, $230K shorts. Pressure: bearish.

回测数据

You: history1d BTC limit=365
LLM: [returns 365 daily bars: open/high/low/close/volume/buy_volume/sell_volume]

免费 MCP 与付费 REST 的区别

MCP 封装器在速率限制内免费——非常适合测试、原型设计、低频代理工作流和个人使用。

对于生产级代理（24/7 轮询、多代币监控、大规模回测），请使用 x402.tunedfor.ai 上的付费 REST 端点。REST 的特点是：

通过 x402 协议 在 Base 或 Solana 上以 USDC 按调用付费
无需 API 密钥——您的代理在本地签署支付；私钥永远不会离开您的机器
无速率限制——按使用量付费
无订阅费——无每月最低消费

从任何 MCP 客户端调用 apiInfo 即可获取当前的定价表、迁移指南和 SDK 示例。

x402 支付的工作原理（REST 层级）

当您的代理调用付费 REST 端点时：

首次请求返回 HTTP 402 Payment Required 以及价格信息
代理在本地签署 USDC 支付（私钥永远不会离开代理）
代理携带支付头信息重试请求
服务器验证链上结算并返回数据

无需账户，无需 API 密钥，无需信用卡。只需 USDC 和一个钱包。

数据来源

价格 + 报价: OKX, Coinbase 公共 API
资金费率 / 持仓量 / 清算: Coinalyze (商业许可)
链上指标、交易所流向、鲸鱼比率: Santiment (商业许可)
跨交易所订单流 (CVD, 鲸鱼柱, 清算聚合): 跨 20 个交易所的 WebSocket 聚合器，汇入 InfluxDB，归一化为 1 分钟 K 线
宏观背景 (DXY, VIX, 国债收益率): FRED + Finviz
恐慌贪婪指数: alternative.me

我们不分发原始交易所 Tick 数据——我们提供的是经过推导和计算的聚合数据。

链接

服务: x402.tunedfor.ai
REST 文档: x402.tunedfor.ai/catalog
快速入门: x402.tunedfor.ai/llms.txt
npm: @tunedforai/x402-mcp
Smithery: smithery.ai/server/@tunedforai/x402-mcp
问题 / 请求: github.com/tunedforai/x402-mcp/issues
x402 协议: x402.org

x402 crypto market structure