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

# API Swaps

> Un Swap convertit de la valeur entre des jetons, des chaînes ou des destinations de portefeuille pris en charge, ou entre des devises fiat au taux médian du marché, pour un compte ou un utilisateur.

Un devis de swap affiche un aperçu du montant attendu en sortie, des frais et des exigences d'approbation avant que vous ne créiez le swap.

Utilisez l'API Swaps pour obtenir un devis de conversion, créer le swap, lister les swaps récents et récupérer le statut d'un swap jusqu'à ce qu'il soit terminé.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les swaps](https://docs.whop.com/fr/api-reference/swaps/list-swaps.md) | GET `/swaps` |
| [Récupérer un swap](https://docs.whop.com/fr/api-reference/swaps/retrieve-swap.md) | GET `/swaps/{id}` |
| [Créer un swap](https://docs.whop.com/fr/api-reference/swaps/create-swap.md) | POST `/swaps` |
| [Créer un devis de swap](https://docs.whop.com/fr/api-reference/swaps/create-swap-quote.md) | POST `/swaps/quote` |

## Attributs

**id** `string` *required*

ID du swap.

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

Compte propriétaire du swap : un ID d'entreprise préfixé par `biz_`, ou l'ID
utilisateur pour un compte personnel.

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

Le montant de from\_token que le swap a été créé pour dépenser, sous forme de
chaîne décimale. Un swap créé avec `all` indique le solde du portefeuille qu'il
a lu. Null pour une paire fiat.

**error** `string | null`

Dernière erreur renvoyée pour un swap échoué.

**object** `string` *required*

**status** `string` *required*

Statut actuel du swap. `complete` et `failed` sont des statuts finaux.

Options disponibles : `queued`, `working`, `complete`, `failed`

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

Hachages des transactions on-chain produites par le swap.

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

Utilisateur dont le compte personnel est propriétaire du swap, préfixé par
`user_`. Null pour un compte d'entreprise.

```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

- [List Swaps](https://docs.whop.com/fr/api-reference/swaps/list-swaps.md)
- [Retrieve Swap](https://docs.whop.com/fr/api-reference/swaps/retrieve-swap.md)
- [Create Swap](https://docs.whop.com/fr/api-reference/swaps/create-swap.md)
