支持 & 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 選項。參閱 支持響應目標.
量化 & 回測
數據是否為時點數據 / 無前瞻偏差？
時點回放取決於為每個數值版本所保留的證據。請檢查 announcement_datetime alongside 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 轉發、批量文件、數據饋送以及市場轉售。無需申請、報價、審批排隊或前置時間。請參閱 服務條款 獲取完整詳情。
需要幫助
仍有疑問？
如果文檔或常見問題 (FAQs) 未涵蓋您的使用案例，請聯繫我們並提供端點路徑、日期範圍和請求時間戳。
為什麼團隊信任它
官方來源
發佈值來自官方發佈機構、中央銀行和統計局。
發佈時間戳
公布行保留 UTC 發佈時間戳，用於事件研究、儀表板、研究作業和實時系統。
數十年的歷史
時點記錄顯示每個日期已知的信息，因此回測不會借用未來信息。