afp-sdk 0.5.2__tar.gz → 0.5.4__tar.gz

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [v0.5.4] - 2025-11-05
+
+### Added
+
+- Add `afp.exceptions.RateLimitExceeded` exception type ([#37](https://github.com/autonity/afp-sdk/pull/37))
+- Add trading fee rate to `afp.schemas.OrderFill` structure ([#39](https://github.com/autonity/afp-sdk/pull/39))
+
+### Changed
+
+- Update for interface changes in the AutEx exchange ([#36](https://github.com/autonity/afp-sdk/pull/36))
+
+## [v0.5.3] - 2025-10-29
+
+### Added
+
+- Add `Trading.ohlcv()` and `Trading.iter_ohlcv()` methods for querying OHLCV time series data ([#34](https://github.com/autonity/afp-sdk/pull/34))
+
+### Changed
+
+- Change `Trading.orders()`, `Trading.order_fills()` and `Trading.iter_order_fills()` to allow filtering items by intent account ID ([#33](https://github.com/autonity/afp-sdk/pull/33))
+
 ## [v0.5.2] - 2025-10-04
 
 ### Added
@@ -57,6 +78,8 @@
 
 _First public release for Forecastathon._
 
+[v0.5.4]: https://github.com/autonity/afp-sdk/releases/tag/v0.5.4
+[v0.5.3]: https://github.com/autonity/afp-sdk/releases/tag/v0.5.3
 [v0.5.2]: https://github.com/autonity/afp-sdk/releases/tag/v0.5.2
 [v0.5.1]: https://github.com/autonity/afp-sdk/releases/tag/v0.5.1
 [v0.5.0]: https://github.com/autonity/afp-sdk/releases/tag/v0.5.0

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afp-sdk
-Version: 0.5.2
+Version: 0.5.4
 Summary: Autonomous Futures Protocol Python SDK
 Keywords: autonity,web3,trading,crypto,prediction,forecast,markets
 License-Expression: MIT

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/afp/api/trading.py

@@ -1,6 +1,6 @@
 import secrets
 import warnings
-from datetime import datetime
+from datetime import datetime, timedelta
 from decimal import Decimal
 from typing import Generator, Iterable
 
@@ -16,6 +16,7 @@ from ..schemas import (
     Intent,
     IntentData,
     MarketDepthData,
+    OHLCVItem,
     Order,
     OrderFilter,
     OrderCancellationData,
@@ -123,8 +124,9 @@ class Trading(ExchangeAPI):
 
         Raises
         ------
-        afp.exceptions.ValidationError
-            If the exchange rejects the intent.
+        afp.exceptions.RateLimitExceeded
+            If the exchange rejects the order because of too many requests from the
+            authenticated account.
         """
         submission = OrderSubmission(
             type=OrderType.LIMIT_ORDER,
@@ -146,8 +148,13 @@ class Trading(ExchangeAPI):
 
         Raises
         ------
+        afp.exceptions.NotFoundError
+            If the exchange rejects the cancellation because the intent does not exist.
+        afp.exceptions.RateLimitExceeded
+            If the exchange rejects the cancellation because of too many requests from
+            the authenticated account.
         afp.exceptions.ValidationError
-            If the exchange rejects the cancellation.
+            If the exchange rejects the cancellation because it is invalid.
         """
         nonce = self._generate_nonce()
         cancellation_hash = hashing.generate_order_cancellation_hash(nonce, intent_hash)
@@ -238,6 +245,7 @@ class Trading(ExchangeAPI):
         self,
         *,
         product_id: str | None = None,
+        intent_account_id: str | None = None,
         type_: str | None = None,
         states: Iterable[str] = (),
         side: str | None = None,
@@ -255,6 +263,8 @@ class Trading(ExchangeAPI):
         Parameters
         ----------
         product_id : str, optional
+        intent_account_id : str, optional
+            Defaults to the address of the authenticated account.
         type_ : str, optional
             One of `LIMIT_ORDER` and `CANCEL_ORDER`.
         states : iterable of str
@@ -274,8 +284,11 @@ class Trading(ExchangeAPI):
         -------
         list of afp.schemas.OrderFill
         """
+        if intent_account_id is None:
+            intent_account_id = self._authenticator.address
+
         filter = OrderFilter(
-            intent_account_id=self._authenticator.address,
+            intent_account_id=intent_account_id,
             product_id=product_id,
             type=None if type_ is None else OrderType(type_.upper()),
             states=[OrderState(state.upper()) for state in states],
@@ -306,6 +319,7 @@ class Trading(ExchangeAPI):
         self,
         *,
         product_id: str | None = None,
+        intent_account_id: str | None = None,
         intent_hash: str | None = None,
         start: datetime | None = None,
         end: datetime | None = None,
@@ -323,6 +337,8 @@ class Trading(ExchangeAPI):
         Parameters
         ----------
         product_id : str, optional
+        intent_account_id : str, optional
+            Defaults to the address of the authenticated account.
         intent_hash : str, optional
         start : datetime.datetime, optional
         end : datetime.datetime, optional
@@ -339,8 +355,11 @@ class Trading(ExchangeAPI):
         -------
         list of afp.schemas.OrderFill
         """
+        if intent_account_id is None:
+            intent_account_id = self._authenticator.address
+
         filter = OrderFillFilter(
-            intent_account_id=self._authenticator.address,
+            intent_account_id=intent_account_id,
             product_id=product_id,
             intent_hash=intent_hash,
             start=start,
@@ -357,6 +376,7 @@ class Trading(ExchangeAPI):
         self,
         *,
         product_id: str | None = None,
+        intent_account_id: str | None = None,
         intent_hash: str | None = None,
         trade_states: Iterable[str] = ("PENDING",),
     ) -> Generator[OrderFill, None, None]:
@@ -376,6 +396,8 @@ class Trading(ExchangeAPI):
         Parameters
         ----------
         product_id : str, optional
+        intent_account_id : str, optional
+            Defaults to the address of the authenticated account.
         intent_hash : str, optional
         trade_states: iterable of str
             Any of `PENDING`, `CLEARED` and `REJECTED`.
@@ -384,8 +406,11 @@ class Trading(ExchangeAPI):
         -------
         afp.schemas.OrderFill
         """
+        if intent_account_id is None:
+            intent_account_id = self._authenticator.address
+
         filter = OrderFillFilter(
-            intent_account_id=self._authenticator.address,
+            intent_account_id=intent_account_id,
             product_id=product_id,
             intent_hash=intent_hash,
             start=None,
@@ -439,3 +464,71 @@ class Trading(ExchangeAPI):
         """
         value = validators.validate_hexstr32(product_id)
         yield from self._exchange.iter_market_depth_data(value)
+
+    def ohlcv(
+        self,
+        product_id: str,
+        start: datetime | None = None,
+        interval: timedelta = timedelta(minutes=5),
+    ) -> list[OHLCVItem]:
+        """Retrieves Open-High-Low-Close-Volume time series data for the given product.
+
+        Parameters
+        ----------
+        product_id : str
+        start : datetime
+            Defaults to 1 day ago.
+        interval : timedelta
+            The distance between 2 data points. Gets rounded to a multiple of 5 seconds.
+            Defaults to 5 minutes.
+
+        Returns
+        -------
+        list of afp.schemas.OHLCVItem
+
+        Raises
+        ------
+        afp.exceptions.NotFoundError
+            If no such product exists.
+        """
+        if start is None:
+            start = datetime.now() - timedelta(days=1)
+
+        product_id = validators.validate_hexstr32(product_id)
+        start_timestamp = int(start.timestamp())
+        interval_secs = int(validators.validate_timedelta(interval).total_seconds())
+        return self._exchange.get_time_series_data(
+            product_id, start_timestamp, interval_secs
+        )
+
+    def iter_ohlcv(
+        self, product_id: str, interval: timedelta = timedelta(seconds=5)
+    ) -> Generator[OHLCVItem, None, None]:
+        """Subscribes to Open-High-Low-Close-Volume time series data updates for the
+        given product.
+
+        Returns a generator that yields OHLCV data points as they are published
+        by the exhange.
+
+        Parameters
+        ----------
+        product_id : str
+        interval : timedelta
+            The distance between 2 data points. Gets rounded to a multiple of 5 seconds.
+            Defaults to 5 seconds.
+
+        Yields
+        -------
+        afp.schemas.OHLCVItem
+
+        Raises
+        ------
+        afp.exceptions.NotFoundError
+            If no such product exists.
+        """
+        product_id = validators.validate_hexstr32(product_id)
+        start_timestamp = int(datetime.now().timestamp())
+        interval_secs = int(validators.validate_timedelta(interval).total_seconds())
+        yield from self._exchange.iter_time_series_data(
+            product_id, start_timestamp, interval_secs
+        )

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/afp/enums.py

@@ -11,6 +11,7 @@ class ListingState(StrEnum):
 class OrderType(StrEnum):
     LIMIT_ORDER = "LIMIT_ORDER"
     CANCEL_ORDER = "CANCEL_ORDER"
+    EXCHANGE_INITIATED_CANCELLATION = "EXCHANGE_INITIATED_CANCELLATION"
 
 
 class OrderState(StrEnum):

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/afp/exceptions.py

@@ -26,5 +26,9 @@ class NotFoundError(ExchangeError):
     pass
 
 
+class RateLimitExceeded(ExchangeError):
+    pass
+
+
 class ValidationError(ExchangeError):
     pass

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/afp/exchange.py

@@ -11,6 +11,7 @@ from .exceptions import (
     AuthorizationError,
     ExchangeError,
     NotFoundError,
+    RateLimitExceeded,
     ValidationError,
 )
 from .schemas import (
@@ -21,6 +22,7 @@ from .schemas import (
     ExchangeProductUpdateSubmission,
     LoginSubmission,
     MarketDepthData,
+    OHLCVItem,
     Order,
     OrderFilter,
     OrderFill,
@@ -138,6 +140,30 @@ class ExchangeClient:
         for line in response.iter_lines():
             yield MarketDepthData.model_validate_json(line)
 
+    # GET /time-series/{product_id}
+    def get_time_series_data(
+        self, product_id: str, start: int, interval: int
+    ) -> list[OHLCVItem]:
+        response = self._send_request(
+            "GET",
+            f"/time-series/{product_id}",
+            params=dict(start=start, interval=interval),
+        )
+        return [OHLCVItem(**item) for item in response.json()["data"]]
+
+    # GET /stream/time-series/{product_id}
+    def iter_time_series_data(
+        self, product_id: str, start: int, interval: int
+    ) -> Generator[OHLCVItem, None, None]:
+        response = self._send_request(
+            "GET",
+            f"/stream/time-series/{product_id}",
+            params=dict(start=start, interval=interval),
+            stream=True,
+        )
+        for line in response.iter_lines():
+            yield OHLCVItem.model_validate_json(line)
+
     def _send_request(
         self,
         method: str,
@@ -173,6 +199,8 @@ class ExchangeClient:
                 raise AuthorizationError(http_error) from http_error
             if http_error.response.status_code == requests.codes.NOT_FOUND:
                 raise NotFoundError(http_error) from http_error
+            if http_error.response.status_code == requests.codes.TOO_MANY_REQUESTS:
+                raise RateLimitExceeded(http_error) from http_error
             if http_error.response.status_code == requests.codes.BAD_REQUEST:
                 try:
                     reason = response.json()["detail"]

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/afp/schemas.py

@@ -78,7 +78,8 @@ class LoginSubmission(Model):
 
 class ExchangeParameters(Model):
     trading_protocol_id: str
-    trading_fee_rate: Decimal
+    maker_trading_fee_rate: Decimal
+    taker_trading_fee_rate: Decimal
 
 
 # Admin API
@@ -182,6 +183,7 @@ class OrderFill(Model):
     trade: Trade
     quantity: int
     price: Decimal
+    trading_fee_rate: Decimal
 
 
 class OrderFillFilter(PaginationFilter):
@@ -209,6 +211,15 @@ class MarketDepthData(Model):
     asks: list[MarketDepthItem]
 
 
+class OHLCVItem(Model):
+    timestamp: Timestamp
+    open: Decimal
+    high: Decimal
+    low: Decimal
+    close: Decimal
+    volume: int
+
+
 # Clearing API
 
 

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "afp-sdk"
-version = "0.5.2"
+version = "0.5.4"
 description = "Autonomous Futures Protocol Python SDK"
 readme = "README.md"
 license = "MIT"

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/tests/test_base_api.py

@@ -81,7 +81,9 @@ def test_ClearingSystemAPI__applies_transaction_parameters(monkeypatch):
 
 def test_ExchangeAPI__applies_exchange_parameters(monkeypatch):
     fake_exchange_params = ExchangeParameters(
-        trading_protocol_id="baz", trading_fee_rate=Decimal("0")
+        trading_protocol_id="baz",
+        maker_trading_fee_rate=Decimal("0"),
+        taker_trading_fee_rate=Decimal("0"),
     )
     mock_login = Mock(return_value=fake_exchange_params)
     mock_generate_login_nonce = Mock(return_value="12345678")

{afp_sdk-0.5.2 → afp_sdk-0.5.4}/uv.lock

@@ -13,7 +13,7 @@ wheels = [
 
 [[package]]
 name = "afp-sdk"
-version = "0.5.2"
+version = "0.5.4"
 source = { editable = "." }
 dependencies = [
     { name = "decorator" },