Support & FAQ
Find answers to common questions, or get in touch with our team.
Contact support
For billing, onboarding, API integration, or any other question, email us directly. We typically respond within 1 business day.
For service-level commitments, see the Support SLA.
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.
Frequently asked questions
Data & Coverage
How real-time is the data?
Announcement data is delivered in real time, within 50 milliseconds of official central bank publication.
Which data sources are included?
FXMacroData aggregates from FRED (Federal Reserve), ECB, RBA, and other major central banks worldwide.
Can I access historical data?
Yes. Full historical data is available with a Professional subscription. Non-subscribed users can access freemium time-series endpoints for the most recent 365 days.
Which endpoints are free vs paid?
Calendar, data catalogue, and market sessions are public. Freemium time-series endpoints (including USD announcements, USD predictions, and forex) are limited to the most recent 365 days for non-subscribed users. Full history, non-USD announcements, COT, and commodities require a Professional API key.
How many currencies are supported?
The platform covers 18 currencies overall, with public announcements and catalogue coverage currently published for 14 currencies and release-calendar coverage published for 18. See the documentation for the per-endpoint coverage details.
Billing & Subscription
Does the free trial require a credit card?
Yes. The 14-day trial requires a valid credit card at signup. You will not be charged until the trial ends.
Can I cancel anytime?
Yes, you can cancel from your subscription settings before your next billing cycle. No questions asked.
What happens when the free trial ends?
Your subscription automatically converts to the paid plan unless cancelled before trial end. You can manage this in your billing settings.
What if my payment method fails?
If payment cannot be processed, account access may be limited until billing information is updated. See billing terms for details.
What payment methods are accepted?
We accept all major credit cards (Visa, Mastercard, Amex) through our secure Stripe payment processor.
Technical & Integration
Do you support other programming languages?
Yes. The official Python SDK is available via pip install fxmacrodata, and the REST API works from any language — Go, R, Java, C#, MATLAB, Rust, and more. See quickstart guides for examples.
Is there an MCP server for AI assistants?
Yes. FXMacroData supports the Model Context Protocol (MCP), letting you connect Claude, Cursor, and other AI tools directly to our data. See the MCP server docs.
How do I authenticate API requests?
Pass your API key as a query parameter: ?api_key=YOUR_API_KEY. Find your key in the API management dashboard after subscribing.
What support is included with my plan?
All paid plans include email support for integration and data questions. Enterprise plans add priority support and custom SLA options. See support response targets.
Quant & Backtesting
Is the data point-in-time / free of lookahead bias?
Yes. Every release includes an announcement_datetime field — the actual time the data was made public, not just the reference period (e.g. "Q3 2024"). When you slice your historical dataset to a given date, you only see releases that were published by that point, matching live trading conditions.
Can I use this data with pandas, NumPy, or backtesting frameworks?
Yes. All API responses return clean JSON that converts directly to a pd.DataFrame. Timestamp fields are ISO 8601 strings. Consistent schema across all supported currencies means you can pd.concat()multi-currency DataFrames without reformatting. Works with vectorbt, backtrader, and custom event-study pipelines via merge_asof.
Are revised data values stored separately from initial releases?
Each record reflects the value as published at its announcement_datetime. Revisions are recorded as separate releases with their own timestamps, so you can reconstruct what was known at any historical point without mixing in later data revisions.
How far back does the historical data go?
Historical depth varies by indicator and central bank source. Most major indicators (CPI, GDP, policy rate, unemployment) cover at least 10 years. Bond yields and some secondary indicators have shorter histories. See the indicator catalogue for per-metric coverage details.
Can I redistribute the data in research publications or products?
Redistribution rights depend on your plan. The Individual plan is for personal use only. Startup and Enterprise plans include redistribution rights for websites, emails, and publications. API redistribution is not permitted on any plan. See Terms of Service for full details.
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.