Skip to main content
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

Go

go get github.com/paxosglobal/paxos-sdk-go

Python

pip install paxos-sdk

TypeScript

npm install @paxosglobal/sdk

Java

Maven artifact com.paxos:paxos-sdk

Features

  • Automatic authentication: OAuth2 client credentials, with token caching and refresh. See Authentication.
  • 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.
  • 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.
  • 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

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. 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 to learn how credentials and scopes work.
Questions? Contact Support.