finatic-server-python 0.1.6__tar.gz → 0.2.1__tar.gz

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finatic-server-python
-Version: 0.1.6
+Version: 0.2.1
 Summary: Python SDK for Finatic Server API
 Author-email: Finatic <support@finatic.dev>
 License: MIT
@@ -103,6 +103,23 @@ print(f"User ID: {client.get_user_id()}")
 brokers = await client.get_broker_list()
 ```
 
+### Server: Get one-time token for Client SDK (additive helper)
+
+```python
+async with FinaticServerClient("your-api-key") as client:
+    # Fetch a fresh one-time token without modifying the current server session
+    one_time_token = await client.get_token()
+
+    # Pass this token to the Client SDK on the frontend to start its session
+    # e.g., FinaticClient.init({ "token": one_time_token })
+```
+
+Notes:
+
+- Requires the client to be initialized (use the async context manager or call **aenter**()).
+- Does not call `/session/start` and does not change `session_id`/`company_id` state.
+- Safe to call multiple times; each call returns a new short-lived token.
+
 ### 2. Direct Authentication (Server-side with known user ID)
 
 ```python

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/README.md

@@ -65,6 +65,23 @@ print(f"User ID: {client.get_user_id()}")
 brokers = await client.get_broker_list()
 ```
 
+### Server: Get one-time token for Client SDK (additive helper)
+
+```python
+async with FinaticServerClient("your-api-key") as client:
+    # Fetch a fresh one-time token without modifying the current server session
+    one_time_token = await client.get_token()
+
+    # Pass this token to the Client SDK on the frontend to start its session
+    # e.g., FinaticClient.init({ "token": one_time_token })
+```
+
+Notes:
+
+- Requires the client to be initialized (use the async context manager or call **aenter**()).
+- Does not call `/session/start` and does not change `session_id`/`company_id` state.
+- Safe to call multiple times; each call returns a new short-lived token.
+
 ### 2. Direct Authentication (Server-side with known user ID)
 
 ```python

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "finatic-server-python"
-version = "0.1.6"
+version = "0.2.1"
 description = "Python SDK for Finatic Server API"
 authors = [{ name = "Finatic", email = "support@finatic.dev" }]
 license = { text = "MIT" }
@@ -63,7 +63,7 @@ multi_line_output = 3
 line_length = 88
 
 [tool.mypy]
-python_version = "0.1.5"
+python_version = "0.2.1"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/src/finatic_server/core/api_client.py

@@ -38,6 +38,16 @@ from ..types import (
     TradingContext,
     ApiPaginationInfo,
     PaginatedResult,
+    OrderFill,
+    OrderEvent,
+    OrderGroup,
+    PositionLot,
+    PositionLotFill,
+    OrderFillsFilter,
+    OrderEventsFilter,
+    OrderGroupsFilter,
+    PositionLotsFilter,
+    PositionLotFillsFilter,
 )
 from ..utils.errors import (
     ApiError,
@@ -981,6 +991,110 @@ class ApiClient:
         )
         return response
 
+    async def get_order_fills(
+        self, order_id: str, filters: Optional[OrderFillsFilter] = None
+    ) -> List[OrderFill]:
+        """Get order fills for a specific order using session-based authentication."""
+        params = {}
+        if filters:
+            if filters.connection_id:
+                params["connection_id"] = filters.connection_id
+            if filters.limit:
+                params["limit"] = str(filters.limit)
+            if filters.offset:
+                params["offset"] = str(filters.offset)
+
+        response = await self._request(
+            method="GET", path=f"/brokers/data/orders/{order_id}/fills", params=params
+        )
+        return [OrderFill(**fill) for fill in response.get("response_data", [])]
+
+    async def get_order_events(
+        self, order_id: str, filters: Optional[OrderEventsFilter] = None
+    ) -> List[OrderEvent]:
+        """Get order events for a specific order using session-based authentication."""
+        params = {}
+        if filters:
+            if filters.connection_id:
+                params["connection_id"] = filters.connection_id
+            if filters.limit:
+                params["limit"] = str(filters.limit)
+            if filters.offset:
+                params["offset"] = str(filters.offset)
+
+        response = await self._request(
+            method="GET", path=f"/brokers/data/orders/{order_id}/events", params=params
+        )
+        return [OrderEvent(**event) for event in response.get("response_data", [])]
+
+    async def get_order_groups(
+        self, filters: Optional[OrderGroupsFilter] = None
+    ) -> List[OrderGroup]:
+        """Get order groups using session-based authentication."""
+        params = {}
+        if filters:
+            if filters.broker_id:
+                params["broker_id"] = filters.broker_id
+            if filters.connection_id:
+                params["connection_id"] = filters.connection_id
+            if filters.limit:
+                params["limit"] = str(filters.limit)
+            if filters.offset:
+                params["offset"] = str(filters.offset)
+            if filters.created_after:
+                params["created_after"] = filters.created_after
+            if filters.created_before:
+                params["created_before"] = filters.created_before
+
+        response = await self._request(
+            method="GET", path="/brokers/data/orders/groups", params=params
+        )
+        return [OrderGroup(**group) for group in response.get("response_data", [])]
+
+    async def get_position_lots(
+        self, filters: Optional[PositionLotsFilter] = None
+    ) -> List[PositionLot]:
+        """Get position lots (tax lots) using session-based authentication."""
+        params = {}
+        if filters:
+            if filters.broker_id:
+                params["broker_id"] = filters.broker_id
+            if filters.connection_id:
+                params["connection_id"] = filters.connection_id
+            if filters.account_id:
+                params["account_id"] = filters.account_id
+            if filters.symbol:
+                params["symbol"] = filters.symbol
+            if filters.position_id:
+                params["position_id"] = filters.position_id
+            if filters.limit:
+                params["limit"] = str(filters.limit)
+            if filters.offset:
+                params["offset"] = str(filters.offset)
+
+        response = await self._request(
+            method="GET", path="/brokers/data/positions/lots", params=params
+        )
+        return [PositionLot(**lot) for lot in response.get("response_data", [])]
+
+    async def get_position_lot_fills(
+        self, lot_id: str, filters: Optional[PositionLotFillsFilter] = None
+    ) -> List[PositionLotFill]:
+        """Get position lot fills for a specific lot using session-based authentication."""
+        params = {}
+        if filters:
+            if filters.connection_id:
+                params["connection_id"] = filters.connection_id
+            if filters.limit:
+                params["limit"] = str(filters.limit)
+            if filters.offset:
+                params["offset"] = str(filters.offset)
+
+        response = await self._request(
+            method="GET", path=f"/brokers/data/positions/lots/{lot_id}/fills", params=params
+        )
+        return [PositionLotFill(**fill) for fill in response.get("response_data", [])]
+
     # Trading context methods
     def set_broker(self, broker: str):
         """Set the current broker."""

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/src/finatic_server/core/client.py

@@ -200,6 +200,22 @@ class FinaticServerClient:
 
         return session_response
 
+    async def get_token(self) -> str:
+        """Get a fresh one-time token for client SDK, requiring initialized client.
+
+        This does not modify the current server SDK session; it only returns a token
+        from /session/init that can be passed to the Client SDK.
+        """
+        # Ensure client is initialized (HTTP session exists)
+        if not hasattr(self._api_client, "_session") or self._api_client._session is None:
+            raise AuthenticationError(
+                "Client not initialized. Use 'async with' or call __aenter__() first."
+            )
+
+        # Call existing init logic and return the token
+        token = await self._initialize_session()
+        return token
+
     async def get_portal_url(
         self,
         theme: Optional[Dict[str, Any]] = None,

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/src/finatic_server/types/__init__.py

@@ -55,6 +55,16 @@ from .broker import (
     PositionsFilter,
     AccountsFilter,
     BalancesFilter,
+    OrderFill,
+    OrderEvent,
+    OrderGroup,
+    PositionLot,
+    PositionLotFill,
+    OrderFillsFilter,
+    OrderEventsFilter,
+    OrderGroupsFilter,
+    PositionLotsFilter,
+    PositionLotFillsFilter,
 )
 
 # Webhook types
@@ -110,6 +120,16 @@ __all__ = [
     "PositionsFilter",
     "AccountsFilter",
     "BalancesFilter",
+    "OrderFill",
+    "OrderEvent",
+    "OrderGroup",
+    "PositionLot",
+    "PositionLotFill",
+    "OrderFillsFilter",
+    "OrderEventsFilter",
+    "OrderGroupsFilter",
+    "PositionLotsFilter",
+    "PositionLotFillsFilter",
     
     # Webhook
     "TestWebhookRequest",

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/src/finatic_server/types/broker.py

@@ -220,3 +220,162 @@ class BalancesFilter(BaseModel):
         None, description="Filter by balance creation date before (ISO 8601)"
     )
     with_metadata: Optional[bool] = Field(None, description="Include metadata")
+
+
+class OrderFill(BaseModel):
+    """Order fill information."""
+
+    id: str = Field(..., description="Fill ID")
+    order_id: str = Field(..., description="Order ID")
+    leg_id: Optional[str] = Field(None, description="Order leg ID")
+    price: float = Field(..., description="Fill price")
+    quantity: float = Field(..., description="Fill quantity")
+    executed_at: str = Field(..., description="Execution timestamp")
+    execution_id: Optional[str] = Field(None, description="Execution ID")
+    trade_id: Optional[str] = Field(None, description="Trade ID")
+    venue: Optional[str] = Field(None, description="Execution venue")
+    commission_fee: Optional[float] = Field(None, description="Commission fee")
+    created_at: str = Field(..., description="Creation timestamp")
+    updated_at: str = Field(..., description="Last update timestamp")
+
+
+class OrderEvent(BaseModel):
+    """Order event information."""
+
+    id: str = Field(..., description="Event ID")
+    order_id: str = Field(..., description="Order ID")
+    order_group_id: Optional[str] = Field(None, description="Order group ID")
+    event_type: Optional[str] = Field(None, description="Event type")
+    event_time: str = Field(..., description="Event timestamp")
+    event_id: Optional[str] = Field(None, description="Event ID")
+    order_status: Optional[str] = Field(None, description="Order status")
+    inferred: bool = Field(..., description="Whether event was inferred")
+    confidence: Optional[float] = Field(None, description="Confidence score")
+    reason_code: Optional[str] = Field(None, description="Reason code")
+    recorded_at: Optional[str] = Field(None, description="Recorded timestamp")
+
+
+class OrderLeg(BaseModel):
+    """Order leg information."""
+
+    id: str = Field(..., description="Leg ID")
+    order_id: str = Field(..., description="Order ID")
+    leg_index: int = Field(..., description="Leg index")
+    asset_type: str = Field(..., description="Asset type")
+    broker_provided_symbol: Optional[str] = Field(None, description="Broker provided symbol")
+    quantity: float = Field(..., description="Quantity")
+    filled_quantity: Optional[float] = Field(None, description="Filled quantity")
+    avg_fill_price: Optional[float] = Field(None, description="Average fill price")
+    created_at: Optional[str] = Field(None, description="Creation timestamp")
+    updated_at: Optional[str] = Field(None, description="Last update timestamp")
+
+
+class OrderGroupOrder(BrokerOrder):
+    """Order within a group with legs."""
+
+    legs: List[OrderLeg] = Field(default_factory=list, description="Order legs")
+
+
+class OrderGroup(BaseModel):
+    """Order group information with nested orders and legs."""
+
+    id: str = Field(..., description="Group ID")
+    user_broker_connection_id: Optional[str] = Field(None, description="User broker connection ID")
+    created_at: str = Field(..., description="Creation timestamp")
+    updated_at: str = Field(..., description="Last update timestamp")
+    orders: List[OrderGroupOrder] = Field(
+        default_factory=list, description="Orders in group with their legs"
+    )
+
+
+class PositionLot(BaseModel):
+    """Position lot (tax lot) information."""
+
+    id: str = Field(..., description="Lot ID")
+    position_id: Optional[str] = Field(None, description="Position ID")
+    user_broker_connection_id: str = Field(..., description="User broker connection ID")
+    broker_provided_account_id: str = Field(..., description="Broker provided account ID")
+    instrument_key: str = Field(..., description="Instrument key")
+    asset_type: Optional[str] = Field(None, description="Asset type")
+    side: Optional[str] = Field(None, description="Position side")
+    open_quantity: float = Field(..., description="Open quantity")
+    closed_quantity: float = Field(..., description="Closed quantity")
+    remaining_quantity: float = Field(..., description="Remaining quantity")
+    open_price: float = Field(..., description="Open price")
+    close_price_avg: Optional[float] = Field(None, description="Average close price")
+    cost_basis: float = Field(..., description="Cost basis")
+    cost_basis_w_commission: float = Field(..., description="Cost basis with commission")
+    realized_pl: float = Field(..., description="Realized P&L")
+    realized_pl_w_commission: float = Field(..., description="Realized P&L with commission")
+    lot_opened_at: str = Field(..., description="Lot opened timestamp")
+    lot_closed_at: Optional[str] = Field(None, description="Lot closed timestamp")
+    position_group_id: Optional[str] = Field(None, description="Position group ID")
+    created_at: str = Field(..., description="Creation timestamp")
+    updated_at: str = Field(..., description="Last update timestamp")
+    position_lot_fills: Optional[List["PositionLotFill"]] = Field(None, description="Lot fills")
+
+
+class PositionLotFill(BaseModel):
+    """Position lot fill information."""
+
+    id: str = Field(..., description="Fill ID")
+    lot_id: str = Field(..., description="Lot ID")
+    order_fill_id: str = Field(..., description="Order fill ID")
+    fill_price: float = Field(..., description="Fill price")
+    fill_quantity: float = Field(..., description="Fill quantity")
+    executed_at: str = Field(..., description="Execution timestamp")
+    commission_share: Optional[float] = Field(None, description="Commission share")
+    created_at: str = Field(..., description="Creation timestamp")
+    updated_at: str = Field(..., description="Last update timestamp")
+
+
+# Filter types for detail endpoints
+class OrderFillsFilter(BaseModel):
+    """Filter options for order fills."""
+
+    connection_id: Optional[str] = Field(None, description="Filter by connection ID")
+    limit: Optional[int] = Field(None, description="Result limit")
+    offset: Optional[int] = Field(None, description="Result offset")
+
+
+class OrderEventsFilter(BaseModel):
+    """Filter options for order events."""
+
+    connection_id: Optional[str] = Field(None, description="Filter by connection ID")
+    limit: Optional[int] = Field(None, description="Result limit")
+    offset: Optional[int] = Field(None, description="Result offset")
+
+
+class OrderGroupsFilter(BaseModel):
+    """Filter options for order groups."""
+
+    broker_id: Optional[str] = Field(None, description="Filter by broker ID")
+    connection_id: Optional[str] = Field(None, description="Filter by connection ID")
+    limit: Optional[int] = Field(None, description="Result limit")
+    offset: Optional[int] = Field(None, description="Result offset")
+    created_after: Optional[str] = Field(
+        None, description="Filter by creation date after (ISO 8601)"
+    )
+    created_before: Optional[str] = Field(
+        None, description="Filter by creation date before (ISO 8601)"
+    )
+
+
+class PositionLotsFilter(BaseModel):
+    """Filter options for position lots."""
+
+    broker_id: Optional[str] = Field(None, description="Filter by broker ID")
+    connection_id: Optional[str] = Field(None, description="Filter by connection ID")
+    account_id: Optional[str] = Field(None, description="Filter by account ID")
+    symbol: Optional[str] = Field(None, description="Filter by symbol")
+    position_id: Optional[str] = Field(None, description="Filter by position ID")
+    limit: Optional[int] = Field(None, description="Result limit")
+    offset: Optional[int] = Field(None, description="Result offset")
+
+
+class PositionLotFillsFilter(BaseModel):
+    """Filter options for position lot fills."""
+
+    connection_id: Optional[str] = Field(None, description="Filter by connection ID")
+    limit: Optional[int] = Field(None, description="Result limit")
+    offset: Optional[int] = Field(None, description="Result offset")

{finatic_server_python-0.1.6 → finatic_server_python-0.2.1}/src/finatic_server_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: finatic-server-python
-Version: 0.1.6
+Version: 0.2.1
 Summary: Python SDK for Finatic Server API
 Author-email: Finatic <support@finatic.dev>
 License: MIT
@@ -103,6 +103,23 @@ print(f"User ID: {client.get_user_id()}")
 brokers = await client.get_broker_list()
 ```
 
+### Server: Get one-time token for Client SDK (additive helper)
+
+```python
+async with FinaticServerClient("your-api-key") as client:
+    # Fetch a fresh one-time token without modifying the current server session
+    one_time_token = await client.get_token()
+
+    # Pass this token to the Client SDK on the frontend to start its session
+    # e.g., FinaticClient.init({ "token": one_time_token })
+```
+
+Notes:
+
+- Requires the client to be initialized (use the async context manager or call **aenter**()).
+- Does not call `/session/start` and does not change `session_id`/`company_id` state.
+- Safe to call multiple times; each call returns a new short-lived token.
+
 ### 2. Direct Authentication (Server-side with known user ID)
 
 ```python