fxmacrodata 1.1.0__tar.gz → 1.2.0__tar.gz

{fxmacrodata-1.1.0/fxmacrodata.egg-info → fxmacrodata-1.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: fxmacrodata
-Version: 1.1.0
+Version: 1.2.0
 Summary: Python client for the FXMacroData API, providing forex macroeconomic data for traders, quants, and analysts.
 Author-email: FXMacroData <info@fxmacrodata.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://fxmacrodata.com/?utm_source=pypi&utm_medium=package&utm_campaign=python_sdk
 Project-URL: Documentation, https://fxmacrodata.com/api/docs?utm_source=pypi&utm_medium=package&utm_campaign=python_sdk
 Project-URL: Source, https://github.com/fxmacrodata/fxmacrodata
@@ -14,8 +14,32 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.28
 Requires-Dist: aiohttp>=3.8
+Provides-Extra: openbb
+Requires-Dist: openbb>=4.7.2; extra == "openbb"
+Requires-Dist: openbb-core>=1.6.10; extra == "openbb"
+Provides-Extra: openbb-api
+Requires-Dist: openbb>=4.7.2; extra == "openbb-api"
+Requires-Dist: openbb-core>=1.6.10; extra == "openbb-api"
+Requires-Dist: openbb-platform-api>=1.3.6; extra == "openbb-api"
+Provides-Extra: openbb-cli
+Requires-Dist: openbb>=4.7.2; extra == "openbb-cli"
+Requires-Dist: openbb-core>=1.6.10; extra == "openbb-cli"
+Requires-Dist: openbb-cli>=1.0; extra == "openbb-cli"
+Provides-Extra: mcp
+Requires-Dist: openbb>=4.7.2; extra == "mcp"
+Requires-Dist: openbb-core>=1.6.10; extra == "mcp"
+Requires-Dist: openbb-mcp-server>=1.4.1; extra == "mcp"
+Provides-Extra: workspace
+Requires-Dist: fastapi>=0.100; extra == "workspace"
+Requires-Dist: uvicorn>=0.23; extra == "workspace"
 Provides-Extra: dev
+Requires-Dist: fastapi>=0.100; extra == "dev"
+Requires-Dist: httpx>=0.24; extra == "dev"
+Requires-Dist: httpx2>=2.0; extra == "dev"
+Requires-Dist: openbb-core>=1.6.10; extra == "dev"
+Requires-Dist: openbb-platform-api>=1.3.6; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: pytest-mock>=3.10; extra == "dev"
 Requires-Dist: python-dotenv>=1.1; extra == "dev"
 Requires-Dist: python-semantic-release>=7.23; extra == "dev"
@@ -25,6 +49,7 @@ Requires-Dist: ruff>=0.0; extra == "dev"
 Requires-Dist: mypy>=1.5; extra == "dev"
 Requires-Dist: black>=24.0; extra == "dev"
 Requires-Dist: types-requests>=2.28; extra == "dev"
+Requires-Dist: uvicorn>=0.23; extra == "dev"
 Dynamic: license-file
 
 # FXMacroData Python SDK 🐍📊
@@ -36,7 +61,7 @@ Dynamic: license-file
 
 The **FXMacroData Python SDK** provides a simple and efficient interface for fetching **macroeconomic indicators**, **forex prices**, **release calendars**, **COT positioning**, and **commodity prices** from [FXMacroData](https://fxmacrodata.com/?utm_source=github&utm_medium=readme&utm_campaign=python_sdk).  
 
-It includes both synchronous and asynchronous clients, supports free USD endpoints, and offers a free Forex Price API for exchange rate data.
+It includes both synchronous and asynchronous clients and supports free USD macro endpoints.
 
 ---
 
@@ -50,8 +75,8 @@ It includes both synchronous and asynchronous clients, supports free USD endpoin
   - **COT data** — CFTC Commitment of Traders positioning
   - **Commodity prices** — gold, silver, platinum
 - Free access to **USD** macro data.
-- Free **Forex Price API** (`get_fx_price`).
-- API key required only for **non-USD** indicators.
+- FX spot-rate history through `get_fx_price`.
+- API key required for protected datasets, including non-USD indicators, FX spot-rate history, COT, and commodities.
 - Full support for:
   - **Synchronous client**
   - **Asynchronous client**
@@ -92,7 +117,7 @@ data = client.get_indicator(
 )
 print(data)
 
-# Free Forex Price Endpoint
+# Forex price endpoint
 fx = client.get_fx_price("usd", "gbp", start_date="2025-01-01")
 print(fx)
 
@@ -131,7 +156,7 @@ async def main():
         data = await client.get_indicator("eur", "inflation")
         print(data)
 
-        # Free Forex Price Endpoint
+        # Forex price endpoint
         fx = await client.get_fx_price("usd", "jpy")
         print(fx)
 
@@ -156,6 +181,101 @@ asyncio.run(main())
 
 ---
 
+## OpenBB Integration
+
+FXMacroData supports all practical OpenBB integration paths from this package:
+
+- OpenBB Python: installable provider/router extension for `obb.fxmacrodata.*`.
+- OpenBB REST API: `/api/v1/fxmacrodata/*` routes through `openbb-api`.
+- OpenBB Workspace, generated: widgets generated by `openbb-api` from inline metadata.
+- OpenBB Workspace, custom: standalone backend serving `widgets.json`, `apps.json`, and data endpoints.
+- OpenBB MCP: tools exposed through `openbb-mcp`.
+- OpenBB CLI: commands available after `openbb-build`.
+
+OpenBB packages require Python 3.10+. Install the OpenBB Python extra:
+
+```bash
+pip install "fxmacrodata[openbb]"
+openbb-build
+```
+
+Then use FXMacroData from the OpenBB Python interface:
+
+```python
+from openbb import obb
+
+obb.user.credentials.fxmacrodata_api_key = "YOUR_API_KEY"
+
+catalogue = obb.fxmacrodata.data_catalogue(
+    currency="USD",
+    provider="fxmacrodata",
+).to_df()
+
+inflation = obb.fxmacrodata.macro_indicators(
+    currency="USD",
+    indicator="inflation",
+    start_date="2020-01-01",
+    provider="fxmacrodata",
+).to_df()
+
+eurusd = obb.fxmacrodata.fx_historical(
+    base="EUR",
+    quote="USD",
+    start_date="2024-01-01",
+    provider="fxmacrodata",
+).to_df()
+```
+
+Run the OpenBB REST API and generated Workspace backend:
+
+```bash
+pip install "fxmacrodata[openbb-api]"
+openbb-build
+fxmacrodata-openbb-api --host 127.0.0.1 --port 6900
+```
+
+Workspace can be connected to `http://127.0.0.1:6900`. The generated
+`/widgets.json` uses FXMacroData's inline OpenBB widget metadata.
+
+Run the OpenBB Workspace custom backend:
+
+```bash
+pip install "fxmacrodata[workspace]"
+fxmacrodata-openbb-backend
+```
+
+Default backend URL:
+
+```text
+http://127.0.0.1:7779
+```
+
+Workspace exposes `/widgets.json`, `/apps.json`, `/catalogue`,
+`/release_calendar`, `/macro_indicator`, `/forex`, `/cot`, and `/commodity`.
+Swagger/OpenAPI docs are disabled by default for this backend. For local
+debugging only, set `FXMACRODATA_OPENBB_ENABLE_DOCS=1` before starting it.
+
+Run OpenBB MCP:
+
+```bash
+pip install "fxmacrodata[mcp]"
+openbb-build
+fxmacrodata-openbb-mcp --default-categories fxmacrodata --host 127.0.0.1 --port 8001
+```
+
+Run OpenBB CLI:
+
+```bash
+pip install "fxmacrodata[openbb-cli]"
+openbb-build
+openbb
+```
+
+See `docs/openbb-integration.md` for the full integration matrix and the
+separate upstream OpenBB repository contribution path.
+
+---
+
 ## 📘 API Overview
 
 ### `get_indicator(currency, indicator, start_date=None, end_date=None)`
@@ -166,10 +286,10 @@ Fetches macroeconomic indicator time series data.
 - **API key required for non-USD.**
 
 ### `get_fx_price(base, quote, start_date=None, end_date=None, indicators=None)`
-Fetches daily FX spot rates (ECB reference rates) between two currencies.
+Fetches daily FX spot rates between two currencies.
 
 - `indicators`: Optional comma-separated technical indicators — `"sma_20"`, `"sma_50"`, `"sma_200"`, `"rsi_14"`, `"macd"`, `"ema_12"`, `"ema_26"`, `"bollinger_bands"`, or `"all"`.
-- **No API key needed.**
+- **API key required.**
 
 ### `get_calendar(currency, indicator=None)`
 Fetches upcoming economic data release dates for a currency.
@@ -199,25 +319,31 @@ Fetches commodity price time series.
 
 ## 💹 Supported Currencies & Indicators
 
+**18 currencies supported:** USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, HKD, SGD, NOK, PLN, SEK, DKK, BRL, CNY, KRW, MXN.
+
+The table below shows a sample of indicator coverage across four major currencies. Use `get_data_catalogue()` to discover the full list for any currency.
+
 | Category | Metric | USD | EUR | AUD | GBP |
 |---------|--------|-----|-----|-----|-----|
 | **Economy** | GDP Growth | ✓ | ✓ | ✓ | ✓ |
 |  | Inflation Rate | ✓ | ✓ | ✓ | ✓ |
 |  | Trade Balance | ✓ | ✓ | ✓ | ✓ |
 |  | Current Account Balance | ✓ | ✓ | ✓ | ✓ |
+|  | Retail Sales | ✓ | ✓ | ✓ | ✓ |
+|  | Industrial Production | ✓ | — | — | — |
 | **Labor Market** | Unemployment Rate | ✓ | ✓ | ✓ | ✓ |
-|  | Employment Level | ✓ | — | ✓ | ✓ |
-|  | Full-Time Employment | ✓ | — | ✓ | — |
-|  | Part-Time Employment | ✓ | — | ✓ | — |
-|  | Participation Rate | ✓ | — | ✓ | ✓ |
+|  | Employment Level | ✓ | ✓ | ✓ | ✓ |
+|  | Full-Time Employment | ✓ | ✓ | ✓ | — |
+|  | Part-Time Employment | ✓ | ✓ | ✓ | ✓ |
+|  | Participation Rate | ✓ | ✓ | ✓ | ✓ |
 |  | Non-Farm Payrolls | ✓ | — | — | — |
 | **Monetary Policy** | Policy Rate | ✓ | ✓ | ✓ | ✓ |
-|  | Interbank Rate | ✓ | ✓ | ✓ | ✓ |
-| **Government Bond Yields** | 2-Year Govt Bond | ✓ | ✓ | ✓ | — |
-|  | 3-Year Govt Bond | ✓ | ✓ | ✓ | — |
+|  | Risk-Free Rate | ✓ | ✓ | ✓ | ✓ |
+|  | Central Bank Assets | ✓ | — | ✓ | — |
+| **Government Bond Yields** | 2-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
 |  | 5-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
 |  | 10-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
-|  | Inflation-Linked Bond | ✓ | — | ✓ | ✓ |
+|  | Inflation-Linked Bond | ✓ | ✓ | ✓ | ✓ |
 
 ---
 

fxmacrodata-1.1.0/PKG-INFO → fxmacrodata-1.2.0/README.md

@@ -1,32 +1,3 @@
-Metadata-Version: 2.4
-Name: fxmacrodata
-Version: 1.1.0
-Summary: Python client for the FXMacroData API, providing forex macroeconomic data for traders, quants, and analysts.
-Author-email: FXMacroData <info@fxmacrodata.com>
-License: MIT
-Project-URL: Homepage, https://fxmacrodata.com/?utm_source=pypi&utm_medium=package&utm_campaign=python_sdk
-Project-URL: Documentation, https://fxmacrodata.com/api/docs?utm_source=pypi&utm_medium=package&utm_campaign=python_sdk
-Project-URL: Source, https://github.com/fxmacrodata/fxmacrodata
-Project-URL: Issues, https://github.com/fxmacrodata/fxmacrodata
-Keywords: forex,macro data,macroeconomics,trading,quant,economic indicators,fxmacrodata,rapidapi
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.28
-Requires-Dist: aiohttp>=3.8
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10; extra == "dev"
-Requires-Dist: python-dotenv>=1.1; extra == "dev"
-Requires-Dist: python-semantic-release>=7.23; extra == "dev"
-Requires-Dist: twine>=4.0; extra == "dev"
-Requires-Dist: build>=1.0; extra == "dev"
-Requires-Dist: ruff>=0.0; extra == "dev"
-Requires-Dist: mypy>=1.5; extra == "dev"
-Requires-Dist: black>=24.0; extra == "dev"
-Requires-Dist: types-requests>=2.28; extra == "dev"
-Dynamic: license-file
-
 # FXMacroData Python SDK 🐍📊
 
 ![PyPI Version](https://img.shields.io/pypi/v/fxmacrodata?color=blue&logo=python&style=flat-square)
@@ -36,7 +7,7 @@ Dynamic: license-file
 
 The **FXMacroData Python SDK** provides a simple and efficient interface for fetching **macroeconomic indicators**, **forex prices**, **release calendars**, **COT positioning**, and **commodity prices** from [FXMacroData](https://fxmacrodata.com/?utm_source=github&utm_medium=readme&utm_campaign=python_sdk).  
 
-It includes both synchronous and asynchronous clients, supports free USD endpoints, and offers a free Forex Price API for exchange rate data.
+It includes both synchronous and asynchronous clients and supports free USD macro endpoints.
 
 ---
 
@@ -50,8 +21,8 @@ It includes both synchronous and asynchronous clients, supports free USD endpoin
   - **COT data** — CFTC Commitment of Traders positioning
   - **Commodity prices** — gold, silver, platinum
 - Free access to **USD** macro data.
-- Free **Forex Price API** (`get_fx_price`).
-- API key required only for **non-USD** indicators.
+- FX spot-rate history through `get_fx_price`.
+- API key required for protected datasets, including non-USD indicators, FX spot-rate history, COT, and commodities.
 - Full support for:
   - **Synchronous client**
   - **Asynchronous client**
@@ -92,7 +63,7 @@ data = client.get_indicator(
 )
 print(data)
 
-# Free Forex Price Endpoint
+# Forex price endpoint
 fx = client.get_fx_price("usd", "gbp", start_date="2025-01-01")
 print(fx)
 
@@ -131,7 +102,7 @@ async def main():
         data = await client.get_indicator("eur", "inflation")
         print(data)
 
-        # Free Forex Price Endpoint
+        # Forex price endpoint
         fx = await client.get_fx_price("usd", "jpy")
         print(fx)
 
@@ -156,6 +127,101 @@ asyncio.run(main())
 
 ---
 
+## OpenBB Integration
+
+FXMacroData supports all practical OpenBB integration paths from this package:
+
+- OpenBB Python: installable provider/router extension for `obb.fxmacrodata.*`.
+- OpenBB REST API: `/api/v1/fxmacrodata/*` routes through `openbb-api`.
+- OpenBB Workspace, generated: widgets generated by `openbb-api` from inline metadata.
+- OpenBB Workspace, custom: standalone backend serving `widgets.json`, `apps.json`, and data endpoints.
+- OpenBB MCP: tools exposed through `openbb-mcp`.
+- OpenBB CLI: commands available after `openbb-build`.
+
+OpenBB packages require Python 3.10+. Install the OpenBB Python extra:
+
+```bash
+pip install "fxmacrodata[openbb]"
+openbb-build
+```
+
+Then use FXMacroData from the OpenBB Python interface:
+
+```python
+from openbb import obb
+
+obb.user.credentials.fxmacrodata_api_key = "YOUR_API_KEY"
+
+catalogue = obb.fxmacrodata.data_catalogue(
+    currency="USD",
+    provider="fxmacrodata",
+).to_df()
+
+inflation = obb.fxmacrodata.macro_indicators(
+    currency="USD",
+    indicator="inflation",
+    start_date="2020-01-01",
+    provider="fxmacrodata",
+).to_df()
+
+eurusd = obb.fxmacrodata.fx_historical(
+    base="EUR",
+    quote="USD",
+    start_date="2024-01-01",
+    provider="fxmacrodata",
+).to_df()
+```
+
+Run the OpenBB REST API and generated Workspace backend:
+
+```bash
+pip install "fxmacrodata[openbb-api]"
+openbb-build
+fxmacrodata-openbb-api --host 127.0.0.1 --port 6900
+```
+
+Workspace can be connected to `http://127.0.0.1:6900`. The generated
+`/widgets.json` uses FXMacroData's inline OpenBB widget metadata.
+
+Run the OpenBB Workspace custom backend:
+
+```bash
+pip install "fxmacrodata[workspace]"
+fxmacrodata-openbb-backend
+```
+
+Default backend URL:
+
+```text
+http://127.0.0.1:7779
+```
+
+Workspace exposes `/widgets.json`, `/apps.json`, `/catalogue`,
+`/release_calendar`, `/macro_indicator`, `/forex`, `/cot`, and `/commodity`.
+Swagger/OpenAPI docs are disabled by default for this backend. For local
+debugging only, set `FXMACRODATA_OPENBB_ENABLE_DOCS=1` before starting it.
+
+Run OpenBB MCP:
+
+```bash
+pip install "fxmacrodata[mcp]"
+openbb-build
+fxmacrodata-openbb-mcp --default-categories fxmacrodata --host 127.0.0.1 --port 8001
+```
+
+Run OpenBB CLI:
+
+```bash
+pip install "fxmacrodata[openbb-cli]"
+openbb-build
+openbb
+```
+
+See `docs/openbb-integration.md` for the full integration matrix and the
+separate upstream OpenBB repository contribution path.
+
+---
+
 ## 📘 API Overview
 
 ### `get_indicator(currency, indicator, start_date=None, end_date=None)`
@@ -166,10 +232,10 @@ Fetches macroeconomic indicator time series data.
 - **API key required for non-USD.**
 
 ### `get_fx_price(base, quote, start_date=None, end_date=None, indicators=None)`
-Fetches daily FX spot rates (ECB reference rates) between two currencies.
+Fetches daily FX spot rates between two currencies.
 
 - `indicators`: Optional comma-separated technical indicators — `"sma_20"`, `"sma_50"`, `"sma_200"`, `"rsi_14"`, `"macd"`, `"ema_12"`, `"ema_26"`, `"bollinger_bands"`, or `"all"`.
-- **No API key needed.**
+- **API key required.**
 
 ### `get_calendar(currency, indicator=None)`
 Fetches upcoming economic data release dates for a currency.
@@ -199,25 +265,31 @@ Fetches commodity price time series.
 
 ## 💹 Supported Currencies & Indicators
 
+**18 currencies supported:** USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD, HKD, SGD, NOK, PLN, SEK, DKK, BRL, CNY, KRW, MXN.
+
+The table below shows a sample of indicator coverage across four major currencies. Use `get_data_catalogue()` to discover the full list for any currency.
+
 | Category | Metric | USD | EUR | AUD | GBP |
 |---------|--------|-----|-----|-----|-----|
 | **Economy** | GDP Growth | ✓ | ✓ | ✓ | ✓ |
 |  | Inflation Rate | ✓ | ✓ | ✓ | ✓ |
 |  | Trade Balance | ✓ | ✓ | ✓ | ✓ |
 |  | Current Account Balance | ✓ | ✓ | ✓ | ✓ |
+|  | Retail Sales | ✓ | ✓ | ✓ | ✓ |
+|  | Industrial Production | ✓ | — | — | — |
 | **Labor Market** | Unemployment Rate | ✓ | ✓ | ✓ | ✓ |
-|  | Employment Level | ✓ | — | ✓ | ✓ |
-|  | Full-Time Employment | ✓ | — | ✓ | — |
-|  | Part-Time Employment | ✓ | — | ✓ | — |
-|  | Participation Rate | ✓ | — | ✓ | ✓ |
+|  | Employment Level | ✓ | ✓ | ✓ | ✓ |
+|  | Full-Time Employment | ✓ | ✓ | ✓ | — |
+|  | Part-Time Employment | ✓ | ✓ | ✓ | ✓ |
+|  | Participation Rate | ✓ | ✓ | ✓ | ✓ |
 |  | Non-Farm Payrolls | ✓ | — | — | — |
 | **Monetary Policy** | Policy Rate | ✓ | ✓ | ✓ | ✓ |
-|  | Interbank Rate | ✓ | ✓ | ✓ | ✓ |
-| **Government Bond Yields** | 2-Year Govt Bond | ✓ | ✓ | ✓ | — |
-|  | 3-Year Govt Bond | ✓ | ✓ | ✓ | — |
+|  | Risk-Free Rate | ✓ | ✓ | ✓ | ✓ |
+|  | Central Bank Assets | ✓ | — | ✓ | — |
+| **Government Bond Yields** | 2-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
 |  | 5-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
 |  | 10-Year Govt Bond | ✓ | ✓ | ✓ | ✓ |
-|  | Inflation-Linked Bond | ✓ | — | ✓ | ✓ |
+|  | Inflation-Linked Bond | ✓ | ✓ | ✓ | ✓ |
 
 ---
 

{fxmacrodata-1.1.0 → fxmacrodata-1.2.0}/fxmacrodata/async_client.py

@@ -60,7 +60,7 @@ class AsyncClient:
         return await self._request(url, params, headers)
 
     # ------------------------------------------------------------------
-    # FX spot rates (free)
+    # FX spot rates
     # ------------------------------------------------------------------
     async def get_fx_price(
         self,
@@ -80,7 +80,10 @@ class AsyncClient:
             params["end_date"] = end_date
         if indicators:
             params["indicators"] = indicators
-        return await self._request(url, params, {})
+        if not self.api_key:
+            raise FXMacroDataError("API key required for forex endpoints.")
+        headers = {"X-API-Key": self.api_key}
+        return await self._request(url, params, headers)
 
     # ------------------------------------------------------------------
     # Release calendar

{fxmacrodata-1.1.0 → fxmacrodata-1.2.0}/fxmacrodata/client.py

@@ -50,7 +50,7 @@ class Client:
         return self._request(url, params, headers)
 
     # ------------------------------------------------------------------
-    # FX spot rates (free)
+    # FX spot rates
     # ------------------------------------------------------------------
     def get_fx_price(
         self,
@@ -70,7 +70,10 @@ class Client:
             params["end_date"] = end_date
         if indicators:
             params["indicators"] = indicators
-        return self._request(url, params, {})
+        if not self.api_key:
+            raise FXMacroDataError("API key required for forex endpoints.")
+        headers = {"X-API-Key": self.api_key}
+        return self._request(url, params, headers)
 
     # ------------------------------------------------------------------
     # Release calendar

fxmacrodata-1.2.0/fxmacrodata/openbb/__init__.py

@@ -0,0 +1,94 @@
+"""OpenBB integration for the FXMacroData Python package.
+
+This module registers FXMacroData as an OpenBB provider extension. The
+user-facing commands live in :mod:`fxmacrodata.openbb.router`.
+
+Install the main package with the OpenBB extra and run ``openbb-build`` so
+OpenBB discovers the router and provider entry points::
+
+    pip install "fxmacrodata[openbb]"
+    openbb-build
+
+Then use the OpenBB Python interface::
+
+    from openbb import obb
+
+    obb.user.credentials.fxmacrodata_api_key = "YOUR_KEY"
+    df = obb.fxmacrodata.fx_historical(
+        base="EUR",
+        quote="USD",
+        provider="fxmacrodata",
+    ).to_df()
+
+Fetcher classes can also be imported directly from
+``fxmacrodata.openbb.models`` for lower-level tests and integrations::
+
+    from fxmacrodata.openbb.models.macro_indicators import (
+        FXMacroDataMacroIndicatorsFetcher,
+    )
+"""
+
+from typing import Any
+
+__version__ = "0.1.0"
+
+_OpenBBProvider: Any = None
+try:
+    from openbb_core.provider.abstract.provider import Provider as _ImportedProvider
+except ModuleNotFoundError as exc:
+    if exc.name != "openbb_core":
+        raise
+else:
+    _OpenBBProvider = _ImportedProvider
+
+if _OpenBBProvider is None:
+    fxmacrodata_provider = None
+    __all__ = ["fxmacrodata_provider"]
+else:
+    from fxmacrodata.openbb.models.commodities import FXMacroDataCommodityFetcher
+    from fxmacrodata.openbb.models.cot import FXMacroDataCotFetcher
+    from fxmacrodata.openbb.models.data_catalogue import FXMacroDataDataCatalogueFetcher
+    from fxmacrodata.openbb.models.forex import FXMacroDataFxHistoricalFetcher
+    from fxmacrodata.openbb.models.macro_indicators import (
+        FXMacroDataMacroIndicatorsFetcher,
+    )
+    from fxmacrodata.openbb.models.release_calendar import (
+        FXMacroDataReleaseCalendarFetcher,
+    )
+
+    __all__ = [
+        "fxmacrodata_provider",
+        "FXMacroDataCotFetcher",
+        "FXMacroDataCommodityFetcher",
+        "FXMacroDataDataCatalogueFetcher",
+        "FXMacroDataFxHistoricalFetcher",
+        "FXMacroDataMacroIndicatorsFetcher",
+        "FXMacroDataReleaseCalendarFetcher",
+    ]
+
+    fxmacrodata_provider = _OpenBBProvider(
+        name="fxmacrodata",
+        website="https://fxmacrodata.com",
+        description=(
+            "FXMacroData provides macroeconomic indicator time series, FX spot "
+            "rates, CFTC Commitment of Traders positioning, commodity prices, "
+            "and economic release calendars from official government and "
+            "central-bank publications for FX market analysis."
+        ),
+        # OpenBB stores this as ``fxmacrodata_api_key`` in user credentials.
+        credentials=["api_key"],
+        fetcher_dict={
+            # Usage: obb.fxmacrodata.data_catalogue(currency="USD")
+            "FXMacroDataDataCatalogue": FXMacroDataDataCatalogueFetcher,
+            # Usage: obb.fxmacrodata.macro_indicators(currency="USD", indicator="inflation")
+            "FXMacroDataMacroIndicators": FXMacroDataMacroIndicatorsFetcher,
+            # Usage: obb.fxmacrodata.fx_historical(base="AUD", quote="USD")
+            "FXMacroDataFxHistorical": FXMacroDataFxHistoricalFetcher,
+            # Usage: obb.fxmacrodata.cot(currency="EUR")
+            "FXMacroDataCot": FXMacroDataCotFetcher,
+            # Usage: obb.fxmacrodata.commodity(indicator="gold")
+            "FXMacroDataCommodity": FXMacroDataCommodityFetcher,
+            # Usage: obb.fxmacrodata.release_calendar(currency="USD")
+            "FXMacroDataReleaseCalendar": FXMacroDataReleaseCalendarFetcher,
+        },
+    )