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

# Users API

> Een User vertegenwoordigt een persoon op Whop. Users hebben een openbaar profiel en kunnen producten kopen, lid worden van accounts en experiences openen.

Gebruik de Users API om gebruikers te zoeken, profielen op te halen of bij te werken en te controleren of een gebruiker toegang heeft tot een account, product of experience.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Users opvragen](https://docs.whop.com/nl/api-reference/users/list-users.md) | GET `/users` |
| [User ophalen](https://docs.whop.com/nl/api-reference/users/retrieve-user.md) | GET `/users/{id}` |
| [Gebruikerstoegang controleren](https://docs.whop.com/nl/api-reference/users/check-user-access.md) | GET `/users/{id}/access/{resource_id}` |
| [Gebruikerskosten ophalen](https://docs.whop.com/nl/api-reference/users/retrieve-user-fees.md) | GET `/users/{user_id}/fees` |
| [Aanbevolen acties opvragen](https://docs.whop.com/nl/api-reference/users/list-recommended-actions.md) | GET `/users/{id}/recommend_actions` |
| [OAuth Grants opvragen](https://docs.whop.com/nl/api-reference/users/list-oauth-grants.md) | GET `/users/me/oauth_grants` |
| [Opvragen](https://docs.whop.com/nl/api-reference/users/list.md) | GET `/users/me/passkeys` |
| [Ophalen](https://docs.whop.com/nl/api-reference/users/retrieve.md) | GET `/users/me/preferences` |
| [Experiences opvragen](https://docs.whop.com/nl/api-reference/users/list-experiences.md) | GET `/users/me/preferences/notifications/experiences` |
| [Topics opvragen](https://docs.whop.com/nl/api-reference/users/list-topics.md) | GET `/users/me/preferences/notifications/topics` |
| [Een app autoriseren](https://docs.whop.com/nl/api-reference/users/authorize-an-app.md) | POST `/users/me/oauth_grants` |
| [Registreren](https://docs.whop.com/nl/api-reference/users/register.md) | POST `/users/me/passkeys` |
| [Challenge aanmaken](https://docs.whop.com/nl/api-reference/users/create-challenge.md) | POST `/users/me/passkeys/challenge` |
| [User bijwerken](https://docs.whop.com/nl/api-reference/users/update-user.md) | PATCH `/users/{id}` |
| [Bijwerken](https://docs.whop.com/nl/api-reference/users/update.md) | PATCH `/users/me/preferences` |
| [Instellen](https://docs.whop.com/nl/api-reference/users/set.md) | PATCH `/users/me/preferences/notifications` |
| [Verwijderen](https://docs.whop.com/nl/api-reference/users/delete.md) | DELETE `/users/me/passkeys/{id}` |

## Attributen

**id** `string` *required*

Gebruikers-ID, met prefix `user_`.

**balance** `object | null` *required*

Het saldo van de gebruiker: persoonlijk contant geld + andere bezittingen + stortingen die nog onderweg zijn, plus accountsaldi voor accounts die de gebruiker bezit. Alleen berekend in de eigen weergave (opgehaald met de gereserveerde id `me`) voor aanroepers met balance-read-scope; anders `null`, of wanneer `include_balance=false`.

> [accordion] Eigenschappen
>
> **businesses** `object[]` *required*
>
> Accountsaldi voor accounts die de gebruiker bezit, hoogste saldo eerst. Accounts zonder saldo worden uitgesloten.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > De account-ID, die eruitziet als biz\_\*\*\*\*\*\*\*\*\*\*\*\*\*.
> >
> > **balance\_usd** `string` *required*
> >
> > Het totale saldo van het account in USD.
> >
> > **logo\_url** `string | null` *required*
> >
> > De logo-URL van het account.
> >
> > **name** `string | null` *required*
> >
> > De weergavenaam van het account.
>
> **businesses\_total\_usd** `string` *required*
>
> Gecombineerd USD-saldo over alle accounts die de gebruiker bezit.
>
> **cash** `object[]` *required*
>
> Fiat-contantsaldi per valuta.
>
> > [accordion] Eigenschappen
> >
> > **balance** `number` *required*
> >
> > Beschikbaar saldo in de oorspronkelijke valuta.
> >
> > **balance\_usd** `number` *required*
> >
> > Beschikbaar saldo omgerekend naar USD.
> >
> > **currency** `string` *required*
> >
> > ISO-valutacode in kleine letters, zoals `usd` of `eur`.
> >
> > **in\_transit\_balance\_usd** `number` *required*
> >
> > Saldo dat onderweg is naar de eigen wallet of kaart van de gebruiker, omgerekend naar USD.
> >
> > **pending\_balance\_usd** `number` *required*
> >
> > Openstaand saldo omgerekend naar USD.
> >
> > **price\_usd** `number | null` *required*
> >
> > USD-prijs per eenheid van de oorspronkelijke valuta, of `null` wanneer er geen wisselkoers beschikbaar is.
> >
> > **reserve\_balance\_usd** `number` *required*
> >
> > Gereserveerd saldo omgerekend naar USD.
> >
> > **total\_withdrawable\_balance** `number` *required*
> >
> > Opneembaar bedrag in de oorspronkelijke valuta.
>
> **cash\_usd** `string` *required*
>
> Fiat-contanten in USD, inclusief openstaand, onderweg en reserve.
>
> **crypto** `object[]` *required*
>
> Crypto-bezittingen per token in de eigen wallet van het grootboek.
>
> > [accordion] Eigenschappen
> >
> > **balance** `string` *required*
> >
> > Aangehouden bedrag in oorspronkelijke tokeneenheden, als decimale string.
> >
> > **breakdown** `object` *required*
> >
> > Saldo opgesplitst in beschikbare, openstaande, onderweg zijnde en gereserveerde bedragen, als decimale strings in oorspronkelijke eenheden. Overboekingen tussen de eigen wallet en kaart van de gebruiker worden in `in_transit` gerapporteerd totdat ze aankomen.
> >
> > > [accordion] Eigenschappen
> > >
> > > **available** `string` *required*
> > >
> > > Bedrag dat je nu kunt uitgeven, verzenden of opnemen, in oorspronkelijke eenheden, als decimale string.
> > >
> > > **finishing\_settlement** `string` *required*
> > >
> > > Het deel van `pending` dat al is afgewikkeld en wacht om naar de crypto-wallet of Whop Card van het account te worden verplaatst, waar het `available` wordt. De verplaatsing start meestal binnen een uur; terwijl die loopt, wordt het bedrag in plaats daarvan in `in_transit` gerapporteerd. Geld dat alleen wordt verplaatst om het aangehouden minimumsaldo van het account aan te vullen, is niet inbegrepen. In oorspronkelijke eenheden, als decimale string.
> > >
> > > **in\_transit** `string` *required*
> > >
> > > Bedrag dat tussen de eigen bestemmingen van het account wordt verplaatst, zoals een kaartopwaardering. In oorspronkelijke eenheden, als decimale string.
> > >
> > > **pending** `string` *required*
> > >
> > > Bedrag van recente betalingen dat nog wordt afgewikkeld, in oorspronkelijke eenheden, als decimale string.
> > >
> > > **pending\_settlements** `object[]` *required*
> > >
> > > Wanneer het openstaande bedrag naar verwachting wordt afgewikkeld, één item per dag, vroegste eerst. Geld zonder geplande afwikkelingsdag, inclusief `finishing_settlement`, wordt weggelaten, dus deze items plus `finishing_settlement` kunnen samen minder zijn dan `pending`, maar nooit meer.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Verwacht bedrag op die dag, in oorspronkelijke eenheden, als decimale string.
> > > >
> > > > **date** `string` *required*
> > > >
> > > > De dag waarop dit geld naar verwachting volledig is afgewikkeld, als ISO 8601-datum.
> > >
> > > **reserve** `string` *required*
> > >
> > > Ingehouden bedrag, in oorspronkelijke eenheden, als decimale string. Haal de reserves van het account op om te zien waarom het wordt ingehouden en wanneer het vrijkomt.
> >
> > **icon\_url** `string | null` *required*
> >
> > Icoon-URL van de token.
> >
> > **name** `string | null` *required*
> >
> > De weergavenaam van de token.
> >
> > **price\_usd** `number | null` *required*
> >
> > USD-prijs per token, of `null` wanneer onbekend.
> >
> > **symbol** `string` *required*
> >
> > Weergavesymbool van de token, zoals `USDT`, `XAUT` of `cbBTC`.
> >
> > **value\_usd** `number` *required*
> >
> > USD-waarde van het bezit.
>
> **crypto\_usd** `string` *required*
>
> Crypto-bezittingen in USD.
>
> **pending\_usd** `string` *required*
>
> Openstaande en onderweg zijnde fiatsaldi, plus treasury-stortingen die nog onderweg zijn, in USD.
>
> **total\_usd** `string` *required*
>
> Het persoonlijke saldo van de gebruiker in USD: contanten (beschikbaar + openstaand + onderweg + reserve) + andere bezittingen + stortingen die nog onderweg zijn. Exclusief accountsaldi (zie businesses\_total\_usd).
>
> **treasury\_pending\_usd** `string` *required*
>
> Saldoverplaatsingen naar de wallet van de gebruiker die nog onderweg zijn, in USD.

**balance\_history** `object | null` *required*

Het cumulatieve walletsaldo van de gebruiker in de loop van de tijd (USD-punten `\{ t, v }` plus last/min/max), voor de saldografiek. Schakel dit in met `include_balance_history=true` wanneer je jezelf ophaalt met de gereserveerde id `me`; alleen gevuld voor aanroepers met balance-read-scope en anders `null`. Een gebruiker zonder walletactiviteit retourneert een lege reeks.

> [accordion] Eigenschappen
>
> **data** `object[]` *required*
>
> Cumulatieve saldopunten over het gevraagde venster, oudste eerst.
>
> > [accordion] Eigenschappen
> >
> > **t** `integer` *required*
> >
> > Tijdstempel van het punt, in Unix-seconden.
> >
> > **v** `number` *required*
> >
> > Cumulatief walletsaldo op dit punt, in USD.
>
> **last** `number` *required*
>
> Waarde van het meest recente punt, in USD.
>
> **max** `number` *required*
>
> Maximumwaarde over het venster, in USD.
>
> **min** `number` *required*
>
> Minimumwaarde over het venster, in USD.

**balances** `object[]` *required*

De persoonlijke bezittingen van de gebruiker, elk met hun USD-waarde en uitsplitsing, in dezelfde vorm als de `balances` van een account. Leeg wanneer `total_usd` `null` is.

> [accordion] Eigenschappen
>
> **balance** `string` *required*
>
> Totaal aangehouden bedrag in oorspronkelijke eenheden, als decimale string.
>
> **breakdown** `object` *required*
>
> Saldo opgesplitst in beschikbare, openstaande en gereserveerde bedragen, als decimale strings in oorspronkelijke eenheden, met de dagen waarop het openstaande bedrag naar verwachting wordt afgewikkeld.
>
> > [accordion] Eigenschappen
> >
> > **available** `string` *required*
> >
> > Bedrag dat je nu kunt uitgeven, verzenden of opnemen, in oorspronkelijke eenheden, als decimale string.
> >
> > **finishing\_settlement** `string` *required*
> >
> > Het deel van `pending` dat al is afgewikkeld en wacht om naar de crypto-wallet of Whop Card van het account te worden verplaatst, waar het `available` wordt. De verplaatsing start meestal binnen een uur; terwijl die loopt, wordt het bedrag in plaats daarvan in `in_transit` gerapporteerd. Geld dat alleen wordt verplaatst om het aangehouden minimumsaldo van het account aan te vullen, is niet inbegrepen. In oorspronkelijke eenheden, als decimale string.
> >
> > **in\_transit** `string` *required*
> >
> > Bedrag dat tussen de eigen bestemmingen van het account wordt verplaatst, zoals een kaartopwaardering. In oorspronkelijke eenheden, als decimale string.
> >
> > **pending** `string` *required*
> >
> > Bedrag van recente betalingen dat nog wordt afgewikkeld, in oorspronkelijke eenheden, als decimale string.
> >
> > **pending\_settlements** `object[]` *required*
> >
> > Wanneer het openstaande bedrag naar verwachting wordt afgewikkeld, één item per dag, vroegste eerst. Geld zonder geplande afwikkelingsdag, inclusief `finishing_settlement`, wordt weggelaten, dus deze items plus `finishing_settlement` kunnen samen minder zijn dan `pending`, maar nooit meer.
> >
> > > [accordion] Eigenschappen
> > >
> > > **amount** `string` *required*
> > >
> > > Verwacht bedrag op die dag, in oorspronkelijke eenheden, als decimale string.
> > >
> > > **date** `string` *required*
> > >
> > > De dag waarop dit geld naar verwachting volledig is afgewikkeld, als ISO 8601-datum.
> >
> > **reserve** `string` *required*
> >
> > Ingehouden bedrag, in oorspronkelijke eenheden, als decimale string. Haal de reserves van het account op om te zien waarom het wordt ingehouden en wanneer het vrijkomt.
>
> **icon\_url** `string | null` *required*
>
> Icoon-URL van het bezit.
>
> **name** `string` *required*
>
> De weergavenaam van het bezit
>
> **price\_usd** `number | null` *required*
>
> USD-prijs per eenheid, of `null` wanneer er geen wisselkoers beschikbaar is.
>
> **symbol** `string` *required*
>
> Weergavesymbool van het bezit, zoals `USDT`, `cbBTC` of `EUR`.
>
> **value\_usd** `string | null` *required*
>
> USD-waarde van het bezit, of `null` wanneer er geen wisselkoers beschikbaar is.

**banner** `object | null` *required*

De wrapper voor de profielbanner van de gebruiker. `null` wanneer de gebruiker geen banner heeft.

> [accordion] Eigenschappen
>
> **url** `string` *required*
>
> URL van de profielbannerafbeelding.

**bio** `string | null` *required*

De biografie van de gebruiker

**cards** `object | null` *required*

De status van de persoonlijke kaartaanvraag van de gebruiker. Alleen gevuld in de eigen weergave (opgehaald met de gereserveerde id `me`) voor aanroepers met balance-read-scope; anders `null`, of wanneer de gebruiker nooit een kaart heeft aangevraagd.

> [accordion] Eigenschappen
>
> **decline\_reason** `string | null` *required*
>
> Reden waarom de kaartuitgever de aanvraag heeft afgewezen. `unsupported_state` vervangt `unsupported_region` voor een geverifieerde persoon of onderneming in de Verenigde Staten. `compliance` omvat controles op sancties, politiek prominente personen en negatieve berichtgeving. `other` omvat redenen die niet in deze lijst staan. `null` wanneer `status` niet `denied` is, of wanneer de uitgever de aanvraag niet heeft afgewezen.
>
> Beschikbare opties: `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> Of de kaartaanvraag een onderneming (`business`, KYB) of een persoon (`individual`, consumentidentiteit) verifieert. `null` wanneer de aanvraag nog niet aan een verificatie is gekoppeld.
>
> Beschikbare opties: `individual`, `business`
>
> **status** `string` *required*
>
> De status van de kaartaanvraag. `approved` betekent dat er kaarten kunnen worden uitgegeven. `needs_verification` betekent dat de aanvrager de identiteitsverificatie nog niet heeft voltooid; `needs_information` betekent dat dit wel is gebeurd, maar dat de documenten om een herstelbare reden zijn afgewezen en opnieuw moeten worden ingediend. `pending` en `manual_review` zijn in behandeling. `denied`, `locked` en `canceled` zijn definitief.
>
> Beschikbare opties: `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

**city** `string | null` *required*

De stad van de gebruiker, afgeleid van het IP-adres. `null` wanneer onbekend of wanneer de gebruiker het delen van de locatie heeft uitgeschakeld.

**country** `string | null` *required*

Het land van de gebruiker als ISO 3166-1 alpha-2-code, afgeleid van het IP-adres. `null` wanneer onbekend of wanneer de gebruiker het delen van de locatie heeft uitgeschakeld.

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

Wanneer de gebruiker is aangemaakt, als ISO 8601-tijdstempel

**date\_of\_birth** `string | null` *required*

De geboortedatum van de gebruiker als ISO 8601-datum, zoals `1998-04-23`. Alleen gevuld in de eigen weergave (opgehaald met de gereserveerde id `me`) voor aanroepers met email-read-scope; anders `null`, of wanneer de gebruiker er geen heeft ingesteld.

**earnings\_usd** `object | null` *required*

Het bruto USD-inkomen van de gebruiker in de loop van de tijd, inclusief een uitsplitsing van Partner-commissies. Alleen gevuld bij het lezen van één gebruiker in de eigen weergave voor aanroepers met balance-read-scope; anders `null`.

> [accordion] Eigenschappen
>
> **first\_earned\_at** `string | null` *required*
>
> Het eerste moment waarop de gebruiker bruto-inkomen verdiende, als ISO 8601-tijdstempel.
>
> **owned\_accounts** `object` *required*
>
> Bruto-inkomen uit accounts die de gebruiker bezit of waarvoor de gebruiker als eigenaar gemachtigd is.
>
> > [accordion] Eigenschappen
> >
> > **last\_24\_hours** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 24 uur.
> >
> > **last\_30\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 30 dagen.
> >
> > **last\_7\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 7 dagen.
> >
> > **lifetime** `string` *required*
> >
> > Totaal bruto-inkomen aller tijden in USD.
>
> **partners** `object` *required*
>
> Partner-commissies die op de wallet van de gebruiker zijn geboekt. Openstaande Partner-uitbetalingen worden uitgesloten totdat ze zijn geboekt; latere terugboekingen verlagen het bruto-inkomen niet.
>
> > [accordion] Eigenschappen
> >
> > **last\_24\_hours** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 24 uur.
> >
> > **last\_30\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 30 dagen.
> >
> > **last\_7\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 7 dagen.
> >
> > **lifetime** `string` *required*
> >
> > Totaal bruto-inkomen aller tijden in USD.
>
> **personal** `object` *required*
>
> Bruto-inkomen uit de persoonlijke wallet van de gebruiker.
>
> > [accordion] Eigenschappen
> >
> > **last\_24\_hours** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 24 uur.
> >
> > **last\_30\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 30 dagen.
> >
> > **last\_7\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 7 dagen.
> >
> > **lifetime** `string` *required*
> >
> > Totaal bruto-inkomen aller tijden in USD.
>
> **total** `object` *required*
>
> Bruto-inkomen uit de persoonlijke wallet van de gebruiker plus accounts die de gebruiker bezit of waarvoor de gebruiker als eigenaar gemachtigd is.
>
> > [accordion] Eigenschappen
> >
> > **last\_24\_hours** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 24 uur.
> >
> > **last\_30\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 30 dagen.
> >
> > **last\_7\_days** `string` *required*
> >
> > Bruto-inkomen in USD over de afgelopen 7 dagen.
> >
> > **lifetime** `string` *required*
> >
> > Totaal bruto-inkomen aller tijden in USD.

**email** `string | null` *required*

Het e-mailadres van de gebruiker. Alleen gevuld in de eigen weergave (opgehaald met de gereserveerde id `me`) voor aanroepers met email-read-scope; anders `null`, of zolang het account nog geen bevestigd e-mailadres heeft.

**followers\_count** `integer` *required*

Het aantal gebruikers dat deze gebruiker volgt.

**level** `object | null` *required*

Het Whop Level van de gebruiker, geteld over alle accounts die de gebruiker bezit. `current` is openbaar. De velden voor punten en uitgaven worden alleen gevuld wanneer je jezelf ophaalt met de gereserveerde id `me` en balance-read-scope hebt. `null` in lijsten, en wanneer geen van de accounts van de gebruiker in Whop Levels zit.

> [accordion] Eigenschappen
>
> **current** `integer` *required*
>
> Het geldende level: het hoogste dat de gebruiker deze maand of in de 5 maanden daarvoor heeft bereikt, van `0` tot `10`. Openbaar.
>
> **points** `integer | null` *required*
>
> Punten die deze maand zijn verdiend over alle accounts die de gebruiker bezit, plus de partnerpunten, naar beneden afgerond. Een account waarvan de maand netto onder nul uitkomt, telt als nul. `null` tenzij je jezelf ophaalt met de gereserveerde id `me` en balance-read-scope hebt.
>
> **points\_by\_source** `object | null` *required*
>
> De punten van deze maand, uitgesplitst naar waar ze zijn verdiend. Elke bron is netto na terugbetalingen, dus een bron kan negatief zijn. `null` tenzij je jezelf ophaalt met de gereserveerde id `me` en balance-read-scope hebt.
>
> > [accordion] Eigenschappen
> >
> > **ads** `integer` *required*
> >
> > Punten uit betaalde Whop Ads-kosten, netto na terugbetalingen: 10 per dollar, afgerond richting nul.
> >
> > **cards** `integer` *required*
> >
> > Punten uit vastgelegde Whop Card-uitgaven, netto na terugbetalingen: 10 per dollar, afgerond richting nul.
> >
> > **partners** `integer` *required*
> >
> > Punten uit accounts die de eigenaar als partner heeft doorverwezen: 1 voor elke 3 die zij verdienen, afgerond richting nul.
> >
> > **trading** `integer` *required*
> >
> > Punten uit perpetual-handelsvolume dat via Whop is uitgevoerd: 1 per verhandelde dollar, afgerond richting nul.
>
> **resets\_at** `string | null` *required*
>
> Wanneer de punten van deze maand naar nul worden gereset, als ISO 8601-tijdstempel. `null` tenzij je jezelf ophaalt met de gereserveerde id `me` en balance-read-scope hebt.

**name** `string | null` *required*

De weergavenaam van de gebruiker

**profile\_picture** `object` *required*

Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.

> [accordion] Eigenschappen
>
> **url** `string` *required*
>
> URL van de avatarafbeelding. Altijd aanwezig. Dit is een gegenereerde placeholder wanneer de gebruiker geen afbeelding heeft ingesteld.

**social\_links** `object[]` *required*

De sociale accounts en websites op het openbare profiel van de gebruiker. Leeg wanneer de gebruiker er geen heeft.

> [accordion] Eigenschappen
>
> **url** `string` *required*
>
> De URL van de link.
>
> **username** `string | null` *required*
>
> De handle van de gebruiker op het platform, zoals ingevoerd of zoals gerapporteerd door het gekoppelde account. `null` voor links zonder handle, zoals een persoonlijke site.
>
> **verified** `boolean` *required*
>
> Of Whop heeft geverifieerd dat de gebruiker eigenaar is van het account.
>
> **website** `string` *required*
>
> Het platform waarnaar de link verwijst. `website` is een persoonlijke site in plaats van een sociaal platform.
>
> Beschikbare opties: `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`

**state** `string | null` *required*

De staat of regio van de gebruiker, afgeleid van het IP-adres. `null` wanneer onbekend of wanneer de gebruiker het delen van de locatie heeft uitgeschakeld.

**total\_usd** `string | null` *required*

Totale USD-waarde van de persoonlijke bezittingen van de gebruiker in `balances`, over de bezittingen met bekende wisselkoersen. Alleen berekend in de eigen weergave (opgehaald met de gereserveerde id `me`) voor aanroepers met balance-read-scope; anders `null`, wanneer `include_balance=false`, of wanneer de saldobron niet beschikbaar is.

**trading** `trading_account | null` *required*

Het adres van het handelsaccount, een momentopname van de marge en open posities, en de WebSocket-abonnementen. Schakel dit in met `include_trading=true` wanneer je `me` ophaalt. Anders `null`, zonder handelsrechten, of zonder Ethereum-wallet.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De Whop-wallet-ID achter dit handelsaccount, met prefix `cwal_`.
>
> **account\_id** `string | null` *required*
>
> Het account dat eigenaar is van dit handelsaccount, met prefix `biz_`. `null` wanneer een gebruiker eigenaar is.
>
> **hyperliquid** `object | null` *required*
>
> Hyperliquid-specifieke status. Aanwezig wanneer `provider` `hyperliquid` is, anders `null`.
>
> > [accordion] Eigenschappen
> >
> > **address** `string` *required*
> >
> > Walletadres in kleine letters dat het Hyperliquid-account aanhoudt.
> >
> > **depositable** `string | null` *required*
> >
> > USDT0 in de Whop-wallet op Plasma die een `deposit`-trade naar dit account kan verplaatsen, als decimale string. `null` wanneer de chain niet kon worden gelezen.
> >
> > **margin\_summary** `object | null` *required*
> >
> > Accountwaarde en marge over de hoofdbeurs en de `xyz`-markten, hoogstens eens per seconde gelezen van Hyperliquid. `null` wanneer Hyperliquid niet kon worden gelezen. Gebruik `websocket_subscriptions` voor live-updates.
> >
> > > [accordion] Eigenschappen
> > >
> > > **account\_value** `object` *required*
> > >
> > > Totale accountwaarde in USD, inclusief niet-gerealiseerde winst en verlies.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > Marge toegewezen over open posities, in USD.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > Gecombineerde nominale waarde van open posities, in USD.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > USD die nu kan worden opgenomen zonder posities te sluiten.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > Open perpetual-posities over de hoofdbeurs en de `xyz`-markten, hoogstens eens per seconde gelezen van Hyperliquid. `null` wanneer Hyperliquid niet kon worden gelezen. Gebruik `websocket_subscriptions` voor live-updates.
> >
> > > [accordion] Eigenschappen
> > >
> > > **id** `string` *required*
> > >
> > > Handelspositie-ID, met prefix `trdpos_`. Stabiel voor een markt binnen één handelsaccount.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > Gemiddelde instapprijs in USD, of `null` wanneer de provider deze weglaat.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Details van de Hyperliquid-perpetual. Aanwezig bij Hyperliquid-posities, anders `null`.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > Funding die over verschillende vensters op de positie is betaald, in USD.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > Funding die over de volledige geschiedenis van het account op deze markt is betaald, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [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*
> > > > > >
> > > > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > Funding die is betaald sinds de positiegrootte voor het laatst is gewijzigd, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [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*
> > > > > >
> > > > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > Funding die is betaald sinds de positie is geopend, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [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*
> > > > > >
> > > > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > Margemodus en multiplier voor de positie.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross` deelt marge over posities. `isolated` beperkt de marge tot deze positie.
> > > > >
> > > > > Beschikbare opties: `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > Multiplier toegepast op de marge van de positie, zoals `10` voor 10x.
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > Geschatte liquidatieprijs in USD, of `null` wanneer Hyperliquid er geen rapporteert.
> > > >
> > > > > [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*
> > > > >
> > > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > Marge toegewezen aan de positie, in USD.
> > > >
> > > > > [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*
> > > > >
> > > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > Rendement op eigen vermogen als decimale ratio-string, zoals `0.1` voor 10%.
> > >
> > > **market** `string` *required*
> > >
> > > Marktsymbool bij de provider, zoals `ETH`.
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > Huidige positiewaarde in USD.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **side** `string` *required*
> > >
> > > Beschikbare opties: `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > Absolute positiegrootte als decimale string.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > Niet-gerealiseerde winst of verlies in USD. Negatief bij verlies.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > Abonnementen voor live accountupdates. Verstuur elke `message` ongewijzigd nadat je verbinding hebt gemaakt met `websocket_url`.
> >
> > > [accordion] Eigenschappen
> > >
> > > **channel** `string` *required*
> > >
> > > De stream met live-updates die dit abonnement opent.
> > >
> > > Beschikbare opties: `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > JSON-abonnementsbericht dat ongewijzigd via de Hyperliquid-WebSocket moet worden verstuurd.
> >
> > **websocket\_url** `string` *required*
> >
> > Hyperliquid-WebSocket-URL om direct verbinding mee te maken voor live-updates.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> Handelsplatform dat de posities en orders aanhoudt.
>
> Beschikbare opties: `hyperliquid`
>
> **spot** `object | null` *required*
>
> Spotbezittingen in de Whop-wallet met hun instapprijs en winst en verlies. `null` wanneer deze niet konden worden gelezen.
>
> > [accordion] Eigenschappen
> >
> > **holdings** `object[]` *required*
> >
> > Elk spotasset dat de wallet nog aanhoudt, met de gemiddelde instapprijs en winst en verlies. De kostprijs telt de oudste eenheden als eerst verkocht en omvat assets die van buiten Whop zijn binnengekomen.
> >
> > > [accordion] Eigenschappen
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > De gemiddelde prijs die per eenheid is betaald voor wat nog wordt aangehouden, in USD, waarbij de oudste eenheden als eerst verkocht worden geteld. `null` wanneer onbekend.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > Wat er in USD is betaald voor de eenheden die nog worden aangehouden.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **market** `string` *required*
> > >
> > > De `id` van de spotmarkt uit `GET /trades/markets`, zoals `BTC`, `XAUT` of de ticker van een getokeniseerd aandeel zoals `AAPL`.
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > Winsten en verliezen die al door verkoop zijn vastgelegd, in USD.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > De waarde van de eenheden die nog worden aangehouden min hun `cost_basis`, in USD.
> > >
> > > > [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*
> > > >
> > > > Driecijferige ISO 4217-valutacode, 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 er moeten worden WEERGEGEVEN. 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.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `unrealized_pnl` als percentage van `cost_basis`, waarbij `2` een stijging van 2% betekent. `null` wanneer onbekend.
>
> **user\_id** `string | null` *required*
>
> De gebruiker die eigenaar is van dit handelsaccount, met prefix `user_`. `null` wanneer een account eigenaar is.

**username** `string` *required*

De unieke gebruikersnaam van de gebruiker

**verification** `object` *required*

Status van de identiteitsverificatie voor de `individual`- (KYC) en `business`-profielen (KYB) van de gebruiker. Elk is `null` totdat het is aangemaakt, en heeft anders een `status` van `not_started`, `pending`, `approved` of `rejected`.

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

Wanneer de gebruiker een verificatiebadge heeft ontvangen, als ISO 8601-tijdstempel. `null` wanneer de gebruiker niet geverifieerd is.

**whop\_partner\_enabled\_at** `string | null` *required*

Wanneer de gebruiker een ingeschreven Whop Partner werd, als ISO 8601-tijdstempel. `null` als de gebruiker nooit is ingeschreven.

**whop\_partner\_onboarded\_accounts\_count** `integer | null` *required*

Aantal accounts dat de gebruiker als Whop Partner naar Whop heeft doorverwezen en die meer dan \$1 aan volume hebben verwerkt dat aan de gebruiker wordt toegeschreven. Alleen gevuld bij het ophalen van één gebruiker die een Verified Whop Partner is; anders `null`.

**whop\_partner\_verified\_at** `string | null` *required*

Wanneer de gebruiker een Verified Whop Partner werd, als ISO 8601-tijdstempel. `null` voor gebruikers die geen Verified Whop Partner zijn, inclusief partners die het programma hebben verlaten en geschorste gebruikers.

```json User theme={null}
{
	"id": "user_alex123",
	"trading": {
		"id": "cwal_xxxxxxxxxxxxx",
		"object": "trading_account",
		"account_id": null,
		"user_id": "user_alex123",
		"provider": "hyperliquid",
		"hyperliquid": {
			"address": "0x1234567890abcdef1234567890abcdef12345678",
			"websocket_url": "wss://api.hyperliquid.xyz/ws",
			"websocket_subscriptions": [
				{
					"channel": "clearinghouse_state",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"clearinghouseState\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "open_orders",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"openOrders\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "order_updates",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"orderUpdates\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_fills",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userFills\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_events",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userEvents\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				}
			],
			"depositable": "1250.50",
			"margin_summary": {
				"account_value": {
					"currency": "usd",
					"amount": "1520.50",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_position_notional": {
					"currency": "usd",
					"amount": "4350.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_margin_used": {
					"currency": "usd",
					"amount": "435.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"withdrawable": {
					"currency": "usd",
					"amount": "500.00",
					"decimals": 2,
					"display_decimals": 2
				}
			},
			"positions": [
				{
					"id": "trdpos_0123456789abcdef",
					"object": "trading_position",
					"market": "ETH",
					"side": "short",
					"size": "1.5",
					"entry_price": {
						"currency": "usd",
						"amount": "3000.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"position_value": {
						"currency": "usd",
						"amount": "4350.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "150.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"hyperliquid": {
						"leverage": {
							"type": "cross",
							"value": 10
						},
						"liquidation_price": {
							"currency": "usd",
							"amount": "4912.40",
							"decimals": 2,
							"display_decimals": 2
						},
						"margin_used": {
							"currency": "usd",
							"amount": "435.00",
							"decimals": 2,
							"display_decimals": 2
						},
						"return_on_equity": "0.33",
						"cumulative_funding": {
							"all_time": {
								"currency": "usd",
								"amount": "1.20",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_open": {
								"currency": "usd",
								"amount": "0.40",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_change": {
								"currency": "usd",
								"amount": "0.10",
								"decimals": 2,
								"display_decimals": 2
							}
						}
					}
				}
			]
		},
		"spot": {
			"holdings": [
				{
					"market": "BTC",
					"average_entry_price": {
						"currency": "usd",
						"amount": "79841.12345678",
						"decimals": 8,
						"display_decimals": 8
					},
					"cost_basis": {
						"currency": "usd",
						"amount": "400.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "38.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl_percentage": 9.5625,
					"realized_pnl": {
						"currency": "usd",
						"amount": "3.25",
						"decimals": 2,
						"display_decimals": 2
					}
				}
			]
		}
	},
	"balance": {
		"businesses": [
			{
				"id": "biz_acme123",
				"name": "Acme Inc",
				"logo_url": "https://cdn.whop.com/logos/acme.png",
				"balance_usd": "14325.00"
			}
		],
		"businesses_total_usd": "14325.00",
		"cash": [
			{
				"currency": "usd",
				"balance": 250,
				"balance_usd": 250,
				"pending_balance_usd": 0,
				"in_transit_balance_usd": 0,
				"price_usd": 1,
				"reserve_balance_usd": 0,
				"total_withdrawable_balance": 250
			}
		],
		"cash_usd": "250.00",
		"crypto": [
			{
				"symbol": "USDT",
				"name": "Tether USD",
				"balance": "500.00",
				"breakdown": {
					"available": "450.00",
					"in_transit": "0",
					"pending": "50.00",
					"pending_settlements": [
						{
							"amount": "50.00",
							"date": "2026-08-12"
						}
					],
					"finishing_settlement": "0",
					"reserve": "0"
				},
				"value_usd": 500,
				"price_usd": 1,
				"icon_url": "https://cdn.whop.com/tokens/usdt.png"
			}
		],
		"crypto_usd": "500.00",
		"pending_usd": "0.00",
		"total_usd": "750.00",
		"treasury_pending_usd": "0.00"
	},
	"total_usd": "750.00",
	"balances": [
		{
			"balance": "500.00",
			"breakdown": {
				"available": "450.00",
				"in_transit": "0",
				"pending": "50.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "50.00",
						"date": "2026-08-12"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": "https://cdn.whop.com/tokens/usdt.png",
			"name": "Tether USD",
			"price_usd": 1,
			"symbol": "USDT",
			"value_usd": "500.00"
		},
		{
			"balance": "250.00",
			"breakdown": {
				"available": "240.00",
				"in_transit": "0",
				"pending": "10.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "10.00",
						"date": "2026-08-12"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": null,
			"name": "US Dollar",
			"price_usd": 1,
			"symbol": "USD",
			"value_usd": "250.00"
		}
	],
	"balance_history": {
		"data": [
			{
				"t": 1735689600,
				"v": 500
			},
			{
				"t": 1735776000,
				"v": 750
			}
		],
		"last": 750,
		"min": 500,
		"max": 750
	},
	"bio": "Building communities on Whop.",
	"banner": {
		"url": "https://cdn.whop.com/banner.png"
	},
	"created_at": "2026-06-01T12:00:00Z",
	"earnings_usd": {
		"total": {
			"lifetime": "15075.00",
			"last_30_days": "3425.00",
			"last_7_days": "890.00",
			"last_24_hours": "120.00"
		},
		"personal": {
			"lifetime": "750.00",
			"last_30_days": "250.00",
			"last_7_days": "100.00",
			"last_24_hours": "25.00"
		},
		"owned_accounts": {
			"lifetime": "14325.00",
			"last_30_days": "3175.00",
			"last_7_days": "790.00",
			"last_24_hours": "95.00"
		},
		"partners": {
			"lifetime": "600.00",
			"last_30_days": "200.00",
			"last_7_days": "80.00",
			"last_24_hours": "20.00"
		},
		"first_earned_at": "2026-06-02T15:30:00Z"
	},
	"name": "Alex Rivera",
	"profile_picture": {
		"url": "https://cdn.whop.com/avatar.png"
	},
	"social_links": [
		{
			"website": "instagram",
			"username": "janedoe",
			"url": "https://instagram.com/janedoe",
			"verified": true
		}
	],
	"username": "alex",
	"city": "Austin",
	"state": "Texas",
	"country": "US",
	"cards": {
		"kind": "individual",
		"status": "approved",
		"decline_reason": null
	},
	"level": {
		"current": 1,
		"points": 41000,
		"points_by_source": {
			"cards": 40000,
			"ads": 0,
			"trading": 1000,
			"partners": 0
		},
		"resets_at": "2026-11-01T04:00:00.000Z"
	},
	"followers_count": 1284,
	"verified_at": "2026-03-18T15:42:00Z",
	"verification": {
		"business": null,
		"individual": {
			"status": "approved"
		}
	},
	"whop_partner_enabled_at": "2026-06-10T09:00:00Z",
	"whop_partner_verified_at": "2026-07-15T18:30:00Z",
	"whop_partner_onboarded_accounts_count": 12,
	"email": "jack@whop.com",
	"date_of_birth": "1998-04-23"
}
```


## Related topics

- [Users](https://docs.whop.com/nl/api-reference/legacy/users/user.md)
- [Create API Key](https://docs.whop.com/nl/api-reference/api-keys/create-api-key.md)
- [Update User](https://docs.whop.com/nl/api-reference/users/update-user.md)
