x402 Crypto Market Structure

x402-mcp

面向 AI Agent 的跨交易所加密货币市场结构。20 家交易所、26 种固定 Pillar 代币，以及支持任意代币的轻量覆盖；提供 7 种工具——轻量覆盖、快照、订单流、宏观市场状态、完整分析、地址风险和 API 信息。通过 MCP 免费使用。

x402-mcp 是一个 stdio MCP 服务，可将 x402.tunedfor.ai——一个实时加密货币市场结构 API——作为 7 种工具提供，任何兼容 MCP 的客户端（Claude Desktop、Cursor、Cline、Windsurf、Claude Code）都可以调用。这些工具可通过 MCP 免费使用，适合测试和低频查询；需要更高吞吐量的生产环境 Agent 可通过相同端点使用付费 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

---

工具

全部 7 种工具均为无状态工具。无需 API 密钥、身份验证或设置，直接调用即可。

工具	返回内容	对应的 REST 接口	MCP 免费 / REST 付费
marketLight	基于 CoinGecko 的任意代币市场覆盖：价格、动量、排名、流动性/交易所背景信息和风险标记。默认 brief=off；设置 brief=full 可获取 Kimi 简报	POST /data/light	免费 / $0.05
marketSnapshot	免费的 16 字段 MCP 子集：实时价格、资金费率、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
apiInfo	定价、快速入门、迁移详情	GET /api_info	免费

代币覆盖范围

快照层支持的主流 L1 和 L2：BTC、ETH、SOL、XRP、BNB、DOGE、ADA、AVAX、LINK、ATOM、DOT、ARB、SUI、OP、LTC。

扩展订单流层：以上代币，以及 NEAR、AAVE、BCH、HBAR、SHIB、TON、TRX、UNI、XLM。

marketLight 支持固定 Pillar 代币列表之外的已列入 CoinGecko 的代币。固定快照/订单流工具拒绝某个代币符号时，可使用该工具轻量查询此类代币，例如 WCT。默认使用 brief=off 以降低延迟；只有在明确需要 Kimi 生成的文字简报时，才请求 brief=full。

从任何 MCP 客户端调用 apiInfo，即可获取权威的最新列表。

---

MCP 子集约定

marketSnapshot 返回一个免费的 16 字段 MCP 子集，供 Agent 获取上下文和进行路由。它不是付费 REST /data 的架构。

预期的顶层 MCP 键：

• as_of_utc
• token
• snapshot
• data_freshness
• presentation_hint
• next_steps

snapshot 对象包含 16 个市场数据字段及元数据。token 和 fetched_at 是元数据键，因此原始 JSON 键数量可能显示 snapshot 下有 17 个键，尽管产品约定的市场数据子集为 16 个字段。

不要要求 MCP 返回 schema_version 或 coverage。除非有意扩展 MCP 产品约定，否则这些字段属于付费 REST 约定。

每个 marketSnapshot 响应都必须保留 REST CTA：

This is a 16-field MCP subset. Paid REST /data at x402.tunedfor.ai ($0.20 USDC) returns the full 70-field snapshot including on-chain metrics, sentiment, and historical percentiles. No API key, pay-per-call from any wallet.

---

示例

交易前检查

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.

免费 MCP 与付费 REST

MCP 封装免费，但有速率限制——非常适合测试、原型开发、低频 Agent 工作流和个人使用。

对于生产环境中的 Agent（全天候轮询、多代币监控、大规模回测），请使用 x402.tunedfor.ai 上的付费 REST 端点。REST 的特点：

• 通过 x402 protocol 使用 Base 或 Solana 上的 USDC 按调用付费
• 无需 API 密钥——Agent 在本地签署付款；私钥不会离开你的设备
• 每个钱包限流为每分钟 60 次调用、每小时 200 次调用——防止过度抓取；超出限制时返回 429
• 无需订阅——没有月度最低消费

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

---

x402 付款方式（REST 级别）

当你的 Agent 调用付费 REST 端点时：

1. 首次请求返回带有价格的 HTTP 402 Payment Required
2. Agent 在本地签署 USDC 付款（私钥不会离开 Agent）
3. Agent 附上付款标头后重试
4. 服务验证链上结算情况并返回数据

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

---

数据来源

• 价格和代币行情： OKX、Coinbase 公共 API
• 资金费率／未平仓合约／强平： Coinalyze（商业许可）
• 链上指标、交易所资金流、巨鲸比率： 获许可的第三方机构数据
• 跨交易所订单流（CVD、巨鲸柱、强平汇总）： 通过 WebSocket 聚合来自 20 家交易所的数据至 InfluxDB，并规范化为 1 分钟柱
• 宏观背景（DXY、VIX、美国国债收益率）： FRED + Finviz
• 恐惧与贪婪指数： alternative.me

我们不会重新分发原始交易所数据，而是提供经过推导和计算的汇总数据。返回响应前，所有原始来源字段都会转换为我们自己的综合信号。

---

链接

• 服务： 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 protocol： x402.org

---

许可证

MIT © Tuned For AI