> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fairground.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK Overview

> Install the Fairground Python SDK and choose async or sync clients.

The **forte\_perpetuals\_sdk** package talks to Fairground Perpetuals over HTTP using [ConnectRPC](https://connectrpc.com/). The reference pages in this site are regenerated from published API docs; treat the [upstream README](https://github.com/Forte-Service-Company-Ltd/perpetuals-sdk-python) as the full source for clone-and-build steps, protobuf regeneration, and the optional mTLS proxy.

## Install

```bash theme={null}
pip install forte-perpetuals-sdk
```

For development against a git checkout, use editable install and initialize submodules per the repository README.

## Clients

* **Async:** `PerpetualsClient` with `httpx.AsyncClient` (recommended).
* **Sync:** `PerpetualsClientSync` with `httpx.Client`.

See the [PerpetualsClient](/developers/sdk-reference/python/reference/perpetuals-client) and [PerpetualsClientSync](/developers/sdk-reference/python/reference/perpetuals-client-sync) reference pages for methods and signatures.

## Next steps

* [PerpetualsClient](/developers/sdk-reference/python/reference/perpetuals-client) — async client methods and signatures.
* [Function reference](/developers/sdk-reference/python/reference/get-order) — generated pages for individual SDK helpers.
