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 分