rate-api-python 1.0.1__tar.gz → 1.0.3__tar.gz

{rate_api_python-1.0.1/rate_api_python.egg-info → rate_api_python-1.0.3}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: rate-api-python
-Version: 1.0.1
+Version: 1.0.3
 Summary: Official Python client for the Rate-API.com exchange-rate & crypto API
-Author-email: Vilgar <digitalbrainsllc@gmail.com>
+Author-email: Vilgar <digitalbrainsam@gmail.com>
 License: MIT
 Project-URL: Homepage, https://rate-api.com
 Project-URL: Documentation, https://rate-api.com/en/docs
@@ -49,39 +49,20 @@ print(rates["rates"]["EUR"])
 client.convert("USD", "EUR", 100)                 # Pro+
 client.historical("2026-01-15", "USD", ["EUR"])   # Pro+
 client.pair("USD", "EUR")                          # single pair
-client.timeseries("2026-01-01", "2026-01-31")     # Business+
-client.fluctuation("2026-01-01", "2026-01-31")    # Business+
 client.crypto(["BTC", "ETH"])                      # Pro+
 client.currencies()                                # supported currencies
+client.usage()                                     # current-month usage vs quota
 client.health()                                    # public
 
 try:
-    client.timeseries("2020-01-01", "2026-12-31")
+    client.convert("USD", "ZZZ", 100)
 except RateApiError as e:
-    print(e, e.status)   # "Date range too large. Maximum is 366 days." 400
+    print(e, e.status)   # "Invalid target currency" 400
 ```
 
-## v2 features
+## Methods
 
-The client exposes the v2 endpoints directly (they resolve to `/api/v2` regardless of base URL):
-
-```python
-# Latest with 24h change, metadata and precision
-r = client.latest_v2("USD", ["EUR", "GBP"], include_change=True, include_metadata=True, precision=4)
-print(r["changes_pct"]["EUR"])
-
-# Historical comparison between two dates (Pro+)
-cmp = client.historical_compare("2026-01-15", "2026-01-01", "USD", ["EUR"])
-
-# Batch conversion — up to 100 pairs in one call (Pro+)
-batch = client.batch_convert([
-    {"from": "USD", "to": "EUR", "amount": 100},
-    {"from": "GBP", "to": "JPY", "amount": 50},
-])
-
-# Your configured rate alerts (Business+)
-alerts = client.alerts()
-```
+`latest` · `convert` · `pair` · `historical` · `crypto` · `currencies` · `usage` · `quota` · `health`
 
 ## Errors
 

{rate_api_python-1.0.1 → rate_api_python-1.0.3}/README.md

@@ -21,39 +21,20 @@ print(rates["rates"]["EUR"])
 client.convert("USD", "EUR", 100)                 # Pro+
 client.historical("2026-01-15", "USD", ["EUR"])   # Pro+
 client.pair("USD", "EUR")                          # single pair
-client.timeseries("2026-01-01", "2026-01-31")     # Business+
-client.fluctuation("2026-01-01", "2026-01-31")    # Business+
 client.crypto(["BTC", "ETH"])                      # Pro+
 client.currencies()                                # supported currencies
+client.usage()                                     # current-month usage vs quota
 client.health()                                    # public
 
 try:
-    client.timeseries("2020-01-01", "2026-12-31")
+    client.convert("USD", "ZZZ", 100)
 except RateApiError as e:
-    print(e, e.status)   # "Date range too large. Maximum is 366 days." 400
+    print(e, e.status)   # "Invalid target currency" 400
 ```
 
-## v2 features
+## Methods
 
-The client exposes the v2 endpoints directly (they resolve to `/api/v2` regardless of base URL):
-
-```python
-# Latest with 24h change, metadata and precision
-r = client.latest_v2("USD", ["EUR", "GBP"], include_change=True, include_metadata=True, precision=4)
-print(r["changes_pct"]["EUR"])
-
-# Historical comparison between two dates (Pro+)
-cmp = client.historical_compare("2026-01-15", "2026-01-01", "USD", ["EUR"])
-
-# Batch conversion — up to 100 pairs in one call (Pro+)
-batch = client.batch_convert([
-    {"from": "USD", "to": "EUR", "amount": 100},
-    {"from": "GBP", "to": "JPY", "amount": 50},
-])
-
-# Your configured rate alerts (Business+)
-alerts = client.alerts()
-```
+`latest` · `convert` · `pair` · `historical` · `crypto` · `currencies` · `usage` · `quota` · `health`
 
 ## Errors
 

{rate_api_python-1.0.1 → rate_api_python-1.0.3}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rate-api-python"
-version = "1.0.1"
+version = "1.0.3"
 description = "Official Python client for the Rate-API.com exchange-rate & crypto API"
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.8"
 keywords = ["exchange-rate", "currency", "forex", "crypto", "api", "rate-api"]
-authors = [{ name = "Vilgar", email = "digitalbrainsllc@gmail.com" }]
+authors = [{ name = "Vilgar", email = "digitalbrainsam@gmail.com" }]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",

{rate_api_python-1.0.1 → rate_api_python-1.0.3}/rate_api/__init__.py

@@ -12,7 +12,7 @@ import urllib.error
 import urllib.parse
 import urllib.request
 
-__version__ = "1.0.1"
+__version__ = "1.0.3"
 __all__ = ["RateApiClient", "RateApiError", "RateLimitError", "RateApiTimeoutError"]
 
 
@@ -56,14 +56,6 @@ class RateApiClient:
     def pair(self, from_currency, to_currency):
         return self._get(f"pair/{urllib.parse.quote(from_currency)}/{urllib.parse.quote(to_currency)}")
 
-    def timeseries(self, start_date, end_date, base="USD", symbols=None):
-        return self._get("timeseries", self._with_symbols(
-            {"start_date": start_date, "end_date": end_date, "base": base}, symbols))
-
-    def fluctuation(self, start_date, end_date, base="USD", symbols=None):
-        return self._get("fluctuation", self._with_symbols(
-            {"start_date": start_date, "end_date": end_date, "base": base}, symbols))
-
     def crypto(self, symbols=None):
         query = {"symbols": ",".join(symbols)} if symbols else {}
         return self._get("crypto", query)
@@ -71,42 +63,18 @@ class RateApiClient:
     def currencies(self):
         return self._get("currencies")
 
+    def usage(self):
+        """This key's current-month usage vs. its plan quota."""
+        return self._get("usage")
+
+    def quota(self):
+        """Lean plan-quota / remaining-requests view."""
+        return self._get("quota")
+
     def health(self):
+        """Public service status + rate-data freshness (no key needed)."""
         return self._request(f"{self.base_url}/health", {})
 
-    # ---- v2 endpoints (resolve to /api/v2 regardless of the configured base) ----
-
-    def _v2_base(self):
-        if self.base_url.endswith("/v1"):
-            return self.base_url[:-3] + "/v2"
-        return self.base_url.replace("/v1/", "/v2/")
-
-    def latest_v2(self, base="USD", symbols=None, include_metadata=False, include_change=False, precision=None):
-        """v2 latest with metadata / 24h change / precision options."""
-        query = self._with_symbols({"base": base}, symbols)
-        if include_metadata:
-            query["include_metadata"] = "true"
-        if include_change:
-            query["include_change"] = "true"
-        if precision is not None:
-            query["precision"] = precision
-        return self._request(f"{self._v2_base()}/{self.api_key}/latest", query)
-
-    def historical_compare(self, date, compare_date=None, base="USD", symbols=None):
-        """v2 historical with an optional compare_date for per-currency deltas (Pro+)."""
-        query = self._with_symbols({"date": date, "base": base}, symbols)
-        if compare_date:
-            query["compare_date"] = compare_date
-        return self._request(f"{self._v2_base()}/{self.api_key}/historical", query)
-
-    def batch_convert(self, conversions):
-        """v2 batch conversion: list of {"from","to","amount"} dicts (Pro+). Max 100."""
-        return self._request(f"{self._v2_base()}/{self.api_key}/batch-convert", {}, method="POST", body=conversions)
-
-    def alerts(self):
-        """List your configured rate alerts (Business+). Manage them in the dashboard."""
-        return self._request(f"{self._v2_base()}/{self.api_key}/alerts", {})
-
     @staticmethod
     def _with_symbols(query, symbols):
         if symbols:

{rate_api_python-1.0.1 → rate_api_python-1.0.3/rate_api_python.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: rate-api-python
-Version: 1.0.1
+Version: 1.0.3
 Summary: Official Python client for the Rate-API.com exchange-rate & crypto API
-Author-email: Vilgar <digitalbrainsllc@gmail.com>
+Author-email: Vilgar <digitalbrainsam@gmail.com>
 License: MIT
 Project-URL: Homepage, https://rate-api.com
 Project-URL: Documentation, https://rate-api.com/en/docs
@@ -49,39 +49,20 @@ print(rates["rates"]["EUR"])
 client.convert("USD", "EUR", 100)                 # Pro+
 client.historical("2026-01-15", "USD", ["EUR"])   # Pro+
 client.pair("USD", "EUR")                          # single pair
-client.timeseries("2026-01-01", "2026-01-31")     # Business+
-client.fluctuation("2026-01-01", "2026-01-31")    # Business+
 client.crypto(["BTC", "ETH"])                      # Pro+
 client.currencies()                                # supported currencies
+client.usage()                                     # current-month usage vs quota
 client.health()                                    # public
 
 try:
-    client.timeseries("2020-01-01", "2026-12-31")
+    client.convert("USD", "ZZZ", 100)
 except RateApiError as e:
-    print(e, e.status)   # "Date range too large. Maximum is 366 days." 400
+    print(e, e.status)   # "Invalid target currency" 400
 ```
 
-## v2 features
+## Methods
 
-The client exposes the v2 endpoints directly (they resolve to `/api/v2` regardless of base URL):
-
-```python
-# Latest with 24h change, metadata and precision
-r = client.latest_v2("USD", ["EUR", "GBP"], include_change=True, include_metadata=True, precision=4)
-print(r["changes_pct"]["EUR"])
-
-# Historical comparison between two dates (Pro+)
-cmp = client.historical_compare("2026-01-15", "2026-01-01", "USD", ["EUR"])
-
-# Batch conversion — up to 100 pairs in one call (Pro+)
-batch = client.batch_convert([
-    {"from": "USD", "to": "EUR", "amount": 100},
-    {"from": "GBP", "to": "JPY", "amount": 50},
-])
-
-# Your configured rate alerts (Business+)
-alerts = client.alerts()
-```
+`latest` · `convert` · `pair` · `historical` · `crypto` · `currencies` · `usage` · `quota` · `health`
 
 ## Errors