支持 & FAQ
查找常见问题的答案,或与我们的团队取得联系。
所有查询均通过一个收件箱处理: info@fxmacrodata.com.
热门端点
从高信号 API 调用开始
每个卡片将功能意图映射到具体的端点族和文档入口点。
公告
/api/v1/announcements/{currency}/{indicator}
带有发布时间戳的特定时间点发布值。
发布日历
/api/v1/calendar/{currency}
按货币和指标划分的即将到来的宏观公告。
外汇
/api/v1/forex/{base}/{quote}
带有可选技术叠加层的历史即期汇率。
利率 & 曲线
/api/v1/rate_differentials/{base}/{quote}
利差、曲线快照、斜率代理和衍生远期部分。
COT
/api/v1/cot/{currency}
来自 CFTC 报告的每周非商业持仓情况。
大宗商品
/api/v1/commodities/{indicator}
用于宏观体制分析的大宗商品和金属序列。
市场时段
/api/v1/market_sessions
主要 FX 会话窗口的当前开盘/收盘状态。
常见问题
数据 & 覆盖范围
数据的实时性如何?
对于受支持的实时发布,FXMacroData 会在官方来源发布数据后保留官方发布时间戳。
包含哪些数据源?
FXMacroData 从 FRED (美联储)、ECB、RBA 以及全球其他主要央行汇总数据。
我可以访问历史数据吗?
Yes. Full historical data is available with an Individual or Enterprise subscription. Non-subscribed users can access freemium time-series endpoints for the most recent 90 days, 15 minutes after each release is published.
哪些端点是免费的,哪些是付费的?
Calendar, data catalogue, and market sessions are public. Freemium time-series endpoints (USD announcements and USD predictions) are limited to the most recent 90 days for non-subscribed users and are delivered 15 minutes after publication. Real-time releases, full history, non-USD announcements, COT, and commodities require an API key from an Individual or Enterprise plan.
支持多少种货币?
The platform covers 22 currencies overall, with public announcements and catalogue coverage currently published for 22 currencies and release-calendar coverage published for 20. See the 文档 查看每个端点的覆盖范围详情。
账单 & 订阅
免费试用需要信用卡吗?
是的。14 天试用需要在注册时提供有效的信用卡。在试用结束前不会向您收费。
我可以随时取消吗?
是的,您可以在下一个计费周期之前在订阅设置中取消。无需任何理由。
免费试用结束时会发生什么?
除非在试用结束前取消,否则您的订阅会自动转换为付费计划。您可以在账单设置中进行管理。
如果我的付款方式失败了怎么办?
如果无法处理付款,账户访问可能会受到限制,直到账单信息更新。请参阅 账单条款 了解详情。
接受哪些付款方式?
我们通过安全的 Stripe 支付处理器接受所有主流信用卡 (Visa, Mastercard, Amex)。
技术 & 集成
您支持其他编程语言吗?
是的。官方 Python SDK 可通过以下方式获取 pip install fxmacrodata, 并且 REST API 可用于任何语言 —— Go, R, Java, C#, MATLAB, Rust 等。请参阅 快速入门指南 作为示例。
是否有用于 AI 助手的 MCP 服务器?
是的。FXMacroData 支持 Model Context Protocol (MCP),允许您将 Claude、Cursor 和其他 AI 工具直接连接到我们的数据。请参阅 MCP 服务器文档.
我如何对 API 请求进行身份验证?
将您的 API 密钥作为查询参数传递: ?api_key=YOUR_API_KEY. 订阅后,请在 API 管理控制台中查找您的密钥。
我的计划包含哪些支持?
所有付费计划均包含针对集成和数据问题的电子邮件支持。企业版计划增加了优先支持和自定义 SLA 选项。请参阅 支持响应目标.
Quant & 回测
数据是否为时点数据 (point-in-time) / 无前瞻偏差?
是的。每次发布都包含一个 announcement_datetime 字段 — 数据实际公开的时间,而不仅仅是参考期(例如 "Q3 2024"). 当您将历史数据集切片至给定日期时,您只能看到在该时间点之前已发布的内容,从而匹配实时交易条件。
我可以使用 pandas、NumPy 或回测框架使用这些数据吗?
是的。所有 API 响应都会返回干净的 JSON,可直接转换为 pd.DataFrame. 时间戳字段为 ISO 8601 字符串。所有支持货币的一致架构意味着您可以 pd.concat()无需重新格式化即可实现多货币 DataFrames。通过以下方式支持 vectorbt、backtrader 和自定义事件研究流水线: merge_asof.
修订后的数据值是否与初始发布的数据分开存储?
每条记录反映其发布时的数值 announcement_datetime. 修订版被记录为具有各自时间戳的单独发布内容,因此您可以重建任何历史时间点所掌握的信息,而不会混入后续的数据修订。
历史数据可以追溯到多久?
历史深度因指标和央行来源而异。大多数主要指标(CPI、GDP、政策利率、失业率)至少涵盖 10 年。债券收益率和某些二级指标的历史较短。参见 指标目录 获取每个指标的覆盖详情。
我可以在研究出版物或产品中重新分发数据吗?
再分发权利取决于您的计划。个人和企业版涵盖您自己的内部使用。商业再分发是用于归属的人类可读客户显示的自助附加组件。试用结束后,按每个受众块每月 USD 10 计费,无论您的受众规模如何,均从一个块开始。一个块涵盖最多 100 个测量用户或接收者,或在公共社交或广播馈送中涵盖最多 1,000 个声明的关注者,并且每个注册界面都为账户级数量贡献块。原始 API 透传、批量文件、数据馈送和市场转售除外。没有申请、报价、审批队列或前置时间。请参阅 服务条款 获取完整详情。
为什么团队信任它
官方来源
发布数值来自官方发布机构、中央银行和统计局。
发布时间戳
公告行保留 UTC 发布时间戳,用于事件研究、仪表板、研究任务和实时系统。
数十年的历史数据
时点记录显示了每个日期已知的信息,因此回测不会借用未来信息。