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.
Privata is a non-custodial aggregator. We never custody user funds — deposit addresses
belong to the executing provider. KYT and AML obligations stay on the licensed
provider side.
What you get
- 50+ swap providers behind one REST API (Exolix, ChangeNOW, FixedFloat, SimpleSwap, Godex, Trocador and 44 more).
- camelCase SDK for JS/TS (
@privata/wallet-api) and a wire-compatible ChangeNOW-style layer for legacy wallet plugins. - SSE event stream with resumable
Last-Event-IDplus signed webhooks for partners that prefer push. - Programmatic refunds on 5 providers, ticket-based on the rest, with capability flags surfaced per order.
- Sandbox isolated from production payouts. Use
pk_test_...keys.
Pick your path
Quickstart
Five-minute order creation flow with the JS SDK.
API Reference
Every endpoint with a live “Try it” playground.
Order lifecycle
States, transitions and what each one means.
Refund flow
How
refund_required resolves and what UX to ship.Base URLs
| Surface | URL |
|---|---|
| Native v1 | https://api.privataswap.com/partner/v1 |
| ChangeNOW-compatible | https://api.privataswap.com/v2/exchange |
| Status page | https://status.privataswap.com |
Versioning
We version at the URL path (/partner/v1). Breaking changes get a new path
(/partner/v2). Non-breaking additions land in the same path and are
announced in the changelog.