onesecondtrader 0.45.0__py3-none-any.whl → 0.46.0__py3-none-any.whl

onesecondtrader/events/base.py

@@ -9,10 +9,12 @@ class EventBase:
     """
     Base class for immutable event message objects, using Unix epoch nanoseconds.
 
-    | Field         | Type | Semantics                                                              |
-    |---------------|------|------------------------------------------------------------------------|
-    | ts_event_ns   | int  | Time at which the represented fact occurred, as UTC epoch nanoseconds. |
-    | ts_created_ns | int  | Time at which the event object was created, as UTC epoch nanoseconds.  |
+    | Field           | Type   | Semantics                                                              |
+    |-----------------|--------|------------------------------------------------------------------------|
+    | `ts_event_ns`   | `int`  | Time at which the represented fact occurred, as UTC epoch nanoseconds. |
+    | `ts_created_ns` | `int`  | Time at which the event object was created, as UTC epoch nanoseconds.  |
+
+    If not provided, `ts_created_ns` is assigned automatically at object creation.
     """
 
     ts_event_ns: int

onesecondtrader/events/requests/__init__.py

@@ -0,0 +1,9 @@
+from .order_submission import OrderSubmissionRequest
+from .order_cancellation import OrderCancellationRequest
+from .order_modification import OrderModificationRequest
+
+__all__ = [
+    "OrderSubmissionRequest",
+    "OrderCancellationRequest",
+    "OrderModificationRequest",
+]

onesecondtrader/events/requests/order_cancellation.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+import dataclasses
+import uuid
+
+from onesecondtrader import events
+
+
+@dataclasses.dataclass(kw_only=True, frozen=True, slots=True)
+class OrderCancellationRequest(events.EventBase):
+    """
+    Event representing a request to cancel an existing order.
+
+    | Field             | Type        | Semantics                                                           |
+    |-------------------|-------------|---------------------------------------------------------------------|
+    | `ts_event_ns`     | `int`       | Time at which the cancellation request was issued, as UTC epoch ns. |
+    | `ts_created_ns`   | `int`       | Time at which the event object was created, as UTC epoch ns.        |
+    | `system_order_id` | `uuid.UUID` | System-assigned identifier of the order to be cancelled.            |
+    | `symbol`          | `str`       | Identifier of the traded instrument.                                |
+    """
+
+    system_order_id: uuid.UUID
+    symbol: str

onesecondtrader/events/requests/order_modification.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+import dataclasses
+import uuid
+
+from onesecondtrader import events
+
+
+@dataclasses.dataclass(kw_only=True, frozen=True, slots=True)
+class OrderModificationRequest(events.EventBase):
+    """
+    Event representing a request to modify an existing order.
+
+    | Field             | Type              | Semantics                                                                    |
+    |-------------------|-------------------|------------------------------------------------------------------------------|
+    | `ts_event_ns`     | `int`             | Time at which the modification request was issued, as UTC epoch nanoseconds. |
+    | `ts_created_ns`   | `int`             | Time at which the event object was created, as UTC epoch nanoseconds.        |
+    | `system_order_id` | `uuid.UUID`       | System-assigned identifier of the order to be modified.                      |
+    | `symbol`          | `str`             | Identifier of the traded instrument.                                         |
+    | `quantity`        | `float` or `None` | Updated order quantity, if modified.                                         |
+    | `limit_price`     | `float` or `None` | Updated limit price, if modified.                                            |
+    | `stop_price`      | `float` or `None` | Updated stop price, if modified.                                             |
+    """
+
+    system_order_id: uuid.UUID
+    symbol: str
+    quantity: float | None = None
+    limit_price: float | None = None
+    stop_price: float | None = None

onesecondtrader/events/requests/order_submission.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import dataclasses
+import uuid
+
+from onesecondtrader import events, models
+
+
+@dataclasses.dataclass(kw_only=True, frozen=True, slots=True)
+class OrderSubmissionRequest(events.EventBase):
+    """
+    Event representing a request to submit a new order to a broker.
+
+    | Field             | Type                     | Semantics                                                                  |
+    |-------------------|--------------------------|----------------------------------------------------------------------------|
+    | `ts_event_ns`     | `int`                    | Time at which the submission request was issued, as UTC epoch nanoseconds. |
+    | `ts_created_ns`   | `int`                    | Time at which the event object was created, as UTC epoch nanoseconds.      |
+    | `system_order_id` | `uuid.UUID`            | System-assigned unique identifier for the order submission.                  |
+    | `symbol`          | `str`                    | Identifier of the traded instrument.                                       |
+    | `order_type`      | `models.OrderType`       | Execution constraint of the order.                                         |
+    | `side`            | `models.TradeSide`       | Direction of the trade.                                                    |
+    | `quantity`        | `float`                  | Requested order quantity.                                                  |
+    | `limit_price`     | `float` or `None`        | Limit price, if applicable to the order type.                              |
+    | `stop_price`      | `float` or `None`        | Stop price, if applicable to the order type.                               |
+    """
+
+    system_order_id: uuid.UUID = dataclasses.field(default_factory=uuid.uuid4)
+    symbol: str
+    order_type: models.OrderType
+    side: models.TradeSide
+    quantity: float
+    limit_price: float | None = None
+    stop_price: float | None = None

onesecondtrader/models/bar_fields.py

@@ -7,13 +7,13 @@ class BarField(enum.Enum):
     """
     Enumeration of bar fields used as indicator inputs.
 
-    | Value  | Semantics                          |
-    |--------|------------------------------------|
-    | OPEN   | Bar's opening value.               |
-    | HIGH   | Bar's highest value.               |
-    | LOW    | Bar's lowest value.                |
-    | CLOSE  | Bar's closing value.               |
-    | VOLUME | Bar's traded volume.               |
+    | Value    | Semantics                          |
+    |----------|------------------------------------|
+    | `OPEN`   | Bar's opening value.               |
+    | `HIGH`   | Bar's highest value.               |
+    | `LOW`    | Bar's lowest value.                |
+    | `CLOSE`  | Bar's closing value.               |
+    | `VOLUME` | Bar's traded volume.               |
     """
 
     OPEN = enum.auto()

onesecondtrader/models/bar_period.py

@@ -7,12 +7,12 @@ class BarPeriod(enum.Enum):
     """
     Enumeration of bar aggregation periods.
 
-    | Value  | Semantics            |
-    |--------|----------------------|
-    | SECOND | Duration of 1 second.|
-    | MINUTE | Duration of 1 minute.|
-    | HOUR   | Duration of 1 hour.  |
-    | DAY    | Duration of 1 day.   |
+    | Value    | Semantics            |
+    |----------|----------------------|
+    | `SECOND` | Duration of 1 second.|
+    | `MINUTE` | Duration of 1 minute.|
+    | `HOUR`   | Duration of 1 hour.  |
+    | `DAY`    | Duration of 1 day.   |
     """
 
     SECOND = enum.auto()

onesecondtrader/models/order_types.py

@@ -7,12 +7,12 @@ class OrderType(enum.Enum):
     """
     Enumeration of order execution types.
 
-    | Value       | Semantics                                                   |
-    |-------------|-------------------------------------------------------------|
-    | LIMIT       | Executable only at the specified limit price or better.     |
-    | MARKET      | Executable immediately at the best available market price.  |
-    | STOP        | Becomes a market order once the stop price is reached.      |
-    | STOP_LIMIT  | Becomes a limit order once the stop price is reached.       |
+    | Value        | Semantics                                                   |
+    |--------------|-------------------------------------------------------------|
+    | `LIMIT`      | Executable only at the specified limit price or better.     |
+    | `MARKET`     | Executable immediately at the best available market price.  |
+    | `STOP`       | Becomes a market order once the stop price is reached.      |
+    | `STOP_LIMIT` | Becomes a limit order once the stop price is reached.       |
     """
 
     LIMIT = enum.auto()

onesecondtrader/models/trade_sides.py

@@ -10,10 +10,10 @@ class TradeSide(enum.Enum):
     `OrderSide` specifies the direction of change applied to the (net) signed position
     quantity from the perspective of the trading account.
 
-    | Value | Semantics                                      |
-    |-------|------------------------------------------------|
-    | BUY   | Increases the signed position quantity.        |
-    | SELL  | Decreases the signed position quantity.        |
+    | Value   | Semantics                                      |
+    |---------|------------------------------------------------|
+    | `BUY`   | Increases the signed position quantity.        |
+    | `SELL`  | Decreases the signed position quantity.        |
     """
 
     BUY = enum.auto()

{onesecondtrader-0.45.0.dist-info → onesecondtrader-0.46.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: onesecondtrader
-Version: 0.45.0
+Version: 0.46.0
 Summary: The Trading Infrastructure Toolkit for Python. Research, simulate, and deploy algorithmic trading strategies — all in one place.
 License-File: LICENSE
 Author: Nils P. Kujath

onesecondtrader-0.46.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+onesecondtrader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+onesecondtrader/events/__init__.py,sha256=CTGyob-p2-VbvRZo4u21LbSYfk0cs78eEBRNsjW_CcE,127
+onesecondtrader/events/base.py,sha256=WpLo1bSKJe7Poh2IuDDCiBYZo9vE8mkq3cQlUpyTXsY,850
+onesecondtrader/events/requests/__init__.py,sha256=efXBe231UVtO7K5nMDP-MInG2aOTCDqkkCdjUhXwdKg,276
+onesecondtrader/events/requests/order_cancellation.py,sha256=bycQlLJ4GvOtpeRGbIy5munH8cGZrJUaCLdahA9UesE,1004
+onesecondtrader/events/requests/order_modification.py,sha256=eHwelFaLb_62n0riR_DTRXIFrYZpug-j0-jJCo-K2XQ,1576
+onesecondtrader/events/requests/order_submission.py,sha256=wUFJXlF5EcP14nQKPBoqO_yIfnCEko7Pb1NpNG2dNgQ,1987
+onesecondtrader/models/__init__.py,sha256=8eqxqKF49g_dgTG9EqT2czd_jnSafIG6wyniXPYFvF8,285
+onesecondtrader/models/bar_fields.py,sha256=GnLBL08ueUr35w2dAbKwOBWrdBS98OC9r0T2NifwTH8,646
+onesecondtrader/models/bar_period.py,sha256=J8ncVtcAxR52uD0nbC8Knds_GUP5wiuNj5rAKq4vv-4,475
+onesecondtrader/models/order_types.py,sha256=SiJamarLQ7zkHzHLLbd86I_TeZrQJ4QEIMqNHj4dxXU,737
+onesecondtrader/models/trade_sides.py,sha256=FPnkNeNm70fpkB4HxzYo0PwR6n_T6qdWXMINU0KR6Po,583
+onesecondtrader-0.46.0.dist-info/METADATA,sha256=FX8ZKVZ5usN_7qPS1ZK7y_-rxnKazdTqVEarrAihdrc,9951
+onesecondtrader-0.46.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
+onesecondtrader-0.46.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+onesecondtrader-0.46.0.dist-info/RECORD,,

onesecondtrader-0.45.0.dist-info/RECORD

@@ -1,12 +0,0 @@
-onesecondtrader/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-onesecondtrader/events/__init__.py,sha256=CTGyob-p2-VbvRZo4u21LbSYfk0cs78eEBRNsjW_CcE,127
-onesecondtrader/events/base.py,sha256=5s4_SOkbMBSGkNAG_1LOD4wbn2jbT7CGBZvsUvKhckc,750
-onesecondtrader/models/__init__.py,sha256=8eqxqKF49g_dgTG9EqT2czd_jnSafIG6wyniXPYFvF8,285
-onesecondtrader/models/bar_fields.py,sha256=zqQhbzFglIUXtUH0cog2Q-GtiRCM2Ej6WC3gvWIbS7c,632
-onesecondtrader/models/bar_period.py,sha256=n7heAAWGfBjO1knx9MnbFC6Mq2OjQGe4Xr6Cp2WxB38,463
-onesecondtrader/models/order_types.py,sha256=_VKDY1eohXgZwwaG_St4tgcq1FfACJsvmgpNesSEX-k,731
-onesecondtrader/models/trade_sides.py,sha256=gk7oTn5wJ_Xg52Uxd_0jS1fnl9ccirHAQ4Wtc2B4-JY,575
-onesecondtrader-0.45.0.dist-info/METADATA,sha256=s0gFuTwJQl9P3uBfZLl1wq7smgoYYB1Wc69XSlSqJfU,9951
-onesecondtrader-0.45.0.dist-info/WHEEL,sha256=3ny-bZhpXrU6vSQ1UPG34FoxZBp3lVcvK0LkgUz6VLk,88
-onesecondtrader-0.45.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-onesecondtrader-0.45.0.dist-info/RECORD,,