# Overview

Build typed Polyester integrations with the official Python API-key SDK.

The official Python SDK is an **API-key** client for Polyester ConnectRPC APIs and Centrifugo WebSocket Protobuf streams. It is built for trading bots, automated execution, and backend automation, not browser wallet login.

Python ships **async** (`AsyncPolyester`) and **sync** (`Polyester`) clients with the same service tree. Prefer async for bots with streams.

## What you can build

- **Market data:** overview, candles, order books, public trades, heatmap, chain analytics
- **Trading:** spot orders (including batch / cancel-all), attached risk, standalone triggers
- **Accounts:** balances (funding vs trading), subaccounts, policies, API keys, profile
- **Funding:** deposit addresses, trading withdraws, internal transfers, lifecycle, Zipper config
- **On-chain helpers:** Funding → Trading and Funding → external via the `chain` module
- **Realtime:** public and private streams with fail-closed overflow behavior

## Intentionally not in this SDK

Wallet login, session MFA enrollment/challenges, and account resolve/lookup require interactive JWT/session flows. Use the [TypeScript SDK](https://testnet.polyester.com/docs/sdk/typescript/get-started/overview) for those. SBE and FIX are separate transports, see the [connectivity matrix](https://testnet.polyester.com/docs/developer-docs/getting-started/connectivity-matrix).

Details: [Limitations & non-features](https://testnet.polyester.com/docs/sdk/python/concepts/limitations-and-non-features).

## Resources

- [Python SDK repository](https://github.com/Fabric-Labs/polyester-sdk-python)
- [Runnable examples](https://github.com/Fabric-Labs/polyester-examples-python)
- [SDK capability matrix](https://testnet.polyester.com/docs/developer-docs/getting-started/sdk-capability-matrix)
- [Ed25519 API keys](https://testnet.polyester.com/docs/developer-docs/authentication-security/ed25519-api-keys)
- [Public Protobuf contracts](https://github.com/Fabric-Labs/polyester-proto)

Next: [Installation](https://testnet.polyester.com/docs/sdk/python/get-started/installation).