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: info@fxmacrodata.com.
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?
FXMacroData monitors supported official releases and records publication and collection evidence where available. Timing coverage varies by source and release; publication_time_status identifies confirmed, unverified, estimated historical, and unknown publication times.
Which data sources are included?
Macroeconomic releases come from original publishers, including national statistics agencies, government departments, and central banks such as the ECB and RBA. Consult each series' source metadata for its publisher and underlying measure.
Can I access historical data?
Yes. Full historical data is available with an Individual, Business 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.
Which endpoints are free vs paid?
Without an API key, and with no account or expiry, you can use USD announcement data for the most recent 90 days (each release 15 minutes after publication), the USD release calendar, the data catalogue, market sessions, USD official press releases, and USD COT positioning, up to 100 requests per day. Forecast values (USD included), real-time releases, full history, non-USD data, FX rates, and commodities require an API key from an Individual, Business or Enterprise plan.
How many currencies are supported?
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 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?
Send your API key in a request header: X-API-Key: YOUR_API_KEY. Authorization: Bearer is also accepted. Call the API from your server: it does not send CORS headers to browsers. 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. Business adds priority support, and Enterprise agreements can include custom SLA options. See support response targets.
Quant & Backtesting
Is the data point-in-time / free of lookahead bias?
Point-in-time replay depends on the evidence retained for each value vintage. Check announcement_datetime alongside publication_time_status, publication_time_precision, and vintage_status. Use as_of with availability=public or availability=captured to select eligible historical values, then inspect data_quality.point_in_time_safe. A date filter alone does not remove later revisions, and a publication or collection timestamp does not prove when a customer could read the value through the API.
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. announcement_datetime and generated_at use Unix epoch seconds; local-time fields use ISO 8601 strings with an offset. Nanosecond fields also have decimal-string variants to preserve precision. Use pd.concat()to combine compatible series after checking units and timestamp evidence. Time-aware joins can use merge_asof.
Are revised data values stored separately from initial releases?
Where retained, value vintages appear in revisions[]. Request revisions=all to inspect the available history for an observation. For replay, use as_of with revisions=latest to select the latest eligible vintage at your cutoff. Check vintage_status and is_first_release: the earliest captured value is not necessarily the publisher's first print, and complete revision history is not available for every series.
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. Individual and Enterprise cover your own internal use. Commercial Redistribution is the self-service add-on for attributed human-readable customer display. After the trial it is billed at USD 10 per audience block per month, starting at one block whatever your audience size. A block covers up to 100 measured users or recipients, or up to 1,000 declared followers on a public social or broadcast feed, and every registered surface contributes blocks to one account-level quantity. Raw API pass-through, bulk files, data feeds, and marketplace resale are excluded. There is no application, quote, approval queue, or lead time. 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.
Publication evidence
Inspect publication status, confirmed schedules and database availability for release monitoring and event studies.
History by series
Explore available economic history, then check retained revisions and publication evidence separately before a backtest.