支持 & 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 监控官方支持的发布版本,并在可行的情况下记录发布和收集证据。时间覆盖范围因来源和发布版本而异;publication_time_status 用于识别已确认、未验证、估计的历史和未知的发布时间。
包含哪些数据源?
宏观经济发布数据来自原始发布者,包括国家统计机构、政府部门以及诸如 ECB 和 RBA 之类的中央银行。请查阅每个序列' 来源元数据以获取其发布者和基础衡量指标。
我可以访问历史数据吗?
是的。通过个人、商业或企业订阅可获取完整的历史数据。非订阅用户可以访问免费的时间序列端点,获取最近 90 天的数据,每项发布在公布后 15 分钟可用。
哪些端点是免费的,哪些是付费的?
在没有 API 密钥且没有账户或过期的情况下,您可以使用 USD 公告数据(最近 90 天,每项发布在公布后 15 分钟可用)、USD 发布日历、数据目录、市场交易时段、USD 官方新闻稿以及 USD COT 头寸,每天最多 100 次请求。预测值(包括 USD)、实时发布、完整历史记录、非 USD 数据、FX 汇率和商品数据需要来自个人、商业或企业计划的 API 密钥。
支持多少种货币?
该平台总共覆盖 22 种货币,目前已发布 22 种货币的公开公告和目录覆盖范围,以及 20. 的发布日历覆盖范围。请参阅 文档 查看每个端点的覆盖范围详情。
账单 & 订阅
免费试用需要信用卡吗?
是的。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 密钥: X-API-Key: YOUR_API_KEY。也接受 Authorization: Bearer。从您的服务器调用 API:它不向浏览器发送 CORS 请求头。订阅后在 API 管理仪表板中查找您的密钥。
我的计划包含哪些支持?
所有付费计划均包括针对集成和数据问题的电子邮件支持。商业计划增加了优先支持,而企业协议可包含自定义 SLA 选项。请参阅 支持响应目标.
Quant & 回测
数据是否为时点数据 (point-in-time) / 无前瞻偏差?
时点回放取决于为每个数值版本保留的证据。请检查 announcement_datetime 连同 publication_time_status、publication_time_precision 和 vintage_status 一起使用。使用 as_of 配合 availability=public 或 availability=captured 来选择符合条件的历史值,然后检查 data_quality.point_in_time_safe。仅靠日期过滤器无法移除后续修订,且发布或采集时间戳并不能证明客户何时可以通过 API 读取该值。
我可以使用 pandas、NumPy 或回测框架使用这些数据吗?
是的。所有 API 响应都会返回干净的 JSON,可直接转换为 pd.DataFrame。announcement_datetime 和 generated_at 使用 Unix epoch 秒;本地时间字段使用带有偏移量的 ISO 8601 字符串。纳秒字段也具有十进制字符串变体以保持精度。请使用 pd.concat()在检查单位和时间戳证据后组合兼容序列。具备时间感知能力的连接可以使用 merge_asof.
修订后的数据值是否与初始发布的数据分开存储?
在保留的情况下,数值版本出现在 revisions[]。请求 revisions=all 以检查观测值的可用历史记录。如需重放,请使用 as_of 配合 revisions=latest,以在您的截止时间选择最新的合格版本。检查 vintage_status 和 is_first_release:最早捕获的值不一定是发布者's 首次发布,且并非每个序列都提供完整的修订历史。
历史数据可以追溯到多久?
历史深度因指标和央行来源而异。大多数主要指标(CPI、GDP、政策利率、失业率)至少涵盖 10 年。债券收益率和某些二级指标的历史较短。参见 指标目录 获取每个指标的覆盖详情。
我可以在研究出版物或产品中重新分发数据吗?
再分发权利取决于您的计划。个人和企业版涵盖您自己的内部使用。商业再分发是用于归属的人类可读客户显示的自助附加组件。试用结束后,按每个受众块每月 USD 10 计费,无论您的受众规模如何,均从一个块开始。一个块涵盖最多 100 个测量用户或接收者,或在公共社交或广播馈送中涵盖最多 1,000 个声明的关注者,并且每个注册界面都为账户级数量贡献块。原始 API 透传、批量文件、数据馈送和市场转售除外。没有申请、报价、审批队列或前置时间。请参阅 服务条款 获取完整详情。
为什么团队信任它
官方来源
发布数值来自官方发布机构、中央银行和统计局。
发布证据
检查发布状态、确认的日程表和数据库可用性,以进行发布监控和事件研究。
按序列查看历史记录
在进行回测之前,请先探索可用的经济历史数据,然后分别检查修订记录和发布证据。