# Privata

> API and SDK for integrating Privata swap aggregator into crypto wallets. 50+ providers, single REST surface, privacy by design.

## Docs

- [Uptime probe endpoint](https://docs.privataswap.com/api-reference/health/uptime-probe-endpoint.md)
- [API Reference](https://docs.privataswap.com/api-reference/introduction.md): REST API for the Privata swap aggregator. 50+ providers, single surface.
- [Operational event for partner integration](https://docs.privataswap.com/api-reference/operational-event-for-partner-integration.md)
- [Order lifecycle event](https://docs.privataswap.com/api-reference/order-lifecycle-event.md): Sent to your registered webhook URL on every order status change. Signed with HMAC-SHA256 using your webhook secret in header `X-Privata-Signature`. Body includes a deterministic `event_id` used for deduplication.
- [Create an exchange order](https://docs.privataswap.com/api-reference/orders/create-an-exchange-order.md)
- [Get order status](https://docs.privataswap.com/api-reference/orders/get-order-status.md)
- [Get partner profile and aggregate stats](https://docs.privataswap.com/api-reference/partner/get-partner-profile-and-aggregate-stats.md)
- [List partner orders](https://docs.privataswap.com/api-reference/partner/list-partner-orders.md)
- [Get best-rate estimate for a swap](https://docs.privataswap.com/api-reference/public/get-best-rate-estimate-for-a-swap.md)
- [Get min/max amounts for a pair](https://docs.privataswap.com/api-reference/public/get-minmax-amounts-for-a-pair.md)
- [List supported currencies](https://docs.privataswap.com/api-reference/public/list-supported-currencies.md)
- [List supported pairs](https://docs.privataswap.com/api-reference/public/list-supported-pairs.md)
- [Confirm refund action for an order in refund_required state](https://docs.privataswap.com/api-reference/refunds/confirm-refund-action-for-an-order-in-refund_required-state.md): Only valid when the order's `refund_capability` is `programmatic`. Must be called within `refund_window_hours` from `order.refund_required`. After the window the server auto-applies `refund_preference.default`.
- [List providers and their refund mode](https://docs.privataswap.com/api-reference/refunds/list-providers-and-their-refund-mode.md)
- [Subscribe to order status via SSE](https://docs.privataswap.com/api-reference/streaming/subscribe-to-order-status-via-sse.md): Returns `text/event-stream`. Each event id is `<order_id>:<status>:<unix_ms>`. Reconnect with `Last-Event-ID` header to resume from the in-memory ring buffer (60 s).
- [Manually resume a paused webhook](https://docs.privataswap.com/api-reference/webhooks/manually-resume-a-paused-webhook.md): Requires API key with scope `webhook:admin`.
- [Authentication](https://docs.privataswap.com/guides/authentication.md): API keys, scopes, prefixes and rate tiers.
- [Changelog](https://docs.privataswap.com/guides/changelog.md): API and SDK release notes.
- [Partner Dashboard](https://docs.privataswap.com/guides/dashboard.md): Self-service control plane for API keys, webhooks, orders, revenue, and team management at dashboard.privataswap.com.
- [Errors](https://docs.privataswap.com/guides/errors.md): All error codes with cause and recommended action.
- [Ops events](https://docs.privataswap.com/guides/ops-events.md): Operational signals for your integration health monitoring.
- [Order lifecycle](https://docs.privataswap.com/guides/order-lifecycle.md): Every status, every transition, every UX hint.
- [Quickstart](https://docs.privataswap.com/guides/quickstart.md): Create your first swap order in five minutes.
- [Rate limits](https://docs.privataswap.com/guides/rate-limits.md): Per-IP and per-partner limits across all endpoint classes.
- [Refund flow](https://docs.privataswap.com/guides/refund-flow.md): How refund_required resolves and what UX to ship.
- [Sandbox](https://docs.privataswap.com/guides/sandbox.md): Deterministic test environment isolated from production payouts.
- [SLA](https://docs.privataswap.com/guides/sla.md): Uptime guarantees, compensation formula and how to claim credits.
- [SSE streaming](https://docs.privataswap.com/guides/sse-streaming.md): Resumable Server-Sent Events for order status.
- [Webhooks](https://docs.privataswap.com/guides/webhooks.md): Signed HTTP callbacks with retry, deduplication and ops events.
- [Privata Wallet API](https://docs.privataswap.com/index.md): Integrate a 50+ provider swap aggregator into your wallet in a single REST surface.
- [ChangeNOW-compatible layer](https://docs.privataswap.com/sdk/compat/changenow.md): Drop-in for wallet plugins built against ChangeNOW v2.
- [Trocador-compatible layer](https://docs.privataswap.com/sdk/compat/trocador.md): Status: planned for v1.3 (2026 Q3).
- [Configuration](https://docs.privataswap.com/sdk/js/configuration.md): All Privata client options.
- [Errors](https://docs.privataswap.com/sdk/js/errors.md): Typed exception hierarchy in the JS SDK.
- [Install](https://docs.privataswap.com/sdk/js/install.md): Install @privata/wallet-api for JavaScript and TypeScript.
- [Quickstart](https://docs.privataswap.com/sdk/js/quickstart.md): First swap order with the JS SDK.
- [Streaming](https://docs.privataswap.com/sdk/js/streaming.md): Subscribe to order status with the SDK helper.
- [System status](https://docs.privataswap.com/status.md): Live operational status of Privata API, SSE, webhooks, and provider integrations.

## OpenAPI Specs

- [openapi](https://docs.privataswap.com/api-reference/openapi.yaml)