canonical: https://jentic.com/apis/fxmacrodata.com/fxmacrodata # FX Macrodata API The FX Macrodata API serves official-source macroeconomic and FX market data across 22 currencies. It returns FX spot and timestamped reference rates, macroeconomic indicator values with release calendars, central-bank policy rates and press releases, financial prices and yield curves, CFTC Commitment of Traders positioning, and commodity indicators. Point-in-time research panels reconstruct the values known at each decision time, and a risk-sentiment indicator tracks the global risk-on and risk-off state. USD data is available without a key, while other currencies and datasets require one. ## For AI agents Read official FX reference rates, macroeconomic indicators, release calendars, central-bank rates, COT positioning, and commodity data across 22 currencies. Authenticates with an API key in the X-API-Key header or a Bearer token; USD data is open. ## Scope Does not handle trade execution, brokerage accounts, or portfolio management. Use for reading macroeconomic and FX reference data only. ## Capabilities - Read official FX spot and timestamped reference rates across 22 currencies - Pull macroeconomic indicator values and upcoming release calendars by currency - Read central-bank policy rates, press releases, financial prices, and yield curves - Retrieve CFTC Commitment of Traders positioning and commodity indicator data - Page official forecast vintages and per-indicator prediction coverage by publisher - Build a point-in-time research panel of values known at each decision time - Track the global risk-on and risk-off sentiment indicator and its recorded changes ## Use cases ### AI Agent Macro Lookup via Jentic An AI agent reaches FX Macrodata through Jentic to ground a market question in official data without wiring the X-API-Key header itself. It searches by intent, receives the matching operation and its input schema, and executes the read with the key injected at run time. This lets the agent cite a dated reference rate or indicator value rather than guess at a macro figure. Example prompt: Search Jentic for 'latest macro indicators for a currency', load the GET `/v1/announcements/{currency}/latest` schema, and execute it with the X-API-Key injected at run time ### Economic Calendar Watch A trading or research workflow tracks upcoming economic releases and reads the new values as they land. FX Macrodata returns the release calendar for a currency and the latest indicator values once a figure is published, so an agent can react to a surprise against the forecast. The announcement-changes endpoint lets it poll for freshly released data. Example prompt: Call GET `/v1/calendar/{currency}` to read upcoming releases, then GET `/v1/announcements/{currency}/latest` after a release to read the new values ### FX Reference Rate Lookup An accounting or pricing workflow needs an official, timestamped FX reference rate for a currency pair. FX Macrodata returns the official reference rate and session-close rates from public sources, so an agent can value a position or a transaction against a rate it can cite. Rate differentials between a pair are available for carry and relative-value work. Example prompt: Call GET `/v1/fx/reference-rates/{base}/{quote}` to read the official timestamped reference rate for a currency pair ### Positioning and Sentiment Analysis A macro strategy reads speculative positioning and the prevailing risk mood. FX Macrodata returns CFTC Commitment of Traders positioning for a currency and a global risk-on or risk-off indicator, so an agent can weigh crowding against sentiment. Recorded sentiment changes let it see when the regime last flipped. Example prompt: Call GET `/v1/cot/{currency}` for Commitment of Traders positioning and GET `/v1/risk_sentiment` for the current risk-on or risk-off reading ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/forex/{base}/{quote}` | Get FX spot rates | | GET | `/v1/fx/reference-rates/{base}/{quote}` | Official timestamped FX reference rates | | GET | `/v1/announcements/{currency}/latest` | Latest values for all indicators in a currency | | GET | `/v1/calendar/{currency}` | Upcoming economic data release dates | | GET | `/v1/cot/{currency}` | CFTC Commitment of Traders positioning | | GET | `/v1/commodities/latest` | Latest values for all commodity indicators | | GET | `/v1/predictions/{currency}/{indicator}` | Forecasts for one indicator of a currency | | GET | `/v1/risk_sentiment` | Global risk-on / risk-off indicator | ## Key resources - **FX Rates** — Read spot, reference, session-close, and intraday rates via `/v1/forex` and `/v1/fx/reference-rates` - **Macro Indicators** — Read indicator values, calendars, and catalogues via `/v1/announcements`, `/v1/calendar`, and `/v1/data_catalogue` - **Central Bank and Prices** — Read policy press releases, financial prices, and curves via `/v1/press-releases`, `/v1/financial_prices`, and `/v1/curves` - **Positioning and Forecasts** — Read COT, commodities, forecasts, and sentiment via `/v1/cot`, `/v1/commodities`, `/v1/predictions`, and `/v1/risk_sentiment` ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 59 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 89 / 100 - Developer Experience & Jentic Compatibility: 60 / 100 - AI-Readiness & Agent Experience: 41 / 100 - Agent Usability: 94 / 100 - Security: 42 / 100 - AI Discoverability: 77 / 100 - **View full report:** https://jentic.com/apis/fxmacrodata.com/fxmacrodata/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring FX Macrodata by hand means sending the X-API-Key header or a Bearer token, knowing which datasets are open for USD and which need a key, and handling the SSE announcement stream yourself. Through Jentic you install once, import FX Macrodata from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** FX Macrodata puts the currency and pair in the URL path, such as `/v1/announcements/{currency}/latest` and `/v1/forex/{base}/{quote}`, so a rule can limit your agent to the currencies and datasets it needs and nothing else. You choose which operations it may call, so the intraday subscriber streams are not reachable unless you add them. - **Credential handling:** Your FX Macrodata key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'official EUR USD reference rate' or 'upcoming economic releases', and Jentic returns the matching FX Macrodata operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Alpha Vantage** — FX, equities, and economic-indicator data over a simple REST API - **Finnhub** — Market data, company fundamentals, and an economic calendar - **Polygon** — Real-time and historical price data for stocks, options, forex, and crypto ## FAQ ### What authentication does the FX Macrodata API use? The FX Macrodata API accepts an API key in the X-API-Key header or as a Bearer token in the Authorization header, per its OpenAPI spec. USD data is available without a key, while other currencies and datasets require one. A deprecated api_key query parameter is still accepted, mainly for browser EventSource stream clients that cannot set headers. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never reaches the agent. ### What are the rate limits for the FX Macrodata API? The OpenAPI spec does not specify request rate limits. Access tiers gate which currencies and datasets a key can read instead: USD data is open, and other datasets need a key. See https://api.fxmacrodata.com for current limits and plans. ### Can I read macroeconomic indicators with the FX Macrodata API? Yes. GET `/v1/announcements/{currency}/latest` returns the latest values for every indicator in a currency, GET `/v1/announcements/{currency}/{indicator}` returns one indicator's series, and GET `/v1/calendar/{currency}` lists upcoming releases. Central-bank press releases and financial prices are available per currency alongside them. ### Is there an FX Macrodata MCP server? You don't need an MCP server to give your agent FX Macrodata. Jentic connects it directly from the API Directory: import it and your agent calls the rates, indicator, and positioning operations on demand, discovering each operation's schema when it needs it rather than loading a separate server's tool definitions into context. ### How do I read the latest indicators for a currency through Jentic? Search Jentic for 'latest macro indicators for a currency', and it returns the FX Macrodata announcements operation with its input schema. Load it and execute GET `/v1/announcements/{currency}/latest` with the key injected at run time. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the FX Macrodata API? Yes. Because FX Macrodata carries the currency and pair in the URL path, write a rule that allows only the reads a task needs for specific currencies, for example the calendar and announcements for the euro and the dollar, so the agent cannot pull the intraday streams or other currencies. Every call runs through your own instance, so each one is logged for you to review.