围绕中国 CPI、GDP、贸易、就业、PBOC 利率、黄金和 USD/CNY 事件风险，使用同一套 API、MCP、Python、仪表盘和经济日历工作流。
Trial/Individual limit 100,000/day. Individual: USD 25/month. 最终金额以 Stripe Checkout 为准。
USD endpoint 可在无 API key 情况下每天测试 100 次。订阅后可使用 API key、更高 limit、完整历史、CNY 及所有支持市场。
从这里开始
中国工作流
区域入口
按中文用户常见市场选择工作流
面向中国宏观、PBOC、CPI、GDP、贸易和人民币事件风险的主入口。
把美元、人民币、黄金和实际利率研究放在同一个 release-aware workflow 中。
为使用中文工作的 Asia FX、AI 和数据团队提供 API docs、coverage 和可复用入口。
暂时还不需要 key？创建免费账户，先接收 CNY 与 USD 宏观发布提醒。
Why teams trust it
Official sources
Release values come from official publishers, central banks, and statistics offices.
Release timestamps
Announcement rows preserve UTC release timestamps for event studies, dashboards, research jobs, and live systems.
Decades of history
Point-in-time records show what was known at each date, so backtests do not borrow future information.
Start here
Go directly to the data, workflows, and licensing that fit how you work.
Track releases, compare macro conditions, and move into pair-level dashboards.
For product teams Build with the APIUse examples, dashboards, widgets, and deployment patterns in your own product.
For agents AI and automationConnect models and agent frameworks through MCP, REST, and structured context.
For organizations Enterprise dataPlan team access, service requirements, governance, and commercial usage.
Explore macro data
Research library
Product workbench
FXMacroData is not just a list of endpoints. The same announcement-timestamped records connect human review, code, dashboards, and agent workflows.
Browse confirmed macro events by currency, local time, source, and release type before the data lands in a workflow.
REST API Pull the release recordUse production endpoints with consistent fields for value, announcement time, source context, pagination, and forecasts.
GET /v1/announcements/usd/inflation
{
"date": "2026-06-30",
"val": 2.7,
"announcement_datetime": 1784032200
}Review EUR/USD around macro events, then move into the same pair, release, and endpoint in code.
MCP and AI Give agents sourced macro contextLet AI tools call FXMacroData instead of relying on model memory, then return source-linked research payloads.
产品价值
Live reporting、point-in-time history、经济日历、API、MCP、export 和仪表盘共用同一批 release-aware record。
把 PBOC、NBS 和官方宏观事件接入发布工作流。
发布时间戳成为研究、告警和回测的时间边界。
模型只读取当时已经公开的 CNY、USD 和黄金相关记录。
announcement_datetime <= model_time
Use central-bank and statistics-office release records with announcement timestamps for alerts, dashboards, and FX research systems.
Backtest against decades of records that preserve when each macro value was known to the market.
了解更多 ->Plan around upcoming macro releases by currency through dashboards, API access, and refreshable calendar feeds.
了解更多 ->Use browser tools for CFD macro maps, point-in-time backtests, FX pairs trading, and carry-trade research.
了解更多 ->Ask AI tools for release-aware macro context without manually copying tables between apps.
了解更多 ->Copy tested prompts for macro briefings, event risk, pair research, backtests, visuals, and MCP-native agent workflows.
了解更多 ->Download release-aware macro history for notebooks, spreadsheets, archives, and downstream model inputs.
了解更多 ->Bring announcement-timestamped releases and point-in-time history into notebooks, jobs, dashboards, and production systems.
了解更多 ->Market summary, pair dashboards, calendars, COT, commodities, bond yields, sessions, and press releases.
了解更多 ->回测覆盖
先检查 CNY、USD、黄金和指标覆盖，再按发布时间戳构建事件窗口、监控规则和 point-in-time backtest。
Currency
17 覆盖 FX 市场API path
21 可用 dataset历史深度
26y point-in-time recordsCPI, core inflation, trimmed means, PPI, PCE, and inflation-expectation releases where published.
Unemployment, employment levels, payrolls, participation, job openings, and wage measures.
Policy rates, risk-free rates, deposit rates, liquidity settings, and official balance-sheet releases.
GDP, retail sales, industrial production, durable goods, business confidence, consumer confidence, and other activity indicators.
Trade balances, current accounts, import/export data, terms of trade, and commodity-linked activity series.
Money supply, credit aggregates, central-bank reserves, FX reserves, and gold-reserve series.
Housing starts, permits, approvals, house-price indexes, and mortgage-rate series.
Government yield nodes, inflation-linked yields, breakevens, and curve-ready rates history.
API endpoint directory
浏览 predictions、announcements、release calendar、FX prices、commodities、COT、press releases、sessions、sovereign data、trade 和其他 REST surface。
Forecast Layer
A unified forecast layer attached to every macro release. Surveys, central-bank own projections, IMF World Economic Outlook, and the FXMacroData blended forecast — all returned as a list of predictions on each announcement, joined to actuals via a stable announcement_id.
/api/v1/predictions/{currency}/{indicator}
打开示例
Common docs paths
/api/v1/calendar/{currency}
Calendar docs
Actual values
Read published values and previous rows after an announcement is released.
/api/v1/announcements/{currency}/{indicator}
Announcement docs
Forecasts
Join market consensus, central-bank, IMF, and FXMacroData forecasts to each release.
/api/v1/predictions/{currency}/{indicator}
Forecast docs
Quickstart and keys
Create a key, use query-parameter auth, and copy starter Python requests.
api_key=YOUR_API_KEY
Quickstart
health
Health checks and low-friction API availability probes.
/api/v1/ping
Ping the API
Always freedata catalogue
Discovery and metadata for available indicators by currency.
/api/v1/data_catalogue/{currency}
Get Currently Available Macroeconomic Indicators
Always freeannouncements
Macroeconomic announcement time series with official release timestamps.
/api/v1/announcements/{currency}/latest
Get latest stored values for all indicators in a currency
Always free/api/v1/announcements/{currency}/{indicator}
Get macroeconomic indicator data
Pro (USD: no-key 100/day)predictions
Forecasts, consensus, central-bank projections, and FXMacroData predictions.
/api/v1/predictions/{currency}/{indicator}
List predictions for one indicator of a currency
Pro (USD: no-key 100/day)calendar
Upcoming macro and policy release schedules.
/api/v1/calendar/{currency}
Get upcoming economic data release dates
Always freerelease events
Polling, SSE, and WebSocket delivery for newly ingested economic releases.
/api/v1/announcements/changes
Poll recent live announcement release changes
Mixed access/api/v1/stream/events
Subscribe to real-time announcement events (SSE)
Mixed accessfactors
Precomputed macro factor scores for model inputs and cross-currency comparison.
/api/v1/factors/{currency}/{factor}
Get a precomputed FX factor for one currency
Pro (USD: no-key 100/day)fx reference rates
Daily FX spot history plus one subscriber intraday FX reference-rate endpoint.
/api/v1/forex/{base}/{quote}
Get FX spot rates
Professional subscriber API key required/api/v1/fx/intraday-reference-rates/{base}/{quote}
Get subscriber intraday FX reference rates
Professional subscriber API key required/api/v1/fx/source-universe
List public FX reference-rate pair universe
Always free/api/v1/fx/sources
List public FX reference-rate sources
Always freerates curves
Yield-curve views and pair rate differentials for rates-aware FX analysis.
/api/v1/curves/{currency}
Get curve analytics by currency
Professional subscriber API key required/api/v1/rate_differentials/{base}/{quote}
Get pair rate differentials
Professional subscriber API key requiredmarket context
FX market-session status and broad risk-on/risk-off context for timing and regime filters.
/api/v1/market_sessions
FX market session timetable
Always free/api/v1/risk_sentiment
Global risk-on / risk-off indicator
Always freecot positioning
CFTC Commitment of Traders futures positioning by currency.
/api/v1/cot/{currency}
Get CFTC Commitment of Traders (COT) data
Pro (USD: no-key 100/day)commodities
Precious metals, OPEC, and commodity-related endpoints.
/api/v1/commodities/latest
Get latest stored values for all commodity indicators
Professional subscriber API key required/api/v1/commodities/{indicator}
Get commodity indicator data
Professional subscriber API key requiredofficial updates
Central-bank press releases and policy communications from official sources.
/api/v1/press-releases/{currency}
Recent central bank press releases
Pro (USD: no-key 100/day)AI data layer
Assistant、notebook、dashboard 和 alert 使用同一批 timestamped release record，让中文解释、USD/CNY 研究和 backtest 共用数据边界。
{
"tool": "indicator_query",
"currency": "USD",
"indicator": "inflation",
"mcp_metadata": {
"source_type": "official",
"has_announcement_datetime": true,
"point_in_time_safe": true,
"returned_count": 100
},
"next_step": "join EUR/USD around the release window"
}AI answer 和 backtest 依赖同样的字段：timing、provenance、freshness 和 reproducible endpoint access。
Open source integrations
Explore a growing catalogue of merged integrations for FX research, backtesting, and macro-event-aware workflows.
工作场景
从页面判断到 API、MCP、告警和 downstream delivery，保持同一套宏观数据边界。
Latest research
Dollar softness was broad, but the silver slide left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-08-02 07:00 UTC
Dollar softness was broad, but the silver slide left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-08-01 07:00 UTC
Dollar softness was broad, but the silver slide left the cross-asset read unconfirmed. Rate spreads and positioning are the next tests.
2026-07-31 07:00 UTC
Reviews
Builder 使用 FXMacroData 把 release calendar、macro indicators、FX data 和 positioning context 接入透明、可审计的研究 workflow。
查看 Built with FXMacroData“FXMacroData has been extremely valuable for AXIOM FX because it gives us structured access to macroeconomic indicators, release calendars, FX data and positioning information in one place. It helps us build a more transparent, auditable and institutional-style macro research workflow.”
Plans
API access and product tools for retail investors and independent researchers.
Enterprise Institutional data accessGoverned access for institutional and sophisticated-investor workflows.
Add-on Commercial redistributionAdd rights to display or distribute FXMacroData inside your product.
FAQ
CNY macro docs、USD/CNY workflow、黄金页面、API examples、MCP tools 和 point-in-time announcements。
不是。中文 pack 连接中国宏观、PBOC、CNY docs、黄金和中文搜索发现，而不是只翻译英文首页。
Predictions endpoint 可读取可用的 consensus、survey、central-bank、IMF 和 forecast rows，并与 realised announcements join。
按 announcement_datetime join CNY 与 USD macro rows，只把当时已公开的数据传给模型。
Support
告诉我们 market、indicator 和 use case：live monitoring、historical research、AI workflow 或 redistribution。