> ## 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.

# API Reference

> REST API for the Privata swap aggregator. 50+ providers, single surface.

## 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](/guides/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](/guides/errors)
* Idempotency: `Idempotency-Key` on `POST /orders`, 24h window
* Rate limits: 100 rps default, see [Rate limits](/guides/rate-limits)

## Quick links

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/guides/quickstart">
    Create your first order in 5 minutes.
  </Card>

  <Card title="SSE streaming" icon="signal-stream" href="/guides/sse-streaming">
    Live order updates without webhooks.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/guides/webhooks">
    HMAC-signed delivery with dual-sign rotation.
  </Card>

  <Card title="SDK (JS/TS)" icon="js" href="/sdk/js/install">
    Typed client with auto-retry and SSE.
  </Card>
</CardGroup>