支持与常见问题
查找常见问题的答案,或联系我们的团队。
All inquiries are handled through one inbox: [email protected].
Support intake
Compose a faster triage email
Include endpoint and request context so we can diagnose issues faster.
Status
Platform Health
For incident timelines and component-level updates, see the external feed: fxmacrodata.statuspage.io.
Top help links
Get unstuck faster
Popular endpoints
Start With High-Signal API Calls
Each card maps feature intent to a concrete endpoint family and docs entry point.
Announcements
/api/v1/announcements/{currency}/{indicator}
Point-in-time release values with announcement timestamps.
Release Calendar
/api/v1/calendar/{currency}
Upcoming macro announcements by currency and indicator.
Forex
/api/v1/forex/{base}/{quote}
Historical spot rates with optional technical overlays.
Rates & Curves
/api/v1/rate_differentials/{base}/{quote}
Carry spreads, curve snapshots, slope proxies, and derived forward segments.
COT
/api/v1/cot/{currency}
Weekly non-commercial positioning from CFTC reporting.
Commodities
/api/v1/commodities/{indicator}
Commodity and metals series used in macro regime analysis.
Market Sessions
/api/v1/market_sessions
Current open/close state for major FX session windows.
常见问题
数据与覆盖范围
数据实时性如何?
公告数据实时交付,在官方央行发布后50毫秒内。
包含哪些数据源?
FXMacroData 聚合来自 FRED(美联储)、ECB、RBA 和全球其他主要中央银行的数据。
我可以访问历史数据吗?
是的,所有可用指标的完整历史数据都包含在支持的货币中。
哪些端点是免费的,哪些是付费的?
日历、数据目录、外汇和市场会话是公开的。USD 公告是公开的,而非 USD 公告需要专业版 API 密钥。COT 和商品始终需要专业版 API 密钥。
支持多少种货币?
该平台总共覆盖18种货币,其中14种货币已发布公开公告和目录覆盖范围,18种货币已发布发布日历覆盖范围。请参阅 文档 以获取每个端点的覆盖范围详情。
账单与订阅
免费试用需要信用卡吗?
是的。14天试用期在注册时需要有效的信用卡。在试用期结束前,您不会被收费。
我可以随时取消吗?
是的,您可以在下一个计费周期之前从订阅设置中取消。无需任何理由。
免费试用期结束后会发生什么?
除非在试用期结束前取消,否则您的订阅将自动转换为付费计划。您可以在账单设置中管理此项。
如果我的支付方式失败怎么办?
如果无法处理付款,账户访问可能会受到限制,直到账单信息更新。请参阅 账单条款 了解详情。
接受哪些支付方式?
我们通过安全的 Stripe 支付处理器接受所有主要信用卡(Visa、Mastercard、Amex)。
技术与集成
你们支持其他编程语言吗?
是的。官方 Python SDK 可通过 pip install fxmacrodata提供,并且 REST API 适用于任何语言——Go、R、Java、C#、MATLAB、Rust 等。请参阅 快速入门指南 获取示例。
有适用于 AI 助手的 MCP 服务器吗?
是的。FXMacroData 支持模型上下文协议 (MCP),让您可以将 Claude、Cursor 和其他 AI 工具直接连接到我们的数据。请参阅 MCP 服务器文档.
如何验证 API 请求?
将您的 API 密钥作为查询参数传递: ?api_key=YOUR_API_KEY。订阅后在 API 管理仪表板中查找您的密钥。
我的计划包含哪些支持?
所有付费计划都包含针对集成和数据问题的电子邮件支持。企业计划增加了优先支持和自定义 SLA 选项。请参阅 支持响应目标.
量化与回测
数据是否是时间点数据/没有前瞻性偏差?
是的。每次发布都包含一个 announcement_datetime 字段——数据实际公开的时间,而不仅仅是参考期(例如“2024年第三季度”)。当您将历史数据集切片到给定日期时,您只会看到在该时间点之前发布的版本,这与实时交易条件相符。
我可以将这些数据与 pandas、NumPy 或回测框架一起使用吗?
是的。所有 API 响应都返回可以直接转换为 pd.DataFrame的干净 JSON。时间戳字段是 ISO 8601 字符串。所有支持的货币都采用一致的模式,这意味着您可以 pd.concat()多币种 DataFrames,无需重新格式化。通过以下方式与 vectorbt、backtrader 和自定义事件研究管道配合使用 merge_asof.
修订后的数据值是否与初始发布分开存储?
每条记录都反映了其发布时的值 announcement_datetime。修订作为单独的发布记录,并带有自己的时间戳,因此您可以在不混入后续数据修订的情况下,重构任何历史时间点已知的信息。
历史数据可以追溯到多久以前?
历史深度因指标和央行来源而异。大多数主要指标(CPI、GDP、政策利率、失业率)至少覆盖10年。债券收益率和一些次要指标的历史较短。请参阅 指标目录 以获取每个指标的覆盖范围详情。
我可以在研究出版物或产品中重新分发数据吗?
再分发权限取决于您的计划。个人计划仅供个人使用。创业和企业计划包括网站、电子邮件和出版物的再分发权限。任何计划都不允许 API 再分发。请参阅 服务条款 以获取完整详情。
Need help
Still have questions?
If docs or FAQs do not cover your use case, contact us and include the endpoint path, date range, and request timestamp.
Why teams trust it
Official sources
Release values come from official publishers, central banks, and statistics offices.
Sub-second reporting
New announcements are packaged for alerts, dashboards, research jobs, and live systems as soon as they are reported.
Decades of history
Point-in-time records show what was known at each date, so backtests do not borrow future information.