tossinvest

Async Python client for the Toss Securities (토스증권) Open API — a faithful port of tossinvest-rust.

• Pure REST client with OAuth2 client_credentials auth
• Exact decimals (Decimal, never float), unknown-tolerant open enums, status-split envelope decoding
• Per-group rate limiting (GCRA + adaptive AIMD) with the 09:00–09:10 KST peak-window awareness
• Account-scoped client handle so the X-Tossinvest-Account header is unforgettable

Status: alpha. Stateless SDK (model → rate → client) and the stateful/observable layer (StateHandle) are implemented.

Install

pip install tossinvest

Quickstart

import asyncio
from tossinvest import TossClient, ClientConfig

async def main():
    async with TossClient(ClientConfig(client_id="...", client_secret="...")) as client:
        prices = await client.prices(["005930"])
        price = prices[0]
        print(price.last_price, price.currency)

asyncio.run(main())

Response models live in tossinvest.model (e.g. from tossinvest.model import PriceResponse).

Stateful layer (StateHandle)

The L4/L5 reconciler maintains a live, single-writer projection of your orders, holdings, and prices, with optimistic mutations and on-demand refresh:

import asyncio
from tossinvest import TossClient, ClientConfig
from tossinvest.state import StateHandle

async def main():
    async with TossClient(ClientConfig(client_id="...", client_secret="...")) as client:
        account = client.account(seq)
        async with await StateHandle.spawn(account) as handle:
            async with handle.watch_prices(["005930"]):   # demand lease
                snap = handle.snapshot()                   # wait-free read
                print(snap.prices.get("005930"))

asyncio.run(main())

License

Apache-2.0