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

> Un utilisateur représente une personne sur Whop. Les utilisateurs ont un profil public et peuvent acheter des produits, rejoindre des comptes et accéder à des expériences.

Utilisez l'API Utilisateurs pour rechercher des utilisateurs, récupérer ou mettre à jour des profils, et vérifier si un utilisateur a accès à un compte, un produit ou une expérience.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les utilisateurs](https://docs.whop.com/fr/api-reference/users/list-users.md) | GET `/users` |
| [Récupérer un utilisateur](https://docs.whop.com/fr/api-reference/users/retrieve-user.md) | GET `/users/{id}` |
| [Vérifier l'accès d'un utilisateur](https://docs.whop.com/fr/api-reference/users/check-user-access.md) | GET `/users/{id}/access/{resource_id}` |
| [Récupérer les frais d'un utilisateur](https://docs.whop.com/fr/api-reference/users/retrieve-user-fees.md) | GET `/users/{user_id}/fees` |
| [Lister les actions recommandées](https://docs.whop.com/fr/api-reference/users/list-recommended-actions.md) | GET `/users/{id}/recommend_actions` |
| [Lister les autorisations OAuth](https://docs.whop.com/fr/api-reference/users/list-oauth-grants.md) | GET `/users/me/oauth_grants` |
| [Lister](https://docs.whop.com/fr/api-reference/users/list.md) | GET `/users/me/passkeys` |
| [Récupérer](https://docs.whop.com/fr/api-reference/users/retrieve.md) | GET `/users/me/preferences` |
| [Lister les expériences](https://docs.whop.com/fr/api-reference/users/list-experiences.md) | GET `/users/me/preferences/notifications/experiences` |
| [Lister les sujets](https://docs.whop.com/fr/api-reference/users/list-topics.md) | GET `/users/me/preferences/notifications/topics` |
| [Autoriser une app](https://docs.whop.com/fr/api-reference/users/authorize-an-app.md) | POST `/users/me/oauth_grants` |
| [Enregistrer](https://docs.whop.com/fr/api-reference/users/register.md) | POST `/users/me/passkeys` |
| [Créer un challenge](https://docs.whop.com/fr/api-reference/users/create-challenge.md) | POST `/users/me/passkeys/challenge` |
| [Mettre à jour un utilisateur](https://docs.whop.com/fr/api-reference/users/update-user.md) | PATCH `/users/{id}` |
| [Mettre à jour](https://docs.whop.com/fr/api-reference/users/update.md) | PATCH `/users/me/preferences` |
| [Définir](https://docs.whop.com/fr/api-reference/users/set.md) | PATCH `/users/me/preferences/notifications` |
| [Supprimer](https://docs.whop.com/fr/api-reference/users/delete.md) | DELETE `/users/me/passkeys/{id}` |

## Attributs

**id** `string` *required*

ID de l'utilisateur, préfixé par `user_`.

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

Le solde de l'utilisateur : liquidités personnelles + autres avoirs + dépôts encore en cours, plus les soldes des comptes qu'il possède. Calculé uniquement sur la vue de soi (récupérée avec l'ID réservé `me`) pour les appelants disposant de la portée de lecture du solde ; `null` sinon, ou lorsque `include_balance=false`.

> [accordion] Propriétés
>
> **businesses** `object[]` *required*
>
> Soldes des comptes que l'utilisateur possède, du solde le plus élevé au plus faible. Exclut les comptes sans solde.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > L'ID du compte, qui ressemble à biz\_\*\*\*\*\*\*\*\*\*\*\*\*\*.
> >
> > **balance\_usd** `string` *required*
> >
> > Le solde total du compte en USD.
> >
> > **logo\_url** `string | null` *required*
> >
> > L'URL du logo du compte.
> >
> > **name** `string | null` *required*
> >
> > Le nom d'affichage du compte.
>
> **businesses\_total\_usd** `string` *required*
>
> Solde combiné en USD de tous les comptes que l'utilisateur possède.
>
> **cash** `object[]` *required*
>
> Soldes de liquidités en monnaie fiduciaire, par devise.
>
> > [accordion] Propriétés
> >
> > **balance** `number` *required*
> >
> > Solde disponible dans la devise native.
> >
> > **balance\_usd** `number` *required*
> >
> > Solde disponible converti en USD.
> >
> > **currency** `string` *required*
> >
> > Code de devise ISO en minuscules, tel que `usd` ou `eur`.
> >
> > **in\_transit\_balance\_usd** `number` *required*
> >
> > Solde en cours de transfert vers le portefeuille ou la carte de l'utilisateur, converti en USD.
> >
> > **pending\_balance\_usd** `number` *required*
> >
> > Solde en attente converti en USD.
> >
> > **price\_usd** `number | null` *required*
> >
> > Prix en USD par unité de devise native, ou `null` lorsqu'aucun taux de change n'est disponible.
> >
> > **reserve\_balance\_usd** `number` *required*
> >
> > Solde réservé converti en USD.
> >
> > **total\_withdrawable\_balance** `number` *required*
> >
> > Montant retirable dans la devise native.
>
> **cash\_usd** `string` *required*
>
> Liquidités en monnaie fiduciaire en USD, y compris les montants en attente, en transit et en réserve.
>
> **crypto** `object[]` *required*
>
> Avoirs en cryptomonnaies par jeton dans le portefeuille propre du registre.
>
> > [accordion] Propriétés
> >
> > **balance** `string` *required*
> >
> > Montant détenu en unités natives du jeton, sous forme de chaîne décimale.
> >
> > **breakdown** `object` *required*
> >
> > Solde réparti en montants disponibles, en attente, en transit et en réserve, sous forme de chaînes décimales en unités natives. Les transferts entre le portefeuille et la carte de l'utilisateur sont indiqués dans `in_transit` jusqu'à leur arrivée.
> >
> > > [accordion] Propriétés
> > >
> > > **available** `string` *required*
> > >
> > > Montant que vous pouvez dépenser, envoyer ou retirer dès maintenant, en unités natives, sous forme de chaîne décimale.
> > >
> > > **finishing\_settlement** `string` *required*
> > >
> > > La partie de `pending` qui est déjà réglée et attend d'être transférée vers le portefeuille crypto du compte ou la Whop Card, où elle devient `available`. Le transfert commence généralement dans l'heure ; pendant son exécution, le montant est indiqué dans `in_transit` à la place. Les fonds transférés uniquement pour compléter le solde minimum conservé du compte ne sont pas inclus. En unités natives, sous forme de chaîne décimale.
> > >
> > > **in\_transit** `string` *required*
> > >
> > > Montant en cours de transfert entre les propres destinations du compte, comme un rechargement de carte. En unités natives, sous forme de chaîne décimale.
> > >
> > > **pending** `string` *required*
> > >
> > > Montant des paiements récents encore en cours de règlement, en unités natives, sous forme de chaîne décimale.
> > >
> > > **pending\_settlements** `object[]` *required*
> > >
> > > Date à laquelle le montant en attente devrait être réglé, une entrée par jour, la plus proche en premier. Les fonds sans jour de règlement prévu, y compris `finishing_settlement`, sont exclus ; ces entrées plus `finishing_settlement` peuvent donc totaliser moins que `pending`, jamais plus.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Montant attendu ce jour-là, en unités natives, sous forme de chaîne décimale.
> > > >
> > > > **date** `string` *required*
> > > >
> > > > Le jour où ces fonds devraient finir d'être réglés, sous forme de date ISO 8601.
> > >
> > > **reserve** `string` *required*
> > >
> > > Montant retenu, en unités natives, sous forme de chaîne décimale. Récupérez les réserves du compte pour savoir pourquoi il est retenu et quand il sera débloqué.
> >
> > **icon\_url** `string | null` *required*
> >
> > URL de l'icône du jeton.
> >
> > **name** `string | null` *required*
> >
> > Le nom d'affichage du jeton.
> >
> > **price\_usd** `number | null` *required*
> >
> > Prix en USD par jeton, ou `null` s'il est inconnu.
> >
> > **symbol** `string` *required*
> >
> > Symbole d'affichage du jeton, tel que `USDT`, `XAUT` ou `cbBTC`.
> >
> > **value\_usd** `number` *required*
> >
> > Valeur de l'avoir en USD.
>
> **crypto\_usd** `string` *required*
>
> Avoirs en cryptomonnaies en USD.
>
> **pending\_usd** `string` *required*
>
> Soldes en monnaie fiduciaire en attente et en transit, plus les dépôts de trésorerie en cours, en USD.
>
> **total\_usd** `string` *required*
>
> Le solde personnel de l'utilisateur en USD : liquidités (disponibles + en attente + en transit + réserve) + autres avoirs + dépôts encore en cours. Exclut les soldes des comptes (voir businesses\_total\_usd).
>
> **treasury\_pending\_usd** `string` *required*
>
> Transferts de solde vers le portefeuille de l'utilisateur encore en cours, en USD.

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

Le solde cumulé du portefeuille de l'utilisateur au fil du temps (points USD `\{ t, v }` plus last/min/max), pour le graphique du solde. Activez-le avec `include_balance_history=true` lorsque vous vous récupérez vous-même avec l'ID réservé `me` ; renseigné uniquement pour les appelants disposant de la portée de lecture du solde et `null` sinon. Un utilisateur sans activité de portefeuille renvoie une série vide.

> [accordion] Propriétés
>
> **data** `object[]` *required*
>
> Points de solde cumulé sur la période demandée, du plus ancien au plus récent.
>
> > [accordion] Propriétés
> >
> > **t** `integer` *required*
> >
> > Horodatage du point, en secondes Unix.
> >
> > **v** `number` *required*
> >
> > Solde cumulé du portefeuille à ce point, en USD.
>
> **last** `number` *required*
>
> Valeur du point le plus récent, en USD.
>
> **max** `number` *required*
>
> Valeur maximale sur la période, en USD.
>
> **min** `number` *required*
>
> Valeur minimale sur la période, en USD.

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

Les avoirs personnels de l'utilisateur, chacun avec sa valeur en USD et sa répartition, sous la même forme que les `balances` d'un compte. Vide lorsque `total_usd` est `null`.

> [accordion] Propriétés
>
> **balance** `string` *required*
>
> Montant total détenu en unités natives, sous forme de chaîne décimale.
>
> **breakdown** `object` *required*
>
> Solde réparti en montants disponibles, en attente et en réserve, sous forme de chaînes décimales en unités natives, avec les jours où le montant en attente devrait être réglé.
>
> > [accordion] Propriétés
> >
> > **available** `string` *required*
> >
> > Montant que vous pouvez dépenser, envoyer ou retirer dès maintenant, en unités natives, sous forme de chaîne décimale.
> >
> > **finishing\_settlement** `string` *required*
> >
> > La partie de `pending` qui est déjà réglée et attend d'être transférée vers le portefeuille crypto du compte ou la Whop Card, où elle devient `available`. Le transfert commence généralement dans l'heure ; pendant son exécution, le montant est indiqué dans `in_transit` à la place. Les fonds transférés uniquement pour compléter le solde minimum conservé du compte ne sont pas inclus. En unités natives, sous forme de chaîne décimale.
> >
> > **in\_transit** `string` *required*
> >
> > Montant en cours de transfert entre les propres destinations du compte, comme un rechargement de carte. En unités natives, sous forme de chaîne décimale.
> >
> > **pending** `string` *required*
> >
> > Montant des paiements récents encore en cours de règlement, en unités natives, sous forme de chaîne décimale.
> >
> > **pending\_settlements** `object[]` *required*
> >
> > Date à laquelle le montant en attente devrait être réglé, une entrée par jour, la plus proche en premier. Les fonds sans jour de règlement prévu, y compris `finishing_settlement`, sont exclus ; ces entrées plus `finishing_settlement` peuvent donc totaliser moins que `pending`, jamais plus.
> >
> > > [accordion] Propriétés
> > >
> > > **amount** `string` *required*
> > >
> > > Montant attendu ce jour-là, en unités natives, sous forme de chaîne décimale.
> > >
> > > **date** `string` *required*
> > >
> > > Le jour où ces fonds devraient finir d'être réglés, sous forme de date ISO 8601.
> >
> > **reserve** `string` *required*
> >
> > Montant retenu, en unités natives, sous forme de chaîne décimale. Récupérez les réserves du compte pour savoir pourquoi il est retenu et quand il sera débloqué.
>
> **icon\_url** `string | null` *required*
>
> URL de l'icône de l'avoir.
>
> **name** `string` *required*
>
> Le nom d'affichage de l'avoir
>
> **price\_usd** `number | null` *required*
>
> Prix en USD par unité, ou `null` lorsqu'aucun taux de change n'est disponible.
>
> **symbol** `string` *required*
>
> Symbole d'affichage de l'avoir, tel que `USDT`, `cbBTC` ou `EUR`.
>
> **value\_usd** `string | null` *required*
>
> Valeur de l'avoir en USD, ou `null` lorsqu'aucun taux de change n'est disponible.

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

L'objet contenant la bannière de profil de l'utilisateur. `null` lorsque l'utilisateur n'a pas de bannière.

> [accordion] Propriétés
>
> **url** `string` *required*
>
> URL de l'image de la bannière de profil.

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

La biographie de l'utilisateur

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

L'état de la demande de carte personnelle de l'utilisateur. Renseigné uniquement sur la vue de soi (récupérée avec l'ID réservé `me`) pour les appelants disposant de la portée de lecture du solde ; `null` sinon, ou lorsque l'utilisateur n'a jamais demandé de carte.

> [accordion] Propriétés
>
> **decline\_reason** `string | null` *required*
>
> Raison pour laquelle l'émetteur de la carte a refusé la demande. `unsupported_state` remplace `unsupported_region` pour une personne ou une entreprise vérifiée aux États-Unis. `compliance` couvre les contrôles de sanctions, de personnes politiquement exposées et de presse défavorable. `other` couvre les raisons qui ne figurent pas dans cette liste. `null` lorsque `status` n'est pas `denied`, ou lorsque l'émetteur n'a pas refusé la demande.
>
> Options disponibles : `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> Indique si la demande de carte vérifie une entreprise (`business`, KYB) ou une personne (`individual`, identité du consommateur). `null` lorsque la demande n'est pas encore liée à une vérification.
>
> Options disponibles : `individual`, `business`
>
> **status** `string` *required*
>
> L'état de la demande de carte. `approved` signifie que des cartes peuvent être émises. `needs_verification` signifie que le demandeur n'a pas encore terminé la vérification d'identité ; `needs_information` signifie qu'il l'a terminée, mais que les documents ont été rejetés pour une raison corrigeable et doivent être soumis à nouveau. `pending` et `manual_review` sont en cours. `denied`, `locked` et `canceled` sont définitifs.
>
> Options disponibles : `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

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

La ville de l'utilisateur, déduite de son adresse IP. `null` lorsqu'elle est inconnue ou que l'utilisateur a désactivé le partage de localisation.

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

Le pays de l'utilisateur sous forme de code ISO 3166-1 alpha-2, déduit de son adresse IP. `null` lorsqu'il est inconnu ou que l'utilisateur a désactivé le partage de localisation.

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

Date de création de l'utilisateur, sous forme d'horodatage ISO 8601

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

La date de naissance de l'utilisateur sous forme de date ISO 8601, comme `1998-04-23`. Renseignée uniquement sur la vue de soi (récupérée avec l'ID réservé `me`) pour les appelants disposant de la portée de lecture de l'e-mail ; `null` sinon, ou lorsque l'utilisateur ne l'a pas renseignée.

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

Le revenu brut de l'utilisateur en USD au fil du temps, y compris une répartition des commissions Partner. Renseigné uniquement lors de la lecture de soi pour un seul utilisateur, pour les appelants disposant de la portée de lecture du solde ; `null` sinon.

> [accordion] Propriétés
>
> **first\_earned\_at** `string | null` *required*
>
> La première fois que l'utilisateur a perçu un revenu brut, sous forme d'horodatage ISO 8601.
>
> **owned\_accounts** `object` *required*
>
> Revenu brut provenant des comptes que l'utilisateur possède ou sur lesquels il dispose d'une autorisation de propriétaire.
>
> > [accordion] Propriétés
> >
> > **last\_24\_hours** `string` *required*
> >
> > Revenu brut en USD sur les dernières 24 heures.
> >
> > **last\_30\_days** `string` *required*
> >
> > Revenu brut en USD sur les 30 derniers jours.
> >
> > **last\_7\_days** `string` *required*
> >
> > Revenu brut en USD sur les 7 derniers jours.
> >
> > **lifetime** `string` *required*
> >
> > Revenu brut total en USD depuis l'origine.
>
> **partners** `object` *required*
>
> Commissions Partner créditées sur le portefeuille de l'utilisateur. Les versements Partner en attente sont exclus jusqu'à leur crédit ; les annulations ultérieures ne réduisent pas le revenu brut.
>
> > [accordion] Propriétés
> >
> > **last\_24\_hours** `string` *required*
> >
> > Revenu brut en USD sur les dernières 24 heures.
> >
> > **last\_30\_days** `string` *required*
> >
> > Revenu brut en USD sur les 30 derniers jours.
> >
> > **last\_7\_days** `string` *required*
> >
> > Revenu brut en USD sur les 7 derniers jours.
> >
> > **lifetime** `string` *required*
> >
> > Revenu brut total en USD depuis l'origine.
>
> **personal** `object` *required*
>
> Revenu brut provenant du portefeuille personnel de l'utilisateur.
>
> > [accordion] Propriétés
> >
> > **last\_24\_hours** `string` *required*
> >
> > Revenu brut en USD sur les dernières 24 heures.
> >
> > **last\_30\_days** `string` *required*
> >
> > Revenu brut en USD sur les 30 derniers jours.
> >
> > **last\_7\_days** `string` *required*
> >
> > Revenu brut en USD sur les 7 derniers jours.
> >
> > **lifetime** `string` *required*
> >
> > Revenu brut total en USD depuis l'origine.
>
> **total** `object` *required*
>
> Revenu brut provenant du portefeuille personnel de l'utilisateur plus les comptes qu'il possède ou sur lesquels il dispose d'une autorisation de propriétaire.
>
> > [accordion] Propriétés
> >
> > **last\_24\_hours** `string` *required*
> >
> > Revenu brut en USD sur les dernières 24 heures.
> >
> > **last\_30\_days** `string` *required*
> >
> > Revenu brut en USD sur les 30 derniers jours.
> >
> > **last\_7\_days** `string` *required*
> >
> > Revenu brut en USD sur les 7 derniers jours.
> >
> > **lifetime** `string` *required*
> >
> > Revenu brut total en USD depuis l'origine.

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

L'adresse e-mail de l'utilisateur. Renseignée uniquement sur la vue de soi (récupérée avec l'ID réservé `me`) pour les appelants disposant de la portée de lecture de l'e-mail ; `null` sinon, ou tant que le compte n'a pas encore d'e-mail confirmé.

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

Le nombre d'utilisateurs qui suivent cet utilisateur.

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

Le Whop Level de l'utilisateur, calculé sur l'ensemble des comptes qu'il possède. `current` est public. Les champs de points et de dépenses sont renseignés uniquement lorsque vous vous récupérez vous-même avec l'ID réservé `me` et disposez de la portée de lecture du solde. `null` dans les listes, et lorsqu'aucun de ses comptes ne participe aux Whop Levels.

> [accordion] Propriétés
>
> **current** `integer` *required*
>
> Le niveau applicable : le plus élevé atteint par l'utilisateur ce mois-ci ou au cours des 5 mois précédents, de `0` à `10`. Public.
>
> **points** `integer | null` *required*
>
> Points gagnés ce mois-ci sur l'ensemble des comptes que l'utilisateur possède, plus ses points partenaire, arrondis à l'inférieur. Un compte dont le solde net du mois est inférieur à zéro compte pour zéro. `null` sauf si vous vous récupérez vous-même avec l'ID réservé `me` et disposez de la portée de lecture du solde.
>
> **points\_by\_source** `object | null` *required*
>
> Les points de ce mois-ci, répartis selon leur provenance. Chaque source est nette de ses remboursements, elle peut donc être négative. `null` sauf si vous vous récupérez vous-même avec l'ID réservé `me` et disposez de la portée de lecture du solde.
>
> > [accordion] Propriétés
> >
> > **ads** `integer` *required*
> >
> > Points provenant des frais Whop Ads payés, nets des remboursements : 10 par dollar, arrondis vers zéro.
> >
> > **cards** `integer` *required*
> >
> > Points provenant des dépenses Whop Card capturées, nettes des remboursements : 10 par dollar, arrondis vers zéro.
> >
> > **partners** `integer` *required*
> >
> > Points provenant des comptes que le propriétaire a parrainés en tant que partenaire : 1 pour 3 gagnés par ces comptes, arrondis vers zéro.
> >
> > **trading** `integer` *required*
> >
> > Points provenant du volume de trading de contrats perpétuels exécuté via Whop : 1 par dollar échangé, arrondis vers zéro.
>
> **resets\_at** `string | null` *required*
>
> Date à laquelle les points de ce mois-ci sont remis à zéro, sous forme d'horodatage ISO 8601. `null` sauf si vous vous récupérez vous-même avec l'ID réservé `me` et disposez de la portée de lecture du solde.

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

Le nom d'affichage de l'utilisateur

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

L'objet contenant l'avatar. Son `url` est toujours présente et correspond à une image de remplacement générée lorsque l'utilisateur n'a défini aucune photo.

> [accordion] Propriétés
>
> **url** `string` *required*
>
> URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image de remplacement générée lorsque l'utilisateur n'a défini aucune photo.

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

Les comptes de réseaux sociaux et les sites web affichés sur le profil public de l'utilisateur. Vide lorsque l'utilisateur n'en a aucun.

> [accordion] Propriétés
>
> **url** `string` *required*
>
> L'URL du lien.
>
> **username** `string | null` *required*
>
> L'identifiant de l'utilisateur sur la plateforme, tel que saisi ou tel que fourni par le compte connecté. `null` pour les liens sans identifiant, comme un site personnel.
>
> **verified** `boolean` *required*
>
> Indique si Whop a vérifié que l'utilisateur possède le compte.
>
> **website** `string` *required*
>
> La plateforme vers laquelle pointe le lien. `website` désigne un site personnel plutôt qu'une plateforme sociale.
>
> Options disponibles : `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`

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

L'État ou la région de l'utilisateur, déduit de son adresse IP. `null` lorsqu'il est inconnu ou que l'utilisateur a désactivé le partage de localisation.

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

Valeur totale en USD des avoirs personnels de l'utilisateur dans `balances`, pour ceux dont le taux de change est connu. Calculée uniquement sur la vue de soi (récupérée avec l'ID réservé `me`) pour les appelants disposant de la portée de lecture du solde ; `null` sinon, lorsque `include_balance=false`, ou lorsque la source du solde est indisponible.

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

L'adresse du compte de trading, un instantané de sa marge et de ses positions ouvertes, et ses abonnements WebSocket. Activez-le avec `include_trading=true` lors de la récupération de `me`. `null` sinon, sans autorisation de trading, ou sans portefeuille Ethereum.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du portefeuille Whop associé à ce compte de trading, préfixé par `cwal_`.
>
> **account\_id** `string | null` *required*
>
> Le compte propriétaire de ce compte de trading, préfixé par `biz_`. `null` lorsqu'il appartient à un utilisateur.
>
> **hyperliquid** `object | null` *required*
>
> État spécifique à Hyperliquid. Présent lorsque `provider` vaut `hyperliquid`, sinon `null`.
>
> > [accordion] Propriétés
> >
> > **address** `string` *required*
> >
> > Adresse de portefeuille en minuscules qui détient le compte Hyperliquid.
> >
> > **depositable** `string | null` *required*
> >
> > USDT0 dans le portefeuille Whop sur Plasma qu'une transaction `deposit` peut transférer vers ce compte, sous forme de chaîne décimale. `null` lorsque la chaîne n'a pas pu être lue.
> >
> > **margin\_summary** `object | null` *required*
> >
> > Valeur du compte et marge sur la plateforme d'échange principale et les marchés `xyz`, lues depuis Hyperliquid au plus une fois par seconde. `null` lorsque Hyperliquid n'a pas pu être lu. Utilisez `websocket_subscriptions` pour les mises à jour en direct.
> >
> > > [accordion] Propriétés
> > >
> > > **account\_value** `object` *required*
> > >
> > > Valeur totale du compte en USD, y compris les profits et pertes latents.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > Marge allouée aux positions ouvertes, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > Valeur notionnelle combinée des positions ouvertes, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > USD pouvant être retirés dès maintenant sans clôturer de positions.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > Positions perpétuelles ouvertes sur la plateforme d'échange principale et les marchés `xyz`, lues depuis Hyperliquid au plus une fois par seconde. `null` lorsque Hyperliquid n'a pas pu être lu. Utilisez `websocket_subscriptions` pour les mises à jour en direct.
> >
> > > [accordion] Propriétés
> > >
> > > **id** `string` *required*
> > >
> > > ID de la position de trading, préfixé par `trdpos_`. Stable pour un marché au sein d'un même compte de trading.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > Prix d'entrée moyen en USD, ou `null` lorsque le fournisseur ne l'indique pas.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Détails du contrat perpétuel Hyperliquid. Présent sur les positions Hyperliquid, sinon `null`.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > Financement payé sur la position sur plusieurs périodes, en USD.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > Financement payé sur ce marché sur l'ensemble de l'historique du compte, en USD, ou `null` lorsqu'il n'est pas disponible.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > Financement payé depuis la dernière modification de la taille de la position, en USD, ou `null` lorsqu'il n'est pas disponible.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > Financement payé depuis l'ouverture de la position, en USD, ou `null` lorsqu'il n'est pas disponible.
> > > > >
> > > > > > [accordion] Propriétés
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > Mode de marge et multiplicateur de la position.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross` partage la marge entre les positions. `isolated` limite la marge à cette position.
> > > > >
> > > > > Options disponibles : `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > Multiplicateur appliqué à la marge de la position, par exemple `10` pour 10x.
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > Prix de liquidation estimé en USD, ou `null` lorsque Hyperliquid n'en indique aucun.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > Marge allouée à la position, en USD.
> > > >
> > > > > [accordion] Propriétés
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > Rendement des capitaux propres sous forme de chaîne de ratio décimal, par exemple `0.1` pour 10 %.
> > >
> > > **market** `string` *required*
> > >
> > > Symbole du marché chez le fournisseur, par exemple `ETH`.
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > Valeur actuelle de la position en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **side** `string` *required*
> > >
> > > Options disponibles : `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > Taille absolue de la position sous forme de chaîne décimale.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > Profit ou perte latent en USD. Négatif en cas de perte.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > Abonnements pour les mises à jour en direct du compte. Envoyez chaque `message` tel quel après vous être connecté à `websocket_url`.
> >
> > > [accordion] Propriétés
> > >
> > > **channel** `string` *required*
> > >
> > > Le flux de mises à jour en direct qu'ouvre cet abonnement.
> > >
> > > Options disponibles : `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > Message d'abonnement JSON à envoyer tel quel via le WebSocket Hyperliquid.
> >
> > **websocket\_url** `string` *required*
> >
> > URL du WebSocket Hyperliquid à laquelle se connecter directement pour les mises à jour en direct.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> Plateforme de trading qui détient les positions et les ordres.
>
> Options disponibles : `hyperliquid`
>
> **spot** `object | null` *required*
>
> Avoirs au comptant dans le portefeuille Whop avec leur prix d'entrée et leurs profits et pertes. `null` lorsqu'ils n'ont pas pu être lus.
>
> > [accordion] Propriétés
> >
> > **holdings** `object[]` *required*
> >
> > Chaque actif au comptant que le portefeuille détient encore, avec son prix d'entrée moyen et ses profits et pertes. Le prix de revient considère que les unités les plus anciennes sont vendues en premier et inclut les actifs provenant de l'extérieur de Whop.
> >
> > > [accordion] Propriétés
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > Le prix moyen payé par unité pour ce qui est encore détenu, en USD, en considérant que les unités les plus anciennes sont vendues en premier. `null` lorsqu'il n'est pas connu.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > Le montant payé en USD pour les unités encore détenues.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **market** `string` *required*
> > >
> > > L'`id` du marché au comptant provenant de `GET /trades/markets`, tel que `BTC`, `XAUT`, ou le symbole d'une action tokenisée tel que `AAPL`.
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > Gains et pertes déjà réalisés par la vente, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > La valeur des unités encore détenues moins leur `cost_basis`, en USD.
> > >
> > > > [accordion] Propriétés
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, `"10.00"` correspond à dix dollars. Il s'agit d'une chaîne afin qu'aucun nombre à virgule flottante ne l'arrondisse pendant le transfert.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Code de devise ISO 4217 à trois lettres, en minuscules.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales du montant. Il s'agit de la précision avec laquelle le prélèvement lui-même est effectué.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Le nombre de décimales à AFFICHER. Généralement égal à `decimals`, mais délibérément pas toujours : le COP est prélevé en centavos mais exprimé en pesos entiers, il vaut donc `2` et `0`. Utilisez cette valeur pour formater le nombre selon votre propre locale.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `unrealized_pnl` en pourcentage de `cost_basis`, où `2` signifie une hausse de 2 %. `null` lorsqu'il n'est pas connu.
>
> **user\_id** `string | null` *required*
>
> L'utilisateur propriétaire de ce compte de trading, préfixé par `user_`. `null` lorsqu'il appartient à un compte.

**username** `string` *required*

Le nom d'utilisateur unique de l'utilisateur

**verification** `object` *required*

Statut de vérification d'identité des profils `individual` (KYC) et `business` (KYB) de l'utilisateur. Chacun vaut `null` jusqu'à sa création, sinon un `status` parmi `not_started`, `pending`, `approved` ou `rejected`.

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

Date à laquelle l'utilisateur a reçu un badge vérifié, sous forme d'horodatage ISO 8601. `null` lorsque l'utilisateur n'est pas vérifié.

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

Date à laquelle l'utilisateur est devenu un Whop Partner inscrit, sous forme d'horodatage ISO 8601. `null` s'il ne s'est jamais inscrit.

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

Nombre de comptes que l'utilisateur a parrainés sur Whop en tant que Whop Partner et qui ont traité plus de 1 \$ de volume attribué à l'utilisateur. Renseigné uniquement lors de la récupération d'un seul utilisateur qui est un Verified Whop Partner ; `null` sinon.

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

Date à laquelle l'utilisateur est devenu un Verified Whop Partner, sous forme d'horodatage ISO 8601. `null` pour les utilisateurs qui ne sont pas des Verified Whop Partners, y compris les partenaires ayant quitté le programme et les utilisateurs suspendus.

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

- [Utilisateurs](https://docs.whop.com/fr/api-reference/legacy/users/user.md)
- [Utilisateur autorisé](https://docs.whop.com/fr/api-reference/legacy/authorized-users/authorized-user.md)
- [API Notifications](https://docs.whop.com/fr/api-reference/notifications/notification.md)
