Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.privataswap.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL

https://api.privataswap.com/partner/v1
Sandbox: https://api.privataswap.com/partner/v1 with pk_test_ key.

​
Authentication

Every request requires X-API-Key: pk_live_... or pk_test_.... See Authentication.

​
Versioning

Current: v1.2. Breaking changes ship under new major path (/partner/v2). Additive changes are backward-compatible inside v1.x.

​
Conventions

  • Times: ISO 8601 UTC (2026-05-21T13:00:00Z)
  • Amounts: strings, native token precision
  • Errors: structured JSON, see Error codes
  • Idempotency: Idempotency-Key on POST /orders, 24h window
  • Rate limits: 100 rps default, see Rate limits

Quickstart

Create your first order in 5 minutes.

SSE streaming

Live order updates without webhooks.

Webhooks

HMAC-signed delivery with dual-sign rotation.

SDK (JS/TS)

Typed client with auto-retry and SSE.