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

# Paxos SDKs

> Official Paxos SDKs for Go, Python, TypeScript and Java.

Paxos SDKs provide an idiomatic interface to the Paxos API in Go, Python, TypeScript and Java. Each SDK handles authentication, retries, pagination and error parsing so you can focus on your integration.

## Choose your language

> [card] [Go](https://docs.paxos.com/sdks/quickstart/go.md)
>
> `go get github.com/paxosglobal/paxos-sdk-go`

> [card] [Python](https://docs.paxos.com/sdks/quickstart/python.md)
>
> `pip install paxos-sdk`

> [card] [TypeScript](https://docs.paxos.com/sdks/quickstart/typescript.md)
>
> `npm install @paxosglobal/sdk`

> [card] [Java](https://docs.paxos.com/sdks/quickstart/java.md)
>
> Maven artifact `com.paxos:paxos-sdk`

## Features

* **Automatic authentication**: OAuth2 client credentials, with token caching and refresh. See [Authentication](https://docs.paxos.com/sdks/authentication.md).
* **Automatic pagination**: list methods return iterators that fetch subsequent pages as you consume them.
* **Typed errors**: API errors follow RFC 7807 and carry a `request_id` to share with [Support](https://support.paxos.com).
* **Retries with backoff**: 429 responses are retried with exponential backoff, up to 3 retries. 500, 502, 503 and 504 responses are retried for reads and for create requests that carry a `ref_id`, which the SDK fills in automatically.
* **Sandbox mode**: a single client option targets the Paxos [Sandbox](https://docs.paxos.com/guides/developer/sandbox.md).
* **Decimal precision**: monetary amounts use decimal types, never floating point.
* **Request signing**: optionally sign API requests with an Ed25519 or P-256 key.
* **Automatic `ref_id`**: create requests that accept a `ref_id` get one filled in if you omit it.
* **Debug logging**: set `PAXOS_LOG_LEVEL=debug`. Logs never include request or response bodies or query strings.
* **Testing helpers**: each SDK bundles a mock server for tests, so you can run without calling the Paxos API.

## Languages

| Language | Package | Install | Minimum runtime |
| - | - | - | - |
| Go | [`github.com/paxosglobal/paxos-sdk-go`](https://pkg.go.dev/github.com/paxosglobal/paxos-sdk-go) | `go get github.com/paxosglobal/paxos-sdk-go` | Go 1.26 |
| Python | [`paxos-sdk`](https://pypi.org/project/paxos-sdk/) | `pip install paxos-sdk` | Python 3.11 |
| TypeScript | [`@paxosglobal/sdk`](https://www.npmjs.com/package/@paxosglobal/sdk) | `npm install @paxosglobal/sdk` | Node 22.12 |
| Java | [`com.paxos:paxos-sdk`](https://central.sonatype.com/artifact/com.paxos/paxos-sdk) | Maven or Gradle, see the [Java quickstart](https://docs.paxos.com/sdks/quickstart/java.md) | Java 11 |

> [!NOTE]
>
> These SDKs are in beta: we aim to avoid breaking changes, but they may occur before 1.0.

## API coverage

The SDKs are generated from the Paxos API v2 OpenAPI specification and cover every REST endpoint in the [API Reference](https://docs.paxos.com/api-reference/introduction.md). WebSocket streams are not included. Each method's documentation in the SDK states the OAuth scope it requires.

## Next steps

* Complete a quickstart for your language. Each one runs against the Sandbox.
* Read [Authentication](https://docs.paxos.com/sdks/authentication.md) to learn how credentials and scopes work.

> Questions? Contact [Support](https://support.paxos.com).
