Market Data (x402)

io.github.r0dell由 GitHub 账号 r0dell 发布v0.5.0更新于 Nov 1, 2026

Paid-per-call data for agents: trading calendars, futures, macro, LEI, VAT, risk events (x402)

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

本地 MCP 服务器，为助手提供 53 个按次付费的市场数据工具（交易所时段、期货、宏观、日历、风险）及 5 个免费工具，通过 x402 以 USDC 付费。

可以做什么
  • 查询交易所开闭市、节假日、下次开闭市时间与交易倒计时
  • 查询期货主力合约、到期日、移仓日历、合约规格与持仓规模计算
  • 获取宏观数据：美债收益率曲线与利差、欧洲央行汇率、COT 持仓、参考利率、通胀
  • 查询日历：期权与 VIX 到期、经济数据发布、央行会议、国债招标、银行营业日、指数再平衡、支付截止时间
  • 执行风险与合规查询：天气预警、地震、FDA 召回、制裁名单筛查
  • 查询参考数据如 LEI、时区、欧盟增值税率、VIN、IBAN、BIC、国家与货币信息；免费工具可列出目录、支付状态与支持的市场
适用场景
适合助手需要准确的交易日历、期货、宏观或合规参考数据来回答市场分析、排期或结算问题时使用，前提是愿意为每次调用支付少量 USDC。
运行要求
通过 uvx（或 pip）在本地以 Python 运行，需要 uv 或 Python。付费工具需要一个在 Base 上有余额的 USDC 钱包，通过 X402_KEY_FILE 或 X402_PRIVATE_KEY 提供，可选设置 MAX_USDC_PER_CALL 与 MAX_USDC_PER_SESSION 预算。需要访问受 x402 保护的 HTTP API；免费工具无需密钥。
安装前请注意
付费工具会在 Base 主网上自动花费真实 USDC，受单次与单次启动上限约束（默认 0.05 与 1.00 USDC）。需要通过 X402_KEY_FILE 或 X402_PRIVATE_KEY 提供钱包私钥，应使用单独的小额钱包，切勿使用主钱包。数据按原样提供，不构成投资建议，关键日期应向交易所核实。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Market Data (x402)，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Market Data MCP

An MCP server that gives AI assistants and agents 53 paid data tools plus 5 free helper tools:

AreaToolsPrice per call
Exchange hoursmarket_is_open, market_next_open_close, market_holidays0.0205–0.0405 USDC
Futuresfutures_front_month, futures_expirations, futures_roll_calendar, crypto_futures_expiry0.0205–0.0405 USDC
Trading timesettlement_date, fx_sessions, dst_gaps, is_dst_gap, market_countdown0.0205–0.0405 USDC
Macrotreasury_yield_curve, treasury_spread, ecb_fx_rate, ecb_convert, cot_positioning, reference_rate, inflation0.0205–0.0405 USDC
Calendarsoptions_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, public_holidays, workdays, payment_cutoff0.0205–0.0405 USDC
Briefingtrading_briefing – all market-moving events of the next days in one call0.0455 USDC
Futures specscontract_spec, futures_tick_value, futures_position_size0.0205 USDC
Risk & complianceweather_alerts, earthquakes, fda_recalls, sanctions_check (OFAC, UN, EU, SECO)0.0385–0.0445 USDC
Referencelei_lookup, timezone_info, meeting_window, sun_moon, treasury_reporting_rate, eu_vat_rates, vin_decode, iban_check, bic_check, country_info, currency_info0.0225–0.0365 USDC
Freecatalog_list, payment_status, list_markets, list_futures_products, list_cot_marketsfree

Exchanges: NYSE, Nasdaq, LSE, Xetra, SIX, Tokyo, Hong Kong, Shanghai, ASX, CME equity futures. Futures: ES, MES, NQ, MNQ, YM, MYM, RTY, M2K, FDAX, FDXM, FESX, FSMI. Macro data comes from the U.S. Treasury (public domain), the ECB (euro reference rates; source: ECB statistics) the CFTC Commitments of Traders report, GLEIF (CC0), NWS, USGS, openFDA, U.S. Treasury Fiscal Data and NHTSA vPIC (public domain).

How payment works

Each paid tool calls an HTTP API protected by x402. The server pays automatically in USDC on Base, using a wallet key you provide, and only:

  • to the known wallets of these APIs (any other payee is refused),
  • in USDC on Base mainnet,
  • up to MAX_USDC_PER_CALL per call (default 0.05) and MAX_USDC_PER_SESSION per server start (default 1.00).

Without a key the free tools work and paid tools explain how to enable payment.

Use a separate, small wallet for X402_PRIVATE_KEY with only a few USDC on Base. Never use your main wallet. No ETH is needed for gas; the x402 facilitator pays it.

Install (Claude Desktop, Cursor, any MCP client)

Requires uv. Add this to your MCP client config (Claude Desktop: Settings → Developer → Edit Config):

json
{  "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 points to a file with the key (plain text or JSON with private_key); alternatively set X402_PRIVATE_KEY directly. Without uv: pip install x402-market-data-mcp and use "command": "python", "args": ["-m", "market_data_mcp"].

Then ask for example: "Is the NYSE open on 27 November 2026 at 18:00 UTC?", "What is the ES roll date in December?" or "Show the current US yield curve and the 2s10s spread."

Direct HTTP use

The same data is available as x402 HTTP APIs, listed in the Coinbase x402 Bazaar:

Disclaimer

Data is provided as is, without warranty. Not investment advice. Always confirm critical dates with the exchange.

License: MIT

来源：README.md，提交 4d31f6e

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：该软件包类型无法在沙箱中运行。

版本历史

3
  1. v0.5.0最新Nov 1, 2026
  2. v0.4.0Nov 1, 2026
  3. v0.2.1Oct 19, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分