architect-py 5.1.2__py3-none-any.whl → 5.1.4b1__py3-none-any.whl

architect_py/__init__.py

@@ -1,6 +1,6 @@
 # ruff: noqa:I001
 
-__version__ = "5.1.2"
+__version__ = "5.1.4b1"
 
 from .utils.nearest_tick import TickRoundMethod
 from .async_client import AsyncClient

architect_py/async_client.py

@@ -11,6 +11,7 @@ from typing import (
     Literal,
     Optional,
     Sequence,
+    Tuple,
     Union,
     overload,
 )
@@ -56,6 +57,7 @@ class AsyncClient:
     api_secret: Optional[str] = None
     paper_trading: bool
     graphql_client: GraphQLClient
+    grpc_options: Sequence[Tuple[str, Any]] | None = None
     grpc_core: Optional[GrpcClient] = None
     grpc_marketdata: dict[Venue, GrpcClient] = {}
     grpc_hmart: Optional[GrpcClient] = None
@@ -77,14 +79,22 @@ class AsyncClient:
         paper_trading: bool,
         endpoint: str = "https://app.architect.co",
         graphql_port: Optional[int] = None,
+        grpc_options: Sequence[Tuple[str, Any]] | None = None,
         **kwargs: Any,
     ) -> "AsyncClient":
         """
         Connect to an Architect installation.
 
-        An `api_key` and `api_secret` can be created at https://app.architect.co/api-keys
+        An `api_key` and `api_secret` can be created at https://app.architect.co/api-keys.
 
         Raises ValueError if the API key and secret are not the correct length or contain invalid characters.
+
+        ## Advanced configuration
+
+        ### gRPC channel options
+
+        Use `grpc_options` to configure gRPC channels created by this client.
+        See https://grpc.github.io/grpc/python/glossary.html#term-channel_arguments for reference.
         """
         if paper_trading:
             COLOR = "\033[30;43m"
@@ -123,6 +133,7 @@ class AsyncClient:
             paper_trading=paper_trading,
             grpc_host=grpc_host,
             grpc_port=grpc_port,
+            grpc_options=grpc_options,
             graphql_port=graphql_port,
             use_ssl=use_ssl,
             _i_know_what_i_am_doing=True,
@@ -144,6 +155,7 @@ class AsyncClient:
         paper_trading: bool,
         grpc_host: str = "app.architect.co",
         grpc_port: int,
+        grpc_options: Sequence[Tuple[str, Any]] | None = None,
         graphql_port: Optional[int] = None,
         use_ssl: bool = True,
         _i_know_what_i_am_doing: bool = False,
@@ -179,7 +191,10 @@ class AsyncClient:
             api_key=api_key,
             api_secret=api_secret,
         )
-        self.grpc_core = GrpcClient(host=grpc_host, port=grpc_port, use_ssl=use_ssl)
+        self.grpc_options = grpc_options
+        self.grpc_core = GrpcClient(
+            host=grpc_host, port=grpc_port, use_ssl=use_ssl, options=grpc_options
+        )
 
     async def close(self):
         """
@@ -268,7 +283,10 @@ class AsyncClient:
                         use_ssl,
                     )
                     self.grpc_marketdata[venue] = GrpcClient(
-                        host=grpc_host, port=grpc_port, use_ssl=use_ssl
+                        host=grpc_host,
+                        port=grpc_port,
+                        use_ssl=use_ssl,
+                        options=self.grpc_options,
                     )
                 except Exception as e:
                     logging.error("Failed to set marketdata endpoint: %s", e)
@@ -282,7 +300,10 @@ class AsyncClient:
         try:
             grpc_host, grpc_port, use_ssl = await resolve_endpoint(endpoint)
             self.grpc_marketdata[venue] = GrpcClient(
-                host=grpc_host, port=grpc_port, use_ssl=use_ssl
+                host=grpc_host,
+                port=grpc_port,
+                use_ssl=use_ssl,
+                options=self.grpc_options,
             )
             logging.debug(
                 f"Setting marketdata endpoint for {venue}: {grpc_host}:{grpc_port} use_ssl={use_ssl}"
@@ -315,7 +336,10 @@ class AsyncClient:
                 use_ssl,
             )
             self.grpc_hmart = GrpcClient(
-                host=grpc_host, port=grpc_port, use_ssl=use_ssl
+                host=grpc_host,
+                port=grpc_port,
+                use_ssl=use_ssl,
+                options=self.grpc_options,
             )
         except Exception as e:
             logging.error("Failed to set hmart endpoint: %s", e)
@@ -364,6 +388,17 @@ class AsyncClient:
             "as of v5.0.0: enable_orderflow is deprecated; orderflow is enabled by default"
         )
 
+    async def cpty_status(
+        self, kind: str, instance: Optional[str] = None
+    ) -> CptyStatus:
+        """
+        Get cpty status.
+        """
+        grpc_client = await self.core()
+        req = CptyStatusRequest(kind=kind, instance=instance)
+        res: CptyStatus = await grpc_client.unary_unary(req)
+        return res
+
     # ------------------------------------------------------------
     # Symbology
     # ------------------------------------------------------------
@@ -1382,28 +1417,16 @@ class AsyncClient:
 
         Example:
             ```python
-            async for of in client.stream_orderflow(account, execution_venue, trader):
-                print(of)
+            async for event in client.stream_orderflow(account, execution_venue, trader):
+                print(event)
             ```
         """
         grpc_client = await self.core()
-        request: SubscribeOrderflowRequest = SubscribeOrderflowRequest(
+        req: SubscribeOrderflowRequest = SubscribeOrderflowRequest(
             account=account, execution_venue=execution_venue, trader=trader
         )
-        grpc_client = await self.core()
-        decoder = grpc_client.get_decoder(SubscribeOrderflowRequest)
-        stub: grpc.aio.UnaryStreamMultiCallable[
-            SubscribeOrderflowRequest, Orderflow
-        ] = grpc_client.channel.unary_stream(
-            SubscribeOrderflowRequest.get_route(),
-            request_serializer=grpc_client.encoder().encode,
-            response_deserializer=decoder.decode,
-        )
-        call: grpc.aio._base_call.UnaryStreamCall[
-            SubscribeOrderflowRequest, Orderflow
-        ] = stub(request, metadata=(("authorization", f"Bearer {grpc_client.jwt}"),))
-        async for update in call:
-            yield update
+        async for res in grpc_client.unary_stream(req):  # type: ignore
+            yield res
 
     # ------------------------------------------------------------
     # Order entry

architect_py/client.py

@@ -4,7 +4,15 @@ import threading
 from asyncio import AbstractEventLoop
 from collections.abc import Callable
 from functools import partial
-from typing import Any, Concatenate, Coroutine, Optional, ParamSpec, TypeVar
+from typing import (
+    Any,
+    Concatenate,
+    Coroutine,
+    Optional,
+    ParamSpec,
+    Sequence,
+    TypeVar,
+)
 
 from .async_client import AsyncClient
 
@@ -50,6 +58,7 @@ class Client:
         paper_trading: bool,
         endpoint: str = "https://app.architect.co",
         graphql_port: Optional[int] = None,
+        grpc_options: Sequence[tuple[str, Any]] | None = None,
         event_loop: Optional[AbstractEventLoop] = None,
         **kwargs,
     ):
@@ -78,6 +87,7 @@ class Client:
             paper_trading=paper_trading,
             endpoint=endpoint,
             graphql_port=graphql_port,
+            grpc_options=grpc_options,
             **kwargs,
         )
 

architect_py/client.pyi

@@ -38,13 +38,14 @@ class Client:
     api_secret: str | None
     paper_trading: bool
     graphql_client: GraphQLClient
+    grpc_options: Sequence[tuple[str, Any]] | None
     grpc_core: GrpcClient | None
     grpc_marketdata: dict[Venue, GrpcClient]
     grpc_hmart: GrpcClient | None
     jwt: str | None
     jwt_expiration: datetime | None
     l1_books: dict[Venue, dict[TradableProduct, tuple[L1BookSnapshot, asyncio.Task]]]
-    def __init__(self, *, api_key: str, api_secret: str, paper_trading: bool, endpoint: str = 'https://app.architect.co', graphql_port: int | None = None, event_loop: asyncio.events.AbstractEventLoop | None = None) -> None:
+    def __init__(self, *, api_key: str, api_secret: str, paper_trading: bool, endpoint: str = 'https://app.architect.co', graphql_port: int | None = None, grpc_options: Sequence[tuple[str, Any]] | None = None, event_loop: asyncio.events.AbstractEventLoop | None = None) -> None:
         """
         Create a new Client instance.
 
@@ -118,6 +119,10 @@ class Client:
         Returns:
             (user_id, user_email)
         """
+    def cpty_status(self, kind: str, instance: str | None = None) -> CptyStatus:
+        """
+        Get cpty status.
+        """
     def list_symbols(self, *, marketdata: Venue | None = None) -> list[str]:
         """
         List all symbols.

architect_py/grpc/client.py

@@ -1,5 +1,5 @@
 from types import UnionType
-from typing import AsyncIterator
+from typing import Any, AsyncIterator, Sequence, Tuple
 
 import grpc
 import msgspec
@@ -18,14 +18,23 @@ class GrpcClient:
     channel: grpc.aio.Channel
     jwt: str | None = None
 
-    def __init__(self, *, host: str, port: int, use_ssl: bool = False):
+    def __init__(
+        self,
+        *,
+        host: str,
+        port: int,
+        use_ssl: bool = False,
+        options: Sequence[Tuple[str, Any]] | None = None,
+    ):
         scheme = "https" if use_ssl else "http"
         self.endpoint = f"{scheme}://{host}:{port}"
         if use_ssl:
             credentials = grpc.ssl_channel_credentials()
-            self.channel = grpc.aio.secure_channel(f"{host}:{port}", credentials)
+            self.channel = grpc.aio.secure_channel(
+                f"{host}:{port}", credentials, options=options
+            )
         else:
-            self.channel = grpc.aio.insecure_channel(f"{host}:{port}")
+            self.channel = grpc.aio.insecure_channel(f"{host}:{port}", options=options)
 
     def set_jwt(self, jwt: str | None):
         self.jwt = jwt

architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py

@@ -10,6 +10,17 @@ from msgspec import Meta, Struct
 
 
 class SubscribeL1BookSnapshotsRequest(Struct, omit_defaults=True):
+    send_initial_snapshots: Optional[
+        Annotated[
+            bool,
+            Meta(
+                description="If true, send an initial snapshot to subscribers on symbol subscription"
+            ),
+        ]
+    ] = False
+    """
+    If true, send an initial snapshot to subscribers on symbol subscription
+    """
     symbols: Optional[
         Annotated[
             List[str],
@@ -25,16 +36,18 @@ class SubscribeL1BookSnapshotsRequest(Struct, omit_defaults=True):
     @classmethod
     def new(
         cls,
+        send_initial_snapshots: Optional[bool] = False,
         symbols: Optional[List[str]] = None,
         venue: Optional[str] = None,
     ):
         return cls(
+            send_initial_snapshots,
             symbols,
             venue,
         )
 
     def __str__(self) -> str:
-        return f"SubscribeL1BookSnapshotsRequest(symbols={self.symbols},venue={self.venue})"
+        return f"SubscribeL1BookSnapshotsRequest(send_initial_snapshots={self.send_initial_snapshots},symbols={self.symbols},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/grpc/models/Marketdata/TickersRequest.py

@@ -13,6 +13,7 @@ from .. import definitions
 
 class TickersRequest(Struct, omit_defaults=True):
     i: Optional[Annotated[Optional[int], Meta(title="offset")]] = None
+    include_options: Optional[bool] = None
     k: Optional[
         Annotated[Optional[definitions.SortTickersBy], Meta(title="sort_by")]
     ] = None
@@ -25,6 +26,7 @@ class TickersRequest(Struct, omit_defaults=True):
     def new(
         cls,
         offset: Optional[int] = None,
+        include_options: Optional[bool] = None,
         sort_by: Optional[definitions.SortTickersBy] = None,
         limit: Optional[int] = None,
         symbols: Optional[List[str]] = None,
@@ -32,6 +34,7 @@ class TickersRequest(Struct, omit_defaults=True):
     ):
         return cls(
             offset,
+            include_options,
             sort_by,
             limit,
             symbols,
@@ -39,7 +42,7 @@ class TickersRequest(Struct, omit_defaults=True):
         )
 
     def __str__(self) -> str:
-        return f"TickersRequest(offset={self.i},sort_by={self.k},limit={self.n},symbols={self.symbols},venue={self.venue})"
+        return f"TickersRequest(offset={self.i},include_options={self.include_options},sort_by={self.k},limit={self.n},symbols={self.symbols},venue={self.venue})"
 
     @property
     def offset(self) -> Optional[int]:

architect_py/grpc/models/definitions.py

@@ -454,6 +454,7 @@ class OrderRejectReason(str, Enum):
     InsufficientCash = "InsufficientCash"
     InsufficientMargin = "InsufficientMargin"
     NotEasyToBorrow = "NotEasyToBorrow"
+    InvalidOrder = "InvalidOrder"
     Unknown = "Unknown"
 
 

{architect_py-5.1.2.dist-info → architect_py-5.1.4b1.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: architect-py
-Version: 5.1.2
+Version: 5.1.4b1
 Summary: Python SDK for the Architect trading platform and brokerage.
 Author-email: "Architect Financial Technologies, Inc." <hello@architect.co>
 License-Expression: Apache-2.0
-Project-URL: Homepage, https://www.architect.co/brokerage/overview
 Project-URL: Documentation, https://docs.architect.co
+Project-URL: Homepage, https://www.architect.co/brokerage/overview
 Project-URL: Repository, https://github.com/architect-xyz/architect-py
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -48,7 +48,7 @@ Go to [FUNCTIONS.md](FUNCTIONS.md) file to see a catalog of methods.
 
 ## Examples
 
-Go to the [Examples](./examples) to see examples of a variety of common use cases.
+Go to the [Examples](./examples) to see examples of a variety of common use cases.  To run a specific example, use e.g. `python -m examples.orderflow_streaming`.
 
 ## Documentation 
 

{architect_py-5.1.2.dist-info → architect_py-5.1.4b1.dist-info}/RECORD

@@ -1,7 +1,7 @@
-architect_py/__init__.py,sha256=0AUu9lue-XJfjKuCe_CgnQXdOlwhgBSwRLFc5yeU4LI,16121
-architect_py/async_client.py,sha256=0cpFvY36YquphGqD7z7hdWEb59OyuJiDYgrHzfykuC4,61646
-architect_py/client.py,sha256=yC0OVzz6uXUMdIIhqqR3GyVuBApYSm00AS51QM8xPak,4911
-architect_py/client.pyi,sha256=VJrg85KaupKzWY4BvS86xREs67S_TFrItNirczYLrgc,24565
+architect_py/__init__.py,sha256=8CrccOPnPzBy9EjbeXrvHImwdFvNofKqInTPsDz-9Fw,16123
+architect_py/async_client.py,sha256=k6bGfqkan0sdlKI2LOYTRwwT-UZLPDgKagxo_IUqhxU,62227
+architect_py/client.py,sha256=S9FsNoRJGB2xiE6H1nPPIg_-oAPZ5qPOBWy_4Hw0UuI,5056
+architect_py/client.pyi,sha256=bXd7pjtc1lDCB0l6tRkHr8tydz7n65TUpsyUeYaqV_4,24801
 architect_py/common_types/__init__.py,sha256=fzOdIlKGWVN9V2Onc5z1v2bpvtZ4H9RSFA9ymJcBi3k,197
 architect_py/common_types/order_dir.py,sha256=ebyWTcXzJWrotkc2D9wNGc6JXbE5I3NLLuAz3I7FTZ8,2191
 architect_py/common_types/time_in_force.py,sha256=gEDYcNp014Eeb98zJDytiV0hGxHu_QsQndeM6Hk0Wa8,3132
@@ -23,12 +23,12 @@ architect_py/graphql_client/juniper_base_client.py,sha256=0kbAihyRgEP3n28zRumoST
 architect_py/graphql_client/search_symbols_query.py,sha256=hbGa6gF-gMWtRYQm2vlCTPDex8RWrJ4Yn4nT0VRQnCQ,614
 architect_py/graphql_client/user_id_query.py,sha256=tWKJJLgEINzd8e7rYlGklQCnwcwHzYFpCGQvhxQGX20,334
 architect_py/grpc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-architect_py/grpc/client.py,sha256=1_2JuxFoIVRtcuczkuI-uF7zy-AqSYehf5N3E9Gy4Jg,3406
+architect_py/grpc/client.py,sha256=qApYInm_eEhSFKYZRQ_EJyrV-PMA1AOhJ1PoArzGGvM,3597
 architect_py/grpc/resolve_endpoint.py,sha256=r_PBWANIJJ47N5uyPcnefZ21ZE1-mzgACfCBfQpekg8,2621
 architect_py/grpc/server.py,sha256=Abmdfe1eYbctVgzoJYBBBLpd7UD70FbYQLtJImSyRzs,1934
 architect_py/grpc/utils.py,sha256=5sykLExUNZbcQHcxLCCM9DdOOiJJZcpputGrDtaMifY,667
 architect_py/grpc/models/__init__.py,sha256=RrTLZvU7mNykDNp1oOm4-dekzab9ugIXd_my7Sm0Vx4,9153
-architect_py/grpc/models/definitions.py,sha256=sGc8KYz4Hki6X3Kvr-Qe6iVnTaQC47wwJP3NeEPT5cQ,77014
+architect_py/grpc/models/definitions.py,sha256=UB2-xXjoAM6ZTkNrsa1Q2-W_t6XUWHykP_R5tqzDcbc,77048
 architect_py/grpc/models/Accounts/AccountsRequest.py,sha256=1a88cltSebOb53EdJ0hKEGR7FlmBiibrCtGzLTKqDBY,1524
 architect_py/grpc/models/Accounts/AccountsResponse.py,sha256=DlXbkd3UbRybblBAfokw-K6nRvLNZgqz7cc0EKiW1zI,636
 architect_py/grpc/models/Accounts/__init__.py,sha256=sIyaEvJdP-VmGTGPPqZuRjKn4bc7NUClJ76Gd5uq-5s,57
@@ -99,7 +99,7 @@ architect_py/grpc/models/Marketdata/MarketStatus.py,sha256=4Kt2z16t7dpjpiELWshJy
 architect_py/grpc/models/Marketdata/MarketStatusRequest.py,sha256=ajyI4UlvFusyM0743dukT4KFZTlp9iUh0lTGWl6n7nw,1056
 architect_py/grpc/models/Marketdata/SubscribeCandlesRequest.py,sha256=ck5pQx54uymlpR-jxFpxcW0LPDLU7R8GvqLqF-7GmoU,1508
 architect_py/grpc/models/Marketdata/SubscribeCurrentCandlesRequest.py,sha256=QuSNIXARFT--djk_Kl3SUWHfUwAfaasqzZ0cyZfzeN0,1930
-architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py,sha256=dMyz0aPYxNiOg3CjWPQxUu0kf4QznFfm-adl4EotWls,1384
+architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py,sha256=Pq8tqLBHLwGbcJwWqKvurvRT3ARXVktLYWhyQtIeHX0,1855
 architect_py/grpc/models/Marketdata/SubscribeL2BookUpdatesRequest.py,sha256=8olH2zWguzq1RnmIAZ59tFTmGIBLAYuGanbiI3kamm0,1133
 architect_py/grpc/models/Marketdata/SubscribeLiquidationsRequest.py,sha256=6BhC4FJvHxm4yq9l_TmEioegdu8ZMFaoEA-bRC8WY7A,1039
 architect_py/grpc/models/Marketdata/SubscribeManyCandlesRequest.py,sha256=pel2GGysDsJXjPY7rkyqqyGS3MPl13YezJS7apihiFc,1512
@@ -108,7 +108,7 @@ architect_py/grpc/models/Marketdata/SubscribeTradesRequest.py,sha256=7P8FyNx6wij
 architect_py/grpc/models/Marketdata/Ticker.py,sha256=O4kJK1RyThYgfpvIr9mgRWAAkYgwwAKgOhEhbfDo9b4,11592
 architect_py/grpc/models/Marketdata/TickerRequest.py,sha256=Ay--5JKgCfdvlVWD2H6YSa_66NC3Dt6c-XK8JkbWhus,1008
 architect_py/grpc/models/Marketdata/TickerUpdate.py,sha256=sJ4wvCeGckMV30HwAcAsEMQbCzjN31OxF19q70jdxok,437
-architect_py/grpc/models/Marketdata/TickersRequest.py,sha256=_BYkOO2pk-terLNwyxN8gtHQxIrfPA7klodDeTS5ouM,2200
+architect_py/grpc/models/Marketdata/TickersRequest.py,sha256=x6UlQdAisnXgs3vbghQY3nuiFccSU3ueU0YJVAKaKUs,2359
 architect_py/grpc/models/Marketdata/TickersResponse.py,sha256=CLzKx-ItwH9-Qq8YruFhXh7TmtHwzNRMEOPJ9LQD9co,574
 architect_py/grpc/models/Marketdata/Trade.py,sha256=RKZq_HUDLxIE41caDrwf99V0c48kH2pm3XRCn5RLcEQ,2476
 architect_py/grpc/models/Marketdata/__init__.py,sha256=sIyaEvJdP-VmGTGPPqZuRjKn4bc7NUClJ76Gd5uq-5s,57
@@ -170,28 +170,31 @@ architect_py/utils/orderbook.py,sha256=JM02NhHbmK3sNaS2Ara8FBY4TvKvtMIzJW1oVd8KC
 architect_py/utils/pandas.py,sha256=QHz2ynj4T92FobuzRaNoH3ypArHoSDCiGtZ3PVXJ2vo,1017
 architect_py/utils/price_bands.py,sha256=j7ioSA3dx025CD5E2Vg7XQvmjPvxQb-gzQBfQTovpTw,21874
 architect_py/utils/symbol_parsing.py,sha256=OjJzk2c6QU2s0aJMSyVEzlWD5Vy-RlakJVW7jNHVDJk,845
-architect_py-5.1.2.dist-info/licenses/LICENSE,sha256=6P0_5gYN8iPWPZeqA9nxiO3tRQmcSA1ijAVR7C8j1SI,11362
+architect_py-5.1.4b1.dist-info/licenses/LICENSE,sha256=6P0_5gYN8iPWPZeqA9nxiO3tRQmcSA1ijAVR7C8j1SI,11362
 examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-examples/book_subscription.py,sha256=W7pldoHIPOclhxhxFvVmsBTB1wx1aS4OgAg0EFXeAzA,1461
-examples/candles.py,sha256=Vc1IgwgFPmpAtURdNXGhgdL82y_JNcryADE30r3vVY0,756
-examples/common.py,sha256=K2ppu4vdlTNsL1oX5RDrNKczljfPVOTPzDia1Abrppg,2987
+examples/book_subscription.py,sha256=1WFQN_QCE8cRS_CIv2k0NxqpK37fA9-Ja2Kfxs8vsb8,1461
+examples/candles.py,sha256=T71TsxbfXCT6mrJZmTgdTKesJFdQhYP_4AsiNK-8KyQ,756
+examples/config.py,sha256=rv6x7QYJO6ckvpRcwghyJbkL_lTBPnK0u6nKgkYTvxQ,1858
 examples/external_cpty.py,sha256=xxGXONXwoWIS8ys0SgxHLSmntAi1BlwV2NR9WD1kvpc,2527
-examples/funding_rate_mean_reversion_algo.py,sha256=3wy9SsQ5brYRRyzEAl6IV5g-MGFSfYInmHN0T50jzOg,6502
-examples/order_sending.py,sha256=1OV5YSmEVXqeuzLsUWmwnjsdsLFNUdnmwdmdwnKuIYI,3313
-examples/stream_l1_marketdata.py,sha256=6Hkfacbexmgj7n-zT7bIyGksghSl5asrDErtRcjAn2E,728
-examples/stream_l2_marketdata.py,sha256=ZeQlap7YeLg19IdAHnSc95IFFaQ7PgCY2S0MZY4RIvY,1091
-examples/trades.py,sha256=ikMvpLy_b5Y4_2URhkAgdOTzAEC-DAAKilUZenw_J_c,561
-examples/tutorial_async.py,sha256=paanYeCyydHVE_srO-lxj9tpmf4r535dhYaXUV95SN8,2646
-examples/tutorial_sync.py,sha256=G6jsxlpxnaewll4XCER6AYMCAK-1Z_A0Zef4D9CKGvw,2824
+examples/funding_rate_mean_reversion_algo.py,sha256=Y9zJ7N4TEm36TH3jIHMbDxucKOOlD2VHe5oNcLai11o,6502
+examples/order_sending.py,sha256=0M5eK20nDO5KXJZV-yidC7HR_RHP3uJL9f-q9FF0BIs,3313
+examples/orderflow_channel.py,sha256=L6W9aZS95Xmjl1IvrKA1Cp06r9-QOERsBETLOg3EImk,1891
+examples/orderflow_streaming.py,sha256=BtVwCYWBCpytaAFN9u2WPgGCugyNMsGa6nA1dPWuVLs,1300
+examples/stream_l1_marketdata.py,sha256=ZkXcm5XOpG6epPn3EhmqlVJyYBwh87I0QHtuOmKjRpg,728
+examples/stream_l2_marketdata.py,sha256=AeVOBBLdg-0OQE0gouHiLaUfGAAmUoVxif9XBrRo1tQ,1091
+examples/termutils.py,sha256=ZZrky5Ftn4UoLPKGffGvUl1Z8CtvDoNjEtUH4S1a_KY,1133
+examples/trades.py,sha256=0OzWQVTuIrC0KlisY0Tc-3pmWNP0m0-eCSntCV6Qdh8,561
+examples/tutorial_async.py,sha256=FNMjP2WmszRB0OXoMbshJ775LoPDzm55UZICa9ztr5w,2639
+examples/tutorial_sync.py,sha256=w5Sqa0YFh0XnpoXuhD3WsKRKpR5cuTTNb7pCp-Aqnz0,2846
 scripts/add_imports_to_inits.py,sha256=bryhz6RpKAJsSieVMnXnRyLp8evNkpOsNUkBUPkk1WQ,4518
-scripts/correct_sync_interface.py,sha256=O8qxSqNSNIL8KrgZ4C8rjs_pUCdcA1WeqKAggM2DINw,4056
+scripts/correct_sync_interface.py,sha256=gTSJLDAT8s-ayN_JqgKbeM6c3DYZOapduS_GIqrvD-A,4134
 scripts/generate_functions_md.py,sha256=-rVRhbHlDodGH2a32UCsMLIpgXtDvOhBmkHa0RqDpCA,6232
 scripts/postprocess_grpc.py,sha256=QqFZdOLH6hLPRCLUkf7qvuGooLsXulcpMghCpleHc-A,23198
 scripts/preprocess_grpc_schema.py,sha256=p9LdoMZzixBSsVx7Dy3_8uJzOy_QwCoVMkAABQKUsBA,22894
 scripts/prune_graphql_schema.py,sha256=hmfw5FD_iKGKMFkq6H1neZiXXtljFFrOwi2fiusTWE4,6210
 templates/exceptions.py,sha256=tIHbiO5Q114h9nPwJXsgHvW_bERLwxuNp9Oj41p6t3A,2379
 templates/juniper_base_client.py,sha256=B8QF4IFSwqBK5UY2aFPbSdYnX9bcwnlxLK4ojPRaW0E,12705
-architect_py-5.1.2.dist-info/METADATA,sha256=9Kut96FHWLTstvnSxNhaf5bvSCdI1JzzY4BettvbdBk,2559
-architect_py-5.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-architect_py-5.1.2.dist-info/top_level.txt,sha256=UjtO97OACFQ9z5MzS-X2wBlt5Ovk1vxakQPKfokI454,40
-architect_py-5.1.2.dist-info/RECORD,,
+architect_py-5.1.4b1.dist-info/METADATA,sha256=T9t4zgT065VEpW9f1WGsCXkUNK_O1UQimeeqfrem1uY,2640
+architect_py-5.1.4b1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+architect_py-5.1.4b1.dist-info/top_level.txt,sha256=UjtO97OACFQ9z5MzS-X2wBlt5Ovk1vxakQPKfokI454,40
+architect_py-5.1.4b1.dist-info/RECORD,,

examples/book_subscription.py

@@ -6,7 +6,7 @@ from pydantic import ValidationError
 from architect_py import AsyncClient, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 buy_columns = "{:>15} {:>15} {:>15}"
 sell_columns = "{:<15} {:<15} {:<15}"

examples/candles.py

@@ -3,7 +3,7 @@ import asyncio
 from architect_py import AsyncClient, CandleWidth, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/{common.py → config.py}

@@ -16,15 +16,17 @@ class Config:
 
 def load_config() -> Config:
     loaded = load_dotenv()
+
     if not loaded:
         raise ValueError(
-            "⚠️  .env file not found or had no new variables\n"
-            "Please create a .env file with the following variables:\n"
+            "⚠️  .env file not found or had no new variables\n\n"
+            "Please create a .env file with the following variables:\n\n"
             "ARCHITECT_ENDPOINT=your_endpoint (e.g. app.architect.co)\n"
             "ARCHITECT_API_KEY=your_api_key (get from https://app.architect.co/user/account)\n"
             "ARCHITECT_API_SECRET=your_api_secret\n"
             "ARCHITECT_PAPER_TRADING=true/false\n"
         )
+
     endpoint = os.environ["ARCHITECT_ENDPOINT"]
     api_key = os.getenv("ARCHITECT_API_KEY")
     api_secret = os.getenv("ARCHITECT_API_SECRET")
@@ -49,7 +51,6 @@ def load_config() -> Config:
 
 def connect_client():
     config = load_config()
-
     c = Client(
         endpoint=config.endpoint,
         api_key=config.api_key,
@@ -68,48 +69,3 @@ async def connect_async_client():
         paper_trading=config.paper_trading,
     )
     return c
-
-
-buy_columns = "{:>15} {:>15} {:>15}"
-sell_columns = "{:<15} {:<15} {:<15}"
-green = "\033[32m"
-red = "\033[31m"
-normal = "\033[0m"
-
-
-def print_book(book):
-    print(
-        (buy_columns + " " + sell_columns).format(
-            "Total", "Size", "Bid", "Ask", "Size", "Total"
-        )
-    )
-    for i in range(min(20, len(book.bids), len(book.asks))):
-        b = book.bids[i]
-        s = book.asks[i]
-        print(
-            (green + buy_columns).format(b.total, b.amount, b.price),
-            (red + sell_columns).format(s.price, s.amount, s.total),
-        )
-    print(normal)
-
-
-def print_open_orders(orders):
-    if len(orders) == 0:
-        print("No open orders")
-    else:
-        for o in orders:
-            print(
-                f"  • {o.order.market.name} {o.order.dir} {o.order.quantity} {o.order.order_type.limit_price}"
-            )
-
-
-def confirm(prompt: str):
-    """
-    Ask user to enter Y or N (case-insensitive).
-    :return: True if the answer is Y.
-    :rtype: bool
-    """
-    answer = ""
-    while answer not in ["y", "n"]:
-        answer = input(f"{prompt} [Y/N]? ").lower()
-    return answer == "y"

examples/funding_rate_mean_reversion_algo.py

@@ -24,7 +24,7 @@ from architect_py.grpc.models.Orderflow.OrderflowRequest import (
     PlaceOrder,
 )
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 venue = "BINANCE"
 product = "BTC-USDT Perpetual"

examples/order_sending.py

@@ -4,7 +4,7 @@ from datetime import datetime, timedelta, timezone
 from decimal import Decimal
 
 from architect_py import AsyncClient, OrderDir, OrderType, TimeInForce, TradableProduct
-from examples.common import connect_async_client
+from examples.config import connect_async_client
 
 LOGGER = logging.getLogger(__name__)
 

examples/orderflow_channel.py

@@ -0,0 +1,56 @@
+# """
+# Example of using a bidirectional orderflow channel with the Architect OEMS.
+
+# This connection style is ~equivalent to having a websocket.
+
+# This code example sends a series of orders to Architect while concurrently
+# listening to orderflow events.  Compare to `examples/orderflow_streaming.py`,
+# which accomplishes the same thing but using a separate asyncio task.
+# """
+
+# import asyncio
+# from decimal import Decimal
+
+# from architect_py import AsyncClient, OrderDir, PlaceOrderRequest
+# from architect_py.grpc.models.Orderflow.OrderflowRequest import PlaceOrder
+
+# from .config import connect_async_client
+
+
+# async def send_orders(client: AsyncClient):
+#     symbol = await client.get_front_future("ES CME Futures")
+#     print(f"symbol={symbol}")
+
+#     while True:
+#         await asyncio.sleep(1)
+#         snap = await client.get_l1_book_snapshot(symbol, "CME")
+#         if snap.best_ask is not None:
+#             limit_price = snap.best_ask[0]
+#             print(f"\nPlacing buy order at {limit_price}\n")
+#             try:
+#                 req = PlaceOrderRequest.new(
+#                     symbol=symbol,
+#                     execution_venue="CME",
+#                     dir=OrderDir.BUY,
+#                     quantity=Decimal(1),
+#                     limit_price=limit_price,
+#                     post_only=True,
+#                     time_in_force="DAY",
+#                     order_type="LIMIT",
+#                 )
+#                 print(f"req={req}")
+#                 yield PlaceOrder(req)
+#             except Exception as e:
+#                 print(f"Error placing order: {e}")
+#         else:
+#             print("\nNo ask price from snapshot, doing nothing\n")
+
+
+# async def main():
+#     client = await connect_async_client()
+
+#     async for event in client.orderflow(send_orders(client)):
+#         print(f" --> {event}")
+
+
+# asyncio.run(main())

examples/orderflow_streaming.py

@@ -0,0 +1,47 @@
+"""
+Example of streaming orderflow events from the Architect OEMS.
+
+This code example sends a series of orders to Architect in one asyncio
+task, while concurrently listening to orderflow events in another.
+"""
+
+import asyncio
+from decimal import Decimal
+
+from architect_py import AsyncClient, OrderDir
+
+from .config import connect_async_client
+
+
+async def send_orders(client: AsyncClient):
+    symbol = await client.get_front_future("ES CME Futures")
+    print(f"symbol={symbol}")
+
+    while True:
+        await asyncio.sleep(1)
+        snap = await client.get_l1_book_snapshot(symbol, "CME")
+        if snap.best_ask is not None:
+            limit_price = snap.best_ask[0]
+            print(f"\nPlacing buy order at {limit_price}\n")
+            await client.place_limit_order(
+                symbol=symbol,
+                execution_venue="CME",
+                dir=OrderDir.BUY,
+                quantity=Decimal(1),
+                limit_price=limit_price,
+                post_only=True,
+            )
+        else:
+            print("\nNo ask price from snapshot, doing nothing\n")
+
+
+async def main():
+    client = await connect_async_client()
+
+    asyncio.create_task(send_orders(client))
+
+    async for event in client.stream_orderflow():
+        print(f" --> {event}")
+
+
+asyncio.run(main())

examples/stream_l1_marketdata.py

@@ -2,7 +2,7 @@ import asyncio
 
 from architect_py import AsyncClient, TradableProduct
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/stream_l2_marketdata.py

@@ -2,7 +2,7 @@ import asyncio
 
 from architect_py import AsyncClient, TradableProduct
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 buy_columns = "{:>15} {:>15}"
 sell_columns = "{:<15} {:<15}"

examples/termutils.py

@@ -0,0 +1,44 @@
+buy_columns = "{:>15} {:>15} {:>15}"
+sell_columns = "{:<15} {:<15} {:<15}"
+green = "\033[32m"
+red = "\033[31m"
+normal = "\033[0m"
+
+
+def print_book(book):
+    print(
+        (buy_columns + " " + sell_columns).format(
+            "Total", "Size", "Bid", "Ask", "Size", "Total"
+        )
+    )
+    for i in range(min(20, len(book.bids), len(book.asks))):
+        b = book.bids[i]
+        s = book.asks[i]
+        print(
+            (green + buy_columns).format(b.total, b.amount, b.price),
+            (red + sell_columns).format(s.price, s.amount, s.total),
+        )
+    print(normal)
+
+
+def print_open_orders(orders):
+    if len(orders) == 0:
+        print("No open orders")
+    else:
+        for o in orders:
+            print(
+                f"  • {o.order.market.name} {o.order.dir} {o.order.quantity} {o.order.order_type.limit_price}"
+            )
+
+
+def confirm(prompt: str):
+    """
+    Ask user to enter Y or N (case-insensitive).
+
+    :return: True if the answer is Y.
+    :rtype: bool
+    """
+    answer = ""
+    while answer not in ["y", "n"]:
+        answer = input(f"{prompt} [Y/N]? ").lower()
+    return answer == "y"

examples/trades.py

@@ -3,7 +3,7 @@ import asyncio
 from architect_py import AsyncClient, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/tutorial_async.py

@@ -2,7 +2,8 @@ import asyncio
 from decimal import Decimal
 
 from architect_py import OrderDir, OrderStatus, TradableProduct
-from examples.common import connect_async_client
+
+from .config import connect_async_client
 
 
 async def main():

examples/tutorial_sync.py

@@ -5,7 +5,8 @@ from decimal import Decimal
 from architect_py import OrderDir, OrderStatus
 from architect_py.utils.nearest_tick import TickRoundMethod
 
-from .common import confirm, connect_client, print_book, print_open_orders
+from .config import connect_client
+from .termutils import confirm, print_book, print_open_orders
 
 c = connect_client()
 

scripts/correct_sync_interface.py

@@ -65,8 +65,11 @@ def add_correct_docstring_and_correct_the_init(content: str):
         param_parts = [str(p) for p in pos_params]
 
     # turn Optional[Type] into Type | None
-    opt_re = re.compile(r"\b(?:Optional|Option)\[([^]]+)]")
-    param_parts = [opt_re.sub(r"\1 | None", s) for s in param_parts]
+    opt_re = re.compile(r"\b(?:Optional|Option)\[(.+)]", re.DOTALL)
+    param_parts = [
+        opt_re.sub(lambda m: f"{m.group(1)} | None", s)  # Optional[T] → T | None
+        for s in param_parts
+    ]
 
     param_str = ", ".join(param_parts)