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

# Trades API

> Een Trade is één verzoek op de door Whop beheerde wallet van een account of gebruiker.

Een `order` op een perpetual handelt vanuit het handelssaldo, waarbij eerst de benodigde USDT0 vanuit de wallet wordt overgebracht als het saldo tekortschiet; een `order` op spot wisselt tussen USDT0 en het asset in de wallet. Een `close` sluit de volledige positie in één markt; als het account daarna geen posities meer heeft, stuurt een `withdraw`-trade het handelssaldo terug naar de wallet. Een `deposit` of `withdraw` verplaatst geld tussen de wallet en het handelssaldo. Perpetuals worden verhandeld op Hyperliquid.

Gebruik de Trades API om de markten weer te geven waarop je kunt handelen, orders te plaatsen, posities te sluiten en geld te verplaatsen, en om elke trade te volgen totdat deze is afgerond. Trades worden op de achtergrond uitgevoerd; een order die geld heeft overgebracht en niet wordt uitgevoerd, stuurt dat geld terug naar de wallet, en `funds_location` geeft aan waar het geld zich bevindt.

De trading-API, inclusief `include_trading` op accounts en gebruikers, is in bèta. Deze kan zonder nieuwe API-versiedatum veranderen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Trades weergeven](https://docs.whop.com/nl/api-reference/trades/list-trades.md) | GET `/trades` |
| [Trade ophalen](https://docs.whop.com/nl/api-reference/trades/retrieve-trade.md) | GET `/trades/{id}` |
| [Candles weergeven](https://docs.whop.com/nl/api-reference/trades/list-candles.md) | GET `/trades/candles` |
| [Markten weergeven](https://docs.whop.com/nl/api-reference/trades/list-markets.md) | GET `/trades/markets` |
| [Trade aanmaken](https://docs.whop.com/nl/api-reference/trades/create-trade.md) | POST `/trades` |
| [Trade annuleren](https://docs.whop.com/nl/api-reference/trades/cancel-trade.md) | POST `/trades/{id}/cancel` |

## Markten

[Markten weergeven](https://docs.whop.com/nl/api-reference/trades/list-markets.md) retourneert elke markt waarop je op Whop kunt handelen.

* **Spot:** weergegeven op symbool: `BTC`, `SOL` en `XAUT` (goud).
* **Perpetuals:** zoals `BTC`, en perpetuals op aandelen en grondstoffen van de `xyz`-exchange van Hyperliquid, zoals `xyz:TSLA`. Stuur de `id` mee als `market` wanneer je een trade aanmaakt.

Hetzelfde symbool kan twee keer voorkomen, één keer als perpetual en één keer als spot, dus gebruik `id` samen met `instrument_type` om ze van elkaar te onderscheiden. Resultaten worden gesorteerd op `id` en daarna op `instrument_type`.

Dit endpoint is openbaar: er is geen API-sleutel nodig en elk IP-adres kan maximaal 60 verzoeken per minuut doen.

De `size` van een perpetual order mag maximaal `size_decimals` decimalen hebben, en de `leverage` mag maximaal `max_leverage` zijn, wat `null` is voor een spotmarkt.

```json theme={null}
[
	{
		"id": "BTC",
		"instrument_type": "perpetual",
		"max_leverage": 40,
		"size_decimals": 5,
		"price": {
			"currency": "usd",
			"amount": "80155.500000",
			"decimals": 6,
			"display_decimals": 6
		}
	},
	{
		"id": "BTC",
		"instrument_type": "spot",
		"max_leverage": null,
		"size_decimals": 5,
		"price": {
			"currency": "usd",
			"amount": "80065.50000000",
			"decimals": 8,
			"display_decimals": 8
		}
	}
]
```

De marktlijst is, net als de rest van de trading-API, in bèta en kan zonder nieuwe API-versiedatum veranderen.

## Attributen

**id** `string` *required*

Trade-ID, met prefix `tint_`.

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

Het account dat eigenaar is van de trading-wallet, met prefix `biz_`. `null`
als een gebruiker de eigenaar is.

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

De USDT0 die een deposit, een spotaankoop of een perpetual order met
onvoldoende handelssaldo vanuit de wallet verstuurt, of de USDC die een
withdraw terugstuurt, in native eenheden, als decimale string. Een withdraw van
`all` toont na afloop wat er is verstuurd. Anders `null`.

**average\_price** `string | null` *required*

De gemiddelde uitvoeringsprijs van de order, in USD, als decimale string. Voor
spot de prijs waartegen de swap is geoffreerd. `null` als deze niet bekend is.

**client\_order\_id** `string | null` *required*

Het eigen ID van de aanroeper voor de trade, uniek binnen het account. `null`
als er geen is meegestuurd.

**completed\_at** `string | null` *required*

Wanneer de trade is geëindigd als voltooid of mislukt, als ISO
8601-tijdstempel. Daarvoor `null`.

**created\_at** `string` *required*

Wanneer de trade is aangemaakt, als ISO 8601-tijdstempel.

**external\_order\_id** `string | null` *required*

ID dat Whop met de order van deze trade naar de exchange stuurt, zodat
orderupdates van de exchange aan de trade kunnen worden gekoppeld. Op
Hyperliquid de `cloid` van de order die in `orderUpdates` wordt gerapporteerd,
een hexadecimale string van 32 tekens met prefix `0x`. Niet de
`client_order_id` van de aanroeper. `null` voor een deposit of withdraw.

**failure\_code** `string | null` *required*

Waarom de trade is mislukt, of `null`.

Beschikbare opties: `market_unavailable`, `leverage_too_high`, `amount_too_small`, `isolated_position_open`, `trading_paused`, `funding_failed`, `margin_unavailable`, `builder_fee_unapproved`, `leverage_rejected`, `leverage_unconfirmed`, `order_rejected`, `close_rejected`, `return_failed`, `withdraw_failed`

**filled\_size** `string | null` *required*

De uitgevoerde omvang van de order, in eenheden van de markt, als decimale
string. Voor een spotaankoop het bedrag dat volgens de offerte van de swap zou
worden geleverd. `null` totdat de order is uitgevoerd.

**funds\_location** `string | null` *required*

Waar het geld is als de trade niet is voltooid zoals gevraagd: `wallet`, `trading_account`, of `unknown` zolang een medewerker het controleert. Anders `null`.

Beschikbare opties: `wallet`, `trading_account`, `unknown`

**instrument\_type** `string | null` *required*

`perpetual` of `spot` voor een order, `perpetual` voor een close. `null` voor een deposit of withdraw.

Beschikbare opties: `perpetual`, `spot`

**leverage** `integer | null` *required*

De cross-leverage die vóór een openende perpetual order is ingesteld. `null`
voor een spotorder, close, deposit, withdraw of reduce-only order.

**market** `string | null` *required*

De markt, bijvoorbeeld `BTC` voor een perpetual of `XAUT` voor spot. `null`
voor een deposit of withdraw.

**metadata** `object` *required*

Vrije string-naar-string-annotaties die bij de trade zijn opgeslagen.

**object** `string` *required*

**order\_type** `string | null` *required*

`market`, `limit`, `take_profit` of `stop_loss` voor een order. Anders `null`.

Beschikbare opties: `market`, `limit`, `take_profit`, `stop_loss`

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

Voor een take-profit of stop-loss die met een order is meegestuurd, de trade
van die order, met prefix `tint_`. Anders `null`.

**price** `object | null` *required*

De limietprijs van de order in USD. De prijs van een marktorder is de middenprijs verschoven met `slippage_bps`; die van een take-profit of stop-loss is de slechtste prijs waartegen de marktorder na activering mag worden uitgevoerd. `null` voor andere typen.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is
> bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
> afrondt.
>
> **currency** `string` *required*
>
> Valutacode volgens ISO 4217 van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
> zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

**reduce\_only** `boolean | null` *required*

Of de order een positie alleen kan verkleinen. `null` voor andere typen.

**side** `string | null` *required*

`buy` of `sell` voor een order. Anders `null`.

Beschikbare opties: `buy`, `sell`

**size** `string | null` *required*

De orderomvang in eenheden van de markt, als decimale string. `null` voor
andere typen.

**status** `string` *required*

`pending` totdat de trade begint. `processing` terwijl deze loopt, ook terwijl een niet-uitgevoerde order het overgebrachte geld terugstuurt naar de wallet. `completed` als de trade heeft gedaan wat gevraagd werd. `failed` als dat niet zo is; `funds_location` geeft aan waar het geld is. `in_review` als de uitkomst onbekend is en een medewerker het controleert.

Beschikbare opties: `pending`, `processing`, `in_review`, `completed`, `failed`

**status\_detail** `string | null` *required*

`partial_fill` als de order slechts voor een deel van de omvang is uitgevoerd. Anders `null`.

Beschikbare opties: `partial_fill`

**step** `string | null` *required*

Wat een lopende trade nu doet: `depositing` terwijl de USDT0 van de wallet naar de bridge wordt gestuurd, `landing` na het versturen en totdat het geld het handelssaldo bereikt, `placing` terwijl de order of close bij het handelsplatform ligt, `withdrawing` terwijl USDC terug naar de wallet gaat, `returning` terwijl geld dat een niet-uitgevoerde order heeft overgebracht teruggaat. Een spotorder is `quoting` terwijl de swap wordt geprijsd, `swapping` terwijl deze onchain wordt uitgevoerd, en `crediting` totdat het nieuwe saldo in de wallet zichtbaar is. `null` zodra de trade niet meer pending of processing is.

Beschikbare opties: `depositing`, `landing`, `placing`, `withdrawing`, `returning`, `quoting`, `swapping`, `crediting`

**trigger\_price** `object | null` *required*

De prijs in USD waarbij een take-profit of stop-loss de marktorder verstuurt. `null` voor andere orders en typen.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is
> bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg
> afrondt.
>
> **currency** `string` *required*
>
> Valutacode volgens ISO 4217 van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling
> zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

**type** `string` *required*

`order` plaatst één order: een perpetual order handelt vanuit het handelssaldo, een spotorder wisselt tussen USDT0 en het asset in de wallet. `deposit` brengt USDT0 over van de wallet naar het handelssaldo. `withdraw` stuurt USDC van het handelssaldo terug naar de wallet. `close` sluit de volledige positie in één markt met een reduce-only marktorder; als het account daarna geen posities meer heeft, stuurt een `withdraw`-trade het handelssaldo terug naar de wallet.

Beschikbare opties: `close`, `order`, `deposit`, `withdraw`

**updated\_at** `string` *required*

Wanneer de trade voor het laatst is gewijzigd, als ISO 8601-tijdstempel.

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

De gebruiker die eigenaar is van de trading-wallet, met prefix `user_`. `null`
als een account de eigenaar is.

```json Trade theme={null}
{
	"id": "tint_xxxxxxxxxxxxx",
	"object": "trade",
	"type": "order",
	"status": "completed",
	"status_detail": null,
	"step": null,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"user_id": null,
	"instrument_type": "perpetual",
	"market": "BTC",
	"side": "buy",
	"order_type": "market",
	"size": "0.00166",
	"price": {
		"currency": "usd",
		"amount": "60600.000000",
		"decimals": 6,
		"display_decimals": 6
	},
	"trigger_price": null,
	"reduce_only": false,
	"leverage": 5,
	"amount": null,
	"parent_id": null,
	"filled_size": "0.00166",
	"average_price": "60012.0",
	"funds_location": null,
	"failure_code": null,
	"client_order_id": "my-btc-entry-1",
	"external_order_id": "0x63cabad10f072c65ad84526e0c33081b",
	"metadata": {},
	"created_at": "2026-09-23T15:04:05.000Z",
	"updated_at": "2026-09-23T15:04:09.812Z",
	"completed_at": "2026-09-23T15:04:09.812Z"
}
```
