Market Data (x402)

Name: Market Data (x402)
Author: r0dell

本地服务

github.com/r0dell金融数据02 周前更新

代码仓库

关于 Market Data (x402)

Market Data (x402) 是面向需要交易所日程、期货、宏观数据和合约规格的助手与 Agent 的 MCP 服务。付费调用通过 x402 使用 Base 上的 USDC，另有五个免费辅助工具。

主要功能

01交易所开放时间与假日
02期货到期日与换月日期
03交易时段与外汇时段数据
04美国国债、ECB 与 COT 数据
05市场日历与简报
06期货合约规格

适用场景

01查询交易所是否开放
02查找期货换月与到期日期
03查看收益率曲线与汇率
04通过一份简报查看近期市场事件

MCP 相关

向 MCP 客户端提供 32 个付费市场数据工具和五个免费辅助工具。配置钱包密钥后，付费调用通过 x402 自动使用 Base 上的 USDC 支付。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "r0dell-market-data": {
      "command": "uvx",
      "args": [
        "x402-market-data-mcp"
      ],
      "env": {
        "X402_KEY_FILE": "<X402_KEY_FILE>",
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "MAX_USDC_PER_CALL": "<MAX_USDC_PER_CALL>",
        "MAX_USDC_PER_SESSION": "<MAX_USDC_PER_SESSION>"
      }
    }
  }
}

启动命令uvx x402-market-data-mcp

需要配置的环境变量

X402_KEY_FILE密钥Path to a file with the private key of a small, dedicated payment wallet (plain text or JSON with private_key). Without it only free tools work.

X402_PRIVATE_KEY密钥Alternative to X402_KEY_FILE: private key of a small, dedicated payment wallet.

MAX_USDC_PER_CALLHighest price per call in USDC

MAX_USDC_PER_SESSIONTotal budget per server start in USDC

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypix402-market-data-mcp0.2.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Market Data MCP

一个 MCP 服务，为 AI 助手和 Agent 提供 32 个付费市场数据工具和 5 个免费辅助工具：

领域	工具	每次调用价格
交易所交易时间	`market_is_open`、`market_next_open_close`、`market_holidays`	0.01–0.02 USDC
期货	`futures_front_month`、`futures_expirations`、`futures_roll_calendar`	0.01–0.02 USDC
交易时间	`settlement_date`、`fx_sessions`、`dst_gaps`、`is_dst_gap`、`market_countdown`	0.01–0.02 USDC
宏观	`treasury_yield_curve`、`treasury_spread`、`ecb_fx_rate`、`ecb_convert`、`cot_positioning`	0.01–0.02 USDC
日历	`options_expiration_check`、`options_expiration_calendar`、`vix_expirations`、`economic_release_next`、`economic_releases`、`central_bank_next_meeting`、`central_bank_meetings`、`treasury_auctions`、`treasury_next_auction`、`is_banking_day`、`banking_holidays`、`index_rebalance_dates`	0.01–0.02 USDC
简报	`trading_briefing` – 一次调用即可获取未来几天所有影响市场的事件	0.03 USDC
期货规格	`contract_spec`、`futures_tick_value`、`futures_position_size`	0.01 USDC
免费	`catalog_list`、`payment_status`、`list_markets`、`list_futures_products`、`list_cot_markets`	免费

交易所：NYSE、Nasdaq、LSE、Xetra、SIX、Tokyo、Hong Kong、Shanghai、ASX、CME 股指期货。期货：ES、MES、NQ、MNQ、YM、MYM、RTY、M2K、FDAX、FDXM、FESX、FSMI。宏观数据来自美国财政部（公有领域）、欧洲央行（欧元参考汇率；来源：欧洲央行统计数据）以及 CFTC 持仓报告（公有领域）。

付款方式

每个付费工具都会调用由 x402 保护的 HTTP API。服务会使用你提供的钱包密钥，自动通过 Base 上的 USDC 付款，并且仅限于：

付款至这些 API 的已知钱包（拒绝任何其他收款方），
使用 Base 主网上的 USDC 付款，
每次调用不超过 MAX_USDC_PER_CALL（默认值为 0.05），每次服务启动期间不超过 MAX_USDC_PER_SESSION（默认值为 1.00）。

不提供密钥时，免费工具仍可使用，付费工具会说明如何启用付款。

请为 X402_PRIVATE_KEY 使用一个单独的小额钱包，其中只存放少量 Base 上的 USDC。切勿使用你的主钱包。无需 ETH 支付 Gas；x402 促进器会代付。

安装（Claude Desktop、Cursor 及任何 MCP 客户端）

需要安装 uv。将以下内容添加到 MCP 客户端配置中（Claude Desktop：Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "market-data": {
      "command": "uvx",
      "args": ["--from", "x402-market-data-mcp", "market-data-mcp"],
      "env": {
        "X402_KEY_FILE": "C:\\path\\to\\wallet.json",
        "MAX_USDC_PER_SESSION": "1.00"
      }
    }
  }
}

X402_KEY_FILE 指向一个存有密钥的文件（纯文本或包含 private_key 的 JSON）；也可以直接设置 X402_PRIVATE_KEY。如果不使用 uv：运行 pip install x402-market-data-mcp 并使用 "command": "python", "args": ["-m", "market_data_mcp"]。

然后可以询问例如："2026 年 11 月 27 日 18:00 UTC 时，NYSE 开市吗？"、 "12 月的 ES 换月日期是什么？" 或 "显示当前美国收益率曲线和 2s10s 利差。 "