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

> En Trade er én anmodning på en kontos eller brugers Whop-administrerede wallet.

En `order` på en perpetual handler fra handelssaldoen og bridger først den USDT0, den har brug for, fra wallet'en, når saldoen ikke rækker; en `order` på spot bytter mellem USDT0 og aktivet i wallet'en. En `close` lukker hele positionen i ét marked; når kontoen derefter er flad, sender en `withdraw`-trade handelssaldoen tilbage til wallet'en. En `deposit` eller `withdraw` flytter penge mellem wallet'en og handelssaldoen. Perpetuals handles på Hyperliquid.

Brug Trades API'et til at vise de markeder, du kan handle på, afgive ordrer, lukke positioner og flytte midler samt følge hver trade, indtil den er færdig. Trades kører i baggrunden; en ordre, der bridgede penge ind og ikke bliver udfyldt, sender pengene tilbage til wallet'en, og `funds_location` angiver, hvor pengene er.

Handels-API'et, inklusive `include_trading` på konti og brugere, er i beta. Det kan ændres uden en ny API-versionsdato.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Trades](https://docs.whop.com/da/api-reference/trades/list-trades.md) | GET `/trades` |
| [Hent Trade](https://docs.whop.com/da/api-reference/trades/retrieve-trade.md) | GET `/trades/{id}` |
| [Vis candles](https://docs.whop.com/da/api-reference/trades/list-candles.md) | GET `/trades/candles` |
| [Vis markeder](https://docs.whop.com/da/api-reference/trades/list-markets.md) | GET `/trades/markets` |
| [Opret Trade](https://docs.whop.com/da/api-reference/trades/create-trade.md) | POST `/trades` |
| [Annullér Trade](https://docs.whop.com/da/api-reference/trades/cancel-trade.md) | POST `/trades/{id}/cancel` |

## Markeder

[Vis markeder](https://docs.whop.com/da/api-reference/trades/list-markets.md) returnerer alle markeder, du kan handle på Whop.

* **Spot:** angivet efter symbol: `BTC`, `SOL` og `XAUT` (guld).
* **Perpetuals:** f.eks. `BTC` samt aktie- og råvare-perpetuals fra Hyperliquids `xyz`-børs, f.eks. `xyz:TSLA`. Send `id` som `market`, når du opretter en trade.

Det samme symbol kan optræde to gange, én gang som perpetual og én gang som spot, så brug `id` sammen med `instrument_type` til at skelne dem. Resultaterne sorteres efter `id` og derefter `instrument_type`.

Dette endpoint er offentligt: der kræves ingen API-nøgle, og hver IP-adresse kan foretage op til 60 anmodninger i minuttet.

En perpetual-ordres `size` kan højst have `size_decimals` decimaler, og dens `leverage` kan højst være `max_leverage`, som er `null` for et spotmarked.

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

Markedslisten er i beta ligesom resten af handels-API'et og kan ændres uden en ny API-versionsdato.

## Attributter

**id** `string` *required*

Trade-id med præfikset `tint_`.

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

Den konto, der ejer handels-wallet'en, med præfikset `biz_`. `null`, når en bruger
ejer den.

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

Den USDT0, som en deposit, et spotkøb eller en perpetual-ordre med utilstrækkelig handelssaldo
sender fra wallet'en, eller den USDC, som en withdraw sender tilbage, i
native enheder som en decimalstreng. En withdraw af `all` viser, hvad den sendte, når
den er færdig. Ellers `null`.

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

Ordrens gennemsnitlige udfyldelsespris i USD som en decimalstreng. For spot er det
den pris, swappet blev noteret til. `null`, når den ikke er kendt.

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

Kalderens eget id for traden, unikt for kontoen. `null`, når der ikke
blev sendt noget.

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

Hvornår traden endte som gennemført eller mislykket, som et ISO 8601-tidsstempel. `null`
før da.

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

Hvornår traden blev oprettet, som et ISO 8601-tidsstempel.

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

Id, som Whop sender til børsen med denne trades ordre, så børsens ordreopdateringer
kan matches med traden. På Hyperliquid er det ordrens `cloid`,
rapporteret i `orderUpdates`, en hexstreng på 32 tegn med præfikset `0x`. Ikke
kalderens `client_order_id`. `null` for en deposit eller withdraw.

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

Hvorfor traden mislykkedes, eller `null`.

Tilgængelige muligheder: `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*

Den størrelse, ordren blev udfyldt med, i markedets enheder som en decimalstreng. For et
spotkøb er det det beløb, swappet blev noteret til at levere. `null`, indtil den udfyldes.

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

Hvor pengene er, når traden ikke blev gennemført som ønsket: `wallet`, `trading_account` eller `unknown`, mens en person tjekker det. Ellers `null`.

Tilgængelige muligheder: `wallet`, `trading_account`, `unknown`

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

`perpetual` eller `spot` for en ordre, `perpetual` for en close. `null` for en deposit eller withdraw.

Tilgængelige muligheder: `perpetual`, `spot`

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

Den cross-gearing, der er sat før en åbnende perpetual-ordre. `null` for en spotordre,
close, deposit, withdraw eller reduce-only-ordre.

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

Markedet, for eksempel `BTC` for en perpetual eller `XAUT` for spot. `null` for en
deposit eller withdraw.

**metadata** `object` *required*

Frie streng-til-streng-annotationer gemt på traden.

**object** `string` *required*

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

`market`, `limit`, `take_profit` eller `stop_loss` for en ordre. Ellers `null`.

Tilgængelige muligheder: `market`, `limit`, `take_profit`, `stop_loss`

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

For en take-profit eller stop-loss sendt med en ordre: den ordres trade,
med præfikset `tint_`. Ellers `null`.

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

Ordrens limitpris i USD. En markedsordres pris er midterprisen flyttet med `slippage_bps`; en take-profits eller stop-loss' pris er den dårligste pris, dens markedsordre må udfyldes til, når den er udløst. `null` for andre typer.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

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

Om ordren kun kan reducere en position. `null` for andre typer.

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

`buy` eller `sell` for en ordre. Ellers `null`.

Tilgængelige muligheder: `buy`, `sell`

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

Ordrestørrelsen i markedets enheder som en decimalstreng. `null` for andre
typer.

**status** `string` *required*

`pending`, indtil traden starter. `processing`, mens den kører, også mens en ordre, der ikke blev udfyldt, sender de penge, den bridgede ind, tilbage til wallet'en. `completed`, når den gjorde det, der blev bedt om. `failed`, når den ikke gjorde; `funds_location` angiver, hvor pengene er. `in_review`, når resultatet er ukendt, og en person tjekker det.

Tilgængelige muligheder: `pending`, `processing`, `in_review`, `completed`, `failed`

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

`partial_fill`, når ordren kun blev udfyldt for en del af sin størrelse. Ellers `null`.

Tilgængelige muligheder: `partial_fill`

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

Hvad en aktiv trade gør lige nu: `depositing`, mens wallet'ens USDT0 sendes til bridgen, `landing`, når den er sendt og indtil den når handelssaldoen, `placing`, mens ordren eller close er hos handelsstedet, `withdrawing`, mens USDC er på vej tilbage til wallet'en, `returning`, mens penge, som en ikke-udfyldt ordre bridgede ind, går tilbage. En spotordre er `quoting`, mens swappet prissættes, `swapping`, mens det kører onchain, og `crediting`, indtil den nye saldo vises i wallet'en. `null`, når traden ikke længere er pending eller processing.

Tilgængelige muligheder: `depositing`, `landing`, `placing`, `withdrawing`, `returning`, `quoting`, `swapping`, `crediting`

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

Den pris i USD, hvor en take-profit eller stop-loss sender sin markedsordre. `null` for andre ordrer og typer.

> [accordion] Egenskaber
>
> **amount** `string` *required*
>
> Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er `"10.00"` ti dollars. Det er en streng, så ingen float afrunder det undervejs.
>
> **currency** `string` *required*
>
> Trebogstavs ISO 4217-valutakode med små bogstaver.
>
> **decimals** `integer` *required*
>
> Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
>
> **display\_decimals** `integer` *required*
>
> Hvor mange decimaler der skal VISES. Normalt lig med `decimals`, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er `2` og `0`. Formatér tallet i din egen lokalitet ved hjælp af dette.

**type** `string` *required*

`order` afgiver én ordre: en perpetual-ordre handler fra handelssaldoen, en spotordre bytter mellem USDT0 og aktivet i wallet'en. `deposit` bridger USDT0 fra wallet'en til handelssaldoen. `withdraw` sender USDC fra handelssaldoen tilbage til wallet'en. `close` lukker hele positionen i ét marked med en reduce-only-markedsordre; når kontoen derefter er flad, sender en `withdraw`-trade handelssaldoen tilbage til wallet'en.

Tilgængelige muligheder: `close`, `order`, `deposit`, `withdraw`

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

Hvornår traden sidst blev ændret, som et ISO 8601-tidsstempel.

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

Den bruger, der ejer handels-wallet'en, med præfikset `user_`. `null`, når en konto
ejer den.

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


## Related topics

- [Create Trade](https://docs.whop.com/da/api-reference/trades/create-trade.md)
- [Cancel Trade](https://docs.whop.com/da/api-reference/trades/cancel-trade.md)
- [List Trades](https://docs.whop.com/da/api-reference/trades/list-trades.md)
