> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Swaps API

> Een Swap zet waarde om tussen ondersteunde tokens, chains of walletbestemmingen, of tussen fiatvaluta tegen de middenkoers, voor een account of gebruiker.

Een swap-offerte toont vooraf de verwachte opbrengst, kosten en goedkeuringsvereisten voordat je de swap aanmaakt.

Gebruik de Swaps API om een offerte voor een omzetting op te vragen, de swap aan te maken, recente swaps weer te geven en de status van een swap op te halen totdat deze is voltooid.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Swaps weergeven](https://docs.whop.com/nl/api-reference/swaps/list-swaps.md) | GET `/swaps` |
| [Swap ophalen](https://docs.whop.com/nl/api-reference/swaps/retrieve-swap.md) | GET `/swaps/{id}` |
| [Swap aanmaken](https://docs.whop.com/nl/api-reference/swaps/create-swap.md) | POST `/swaps` |
| [Swap-offerte aanmaken](https://docs.whop.com/nl/api-reference/swaps/create-swap-quote.md) | POST `/swaps/quote` |

## Attributen

**id** `string` *required*

Swap-ID.

**account\_id** `string` *required*

Account dat eigenaar is van de swap: een bedrijfs-ID met prefix `biz_`, of het
gebruikers-ID voor een persoonlijk account.

**amount** `string | null` *required*

Het from\_token-bedrag dat de swap bij het aanmaken zou besteden, als
decimale string. Een swap die met `all` is aangemaakt, rapporteert het
walletsaldo dat hij heeft gelezen. Null voor een fiatpaar.

**error** `string | null`

Laatste fout die voor een mislukte swap is geretourneerd.

**object** `string` *required*

**status** `string` *required*

Huidige status van de swap. `complete` en `failed` zijn eindstatussen.

Beschikbare opties: `queued`, `working`, `complete`, `failed`

**tx\_hashes** `string[]` *required*

On-chain transactiehashes die door de swap zijn geproduceerd.

**user\_id** `string | null` *required*

Gebruiker wiens persoonlijke account eigenaar is van de swap, met prefix
`user_`. Null voor een bedrijfsaccount.

```json Swap theme={null}
{
	"id": "swap_xxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"amount": "0.052341",
	"error": null,
	"object": "swap",
	"status": "complete",
	"tx_hashes": ["0x1234567890abcdef"],
	"user_id": null
}
```


## Related topics

- [ConvertElement](https://docs.whop.com/nl/elements/latest/wallet/convert.md)
- [List Swaps](https://docs.whop.com/nl/api-reference/swaps/list-swaps.md)
- [Retrieve Swap](https://docs.whop.com/nl/api-reference/swaps/retrieve-swap.md)
