rate-api-python 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl

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.dist-info → rate_api_python-1.0.3.dist-info}/METADATA

@@ -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.3.dist-info/RECORD

@@ -0,0 +1,6 @@
+rate_api/__init__.py,sha256=CCLo6o7REOyFcqTcJULKSyEoNHVCvIbIbLZa-0-_8pU,6532
+rate_api_python-1.0.3.dist-info/licenses/LICENSE,sha256=nCjIn_oDw98qUrGtfT5o19Qk02nDpkr3xbKgFtu3Z0A,1069
+rate_api_python-1.0.3.dist-info/METADATA,sha256=8kLKSBgWirgKwyJX_HxMIm9r5tRm90VQyEbD0v0d-GM,3713
+rate_api_python-1.0.3.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+rate_api_python-1.0.3.dist-info/top_level.txt,sha256=y8GBQa9yzwxT17UjU9xreA4yPbHqup7c0ryMbx1gYzI,9
+rate_api_python-1.0.3.dist-info/RECORD,,

rate_api_python-1.0.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-rate_api/__init__.py,sha256=3LBJWynyZ2cr1LSgqf77q3uDz9cvmZPglp2jlvJidhU,8314
-rate_api_python-1.0.1.dist-info/licenses/LICENSE,sha256=nCjIn_oDw98qUrGtfT5o19Qk02nDpkr3xbKgFtu3Z0A,1069
-rate_api_python-1.0.1.dist-info/METADATA,sha256=LE0rCncMicYuGjtDvdxxLyd2T4EW6cFFnKA-gwj1TA8,4358
-rate_api_python-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-rate_api_python-1.0.1.dist-info/top_level.txt,sha256=y8GBQa9yzwxT17UjU9xreA4yPbHqup7c0ryMbx1gYzI,9
-rate_api_python-1.0.1.dist-info/RECORD,,