fxmacrodata 0.1.0__py3-none-any.whl

fxmacrodata/__init__.py

@@ -0,0 +1,6 @@
+from .client import Client
+from .async_client import AsyncClient
+from .exceptions import FXMacroDataError
+from .utils import sort_by_date
+
+__all__ = ["Client", "AsyncClient", "FXMacroDataError", "sort_by_date"]

fxmacrodata/async_client.py

@@ -0,0 +1,59 @@
+import aiohttp  # type: ignore
+from typing import Optional
+from .exceptions import FXMacroDataError
+
+
+class AsyncClient:
+    BASE_URL = "https://fxmacrodata.com/api"
+
+    def __init__(self, api_key: Optional[str] = None):
+        """
+        Asynchronous FXMacroData Client.
+        api_key: Required for non-USD currencies. USD is public.
+        """
+        self.api_key: Optional[str] = api_key
+        self.session: Optional[aiohttp.ClientSession] = None
+
+    async def __aenter__(self) -> "AsyncClient":
+        self.session = aiohttp.ClientSession()
+        return self
+
+    async def __aexit__(self, exc_type, exc_val, exc_tb) -> None:
+        if self.session:
+            await self.session.close()
+            self.session = None
+
+    async def get(
+        self,
+        currency: str,
+        indicator: str,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> dict:
+        currency = currency.lower()
+        url = f"{self.BASE_URL}/{currency}/{indicator}"
+
+        headers = {}
+        if currency != "usd":
+            if not self.api_key:
+                raise FXMacroDataError(
+                    f"API key required for {currency.upper()} endpoints."
+                )
+            headers["X-API-Key"] = self.api_key
+
+        params = {}
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+
+        if not self.session:
+            self.session = aiohttp.ClientSession()
+
+        assert self.session is not None  # mypy now knows session is initialized
+
+        async with self.session.get(url, headers=headers, params=params) as resp:
+            if resp.status != 200:
+                text = await resp.text()
+                raise FXMacroDataError(f"{resp.status} - {text}")
+            return await resp.json()

fxmacrodata/client.py

@@ -0,0 +1,48 @@
+import requests
+from typing import Optional
+from .exceptions import FXMacroDataError
+
+
+class Client:
+    BASE_URL = "https://fxmacrodata.com/api"
+
+    def __init__(self, api_key: Optional[str] = None):
+        """
+        Synchronous FXMacroData Client.
+        api_key: Required for non-USD currencies. USD is public.
+        """
+        self.api_key = api_key
+
+    def get(
+        self,
+        currency: str,
+        indicator: str,
+        start_date: Optional[str] = None,
+        end_date: Optional[str] = None,
+    ) -> dict:
+        currency = currency.lower()
+        url = f"{self.BASE_URL}/{currency}/{indicator}"
+
+        headers = {}
+        if currency != "usd":
+            if not self.api_key:
+                raise FXMacroDataError(
+                    f"API key required for {currency.upper()} endpoints."
+                )
+            headers["X-API-Key"] = self.api_key
+
+        params = {}
+        if start_date:
+            params["start_date"] = start_date
+        if end_date:
+            params["end_date"] = end_date
+
+        try:
+            response = requests.get(url, headers=headers, params=params)
+        except Exception as e:
+            raise FXMacroDataError(f"Request failed: {e}")
+
+        if response.status_code != 200:
+            raise FXMacroDataError(f"{response.status_code} - {response.text}")
+
+        return response.json()

fxmacrodata/exceptions.py

@@ -0,0 +1,4 @@
+class FXMacroDataError(Exception):
+    """Custom exception for FXMacroData client errors."""
+
+    pass

fxmacrodata/utils.py

@@ -0,0 +1,3 @@
+def sort_by_date(data_list):
+    """Sorts a list of indicator data dictionaries by 'date' or 'release_date'."""
+    return sorted(data_list, key=lambda x: x.get("date") or x.get("release_date"))

fxmacrodata-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: fxmacrodata
+Version: 0.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)
+![Python Versions](https://img.shields.io/pypi/pyversions/fxmacrodata?style=flat-square)
+![License](https://img.shields.io/github/license/yourusername/fxmacrodata?style=flat-square)
+![Build](https://img.shields.io/github/actions/workflow/status/yourusername/fxmacrodata/python-package.yml?style=flat-square&logo=github)
+
+The **FXMacroData Python SDK** is a lightweight, easy-to-use client for fetching **forex macroeconomic data** from [FXMacroData](https://fxmacrodata.com/?utm_source=github&utm_medium=readme&utm_campaign=python_sdk).  
+
+It supports **synchronous** and **asynchronous** requests, provides ready-to-use JSON responses, and enforces API keys only for non-USD endpoints. Perfect for developers, quants, and algo traders.
+
+---
+
+## 🌟 Features
+
+- Fetch **policy rates, CPI, inflation, GDP, unemployment**, and other macroeconomic indicators.
+- Supports **USD (free)** and **other currencies via RapidAPI key**.
+- **Async-first** design for bulk data fetching.
+- Works with **Python 3.9+**.
+- Compatible with **TradingBots, Jupyter Notebooks, Backtests**.
+- Minimal dependencies: `requests`, `aiohttp`.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install fxmacrodata
+```
+
+Or install the latest version from GitHub:
+
+```bash
+pip install git+https://github.com/yourusername/fxmacrodata.git
+```

fxmacrodata-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+fxmacrodata/__init__.py,sha256=H3XZGyqfS_Yx1KIVSQ62-l1oNos4udWdHZcncvuqQJA,211
+fxmacrodata/async_client.py,sha256=o1Hp6CkY-GkGbhvG27OO1sL_A7VSpe2HK14zGwJIovk,1852
+fxmacrodata/client.py,sha256=Pjn1ZfD8PpP-CKcvLV1UmWqYR1Nxc4eSnPeTIwFL-f0,1374
+fxmacrodata/exceptions.py,sha256=Mv1SP0RZ-dCmKysi2l1ythhLhVc-J7zsBTJCSiGe4Xk,103
+fxmacrodata/utils.py,sha256=B1f9vPJfVUS2wXwMBrLTYZbyHV9LYrm0B-zBUYuFi4g,195
+fxmacrodata-0.1.0.dist-info/licenses/LICENSE,sha256=7qtf-IvAp1ZLUzJ52T3FhWhPr56stYxCnaumn3TDbBU,1068
+fxmacrodata-0.1.0.dist-info/METADATA,sha256=UGFnhE3XEY4LBb5Uf-9Mnlgx0RwzgboHF1ucPtwX1N0,2775
+fxmacrodata-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fxmacrodata-0.1.0.dist-info/top_level.txt,sha256=g4wStAnsNrEJfApHUVU3AISpc5w-r4khkVvEPg-10S4,12
+fxmacrodata-0.1.0.dist-info/RECORD,,

fxmacrodata-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fxmacrodata-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FXMacroData
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fxmacrodata-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fxmacrodata