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

# ListElement

> De tegoeden achter het saldo van een account. Elke valuta en token krijgt een eigen rij met de naam en de waarde in dollars, de grootste eerst. Rijen kunnen melden op welke de kijker heeft getikt, zodat je er je eigen scherm voor kunt openen. Wanneer `openHoldingOnSelect` aan staat, toont een klik op een rij de saldopagina van dat tegoed in plaats van de grafiek en lijst van deze eenheid.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Balances`](https://docs.whop.com/nl/elements/latest/wallet/balances), in [`Wallet`](https://docs.whop.com/nl/elements/latest/wallet/overview). `accountId` en `openHoldingOnSelect` komen van `Wallet`. Geef props en callbacks mee via de create-opties of als React-props.

Kan overal in je view-hiërarchie worden gemount. Neemt een `accountId` en laadt zijn eigen gegevens; geef ook een closure mee en de rijen worden tikbaar. De root is een `VStack`, dus de grootte past zich aan de inhoud aan en vult de breedte die je het geeft.

```tsx React theme={null}
import { WhopElements, Wallet, Balances, ListElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <ListElement onBalanceSelected={(e) => console.log(e)} onAccountSelected={(e) => console.log(e)} onCreditsSelected={(e) => console.log(e)} />
        </Balances>
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
  const balances = wallet.create('balances', { /* options */ });
  balances.create('list', {
    onBalanceSelected: (e) => console.log(e),
    onAccountSelected: (e) => console.log(e),
    onCreditsSelected: (e) => console.log(e)
  }).mount('#wallet-balances-list');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct WalletScreen: View {
    var body: some View {
        ListElement(
            accountId: "biz_xxxx"
        ) { balance in
            print(balance.symbol)
        }
    }
}
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/wallet/overview#playground).

[ListElement draaiend op een iPhone-simulator](https://app.revyl.ai/embed/f128a268-f5e0-47c1-8919-86e4f04d6876?controls=0)

## Props

**accessToken** `string`

Een scoped token voor het lezen. Een account heeft `company:balance:read` nodig; de tegoeden of de lijst met eigen accounts van een gebruiker hebben `user:balance:read` nodig. Maak het aan op je server met `POST /api/v1/access_tokens`. Zonder token gebruikt het lezen de eigen sessie van de kijker, wat alleen same-origin werkt.

**includeOwnedAccounts** `boolean`

Toon voor het `user_…`-account van een gebruiker het persoonlijke saldo, gevolgd door elk eigen account dat de backend retourneert, in plaats van de tegoeden binnen het persoonlijke account. Wordt genegeerd voor een account. Standaard `false`.

**showSourceCurrency** `boolean`

Toon elke rij in de valuta waarin het tegoed wordt aangehouden (€4.20, 0.00000009 cbBTC) en zet de dollarwaarde eronder. Standaard uitgeschakeld, dus elke rij staat in dollars. Standaard `false`.

**showUsdEquivalent** `boolean`

Behoud de dollarwaarde onder een tegoed dat in zijn eigen valuta wordt getoond. Geldt alleen wanneer `showSourceCurrency` aan staat. Standaard `true`.

**showPersonalAccount** `boolean`

Behoud de persoonlijke rij wanneer `includeOwnedAccounts` aan staat. Schakel het uit als je app geen persoonlijk account heeft om te openen. Standaard `true`.

**maxItems** `number`

Toon maximaal dit aantal tegoedrijen, de grootste eerst. Als er meer zijn, krijgt de lijst een bedieningselement Show all balances dat de rest ter plekke uitklapt. Zonder deze prop wordt elk tegoed getoond.

## Events

Geef callbacks mee in de create-opties of als React-props.

### `onBalanceSelected`

Er is op een tegoedrij geklikt, met `includeOwnedAccounts` uitgeschakeld. `holding` is `usd` voor de gecombineerde dollarrij, en anders het symbool van het tegoed (`cbBTC`, `EUR`), en `kind` vertelt je welke van de drie het is, zodat je kunt routeren zonder zelf symbolen te classificeren. Het element navigeert nooit.

**payload** `object`

**eigenschappen**

**holding** `string` *required*

**kind** `"usd" | "cash" | "asset"` *required*

### `onAccountSelected`

Er is op een accountrij geklikt, met `includeOwnedAccounts` ingeschakeld. `accountId` is de persoonlijke `user_…`-tag of een eigen `biz_…`-tag, en met `kind` kun je routeren zonder die te inspecteren. Het element navigeert nooit.

**payload** `object`

**eigenschappen**

**accountId** `string` *required*

**kind** `"personal" | "business"` *required*

### `onCreditsSelected`

Er is op de rij met Whop-credits geklikt. Credits zijn alleen op Whop te besteden en nooit op te nemen, dus ze staan buiten elke tegoedrij; de host opent zijn eigen creditsscherm. Het element navigeert nooit.

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is weergegeven en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet kan laden of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**eigenschappen**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

**target** `string | HTMLElement` *required*

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen vrij. Je kunt het meerdere keren aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de componentprops.

**Parameters**

**options** `Partial\<ListElementProps\>` *required*

## Styling

Style deze onderdelen via `appearance.classes`. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.

| Klasse | Doel |
| - | - |
| `.whop-ActivityRow` | Eén rij met grootboekactiviteit — het pictogram, de titel, het tijdstempel en het bedrag |
| `.whop-ActivitySurface` | De activiteitenfeed — titel, filters en maximaal elke opgehaalde rij |
| `.whop-BalanceBreakdownSurface` | Het saldototaal van een valuta, de gesegmenteerde balk en de bedragrijen |
| `.whop-BalanceRow` | Eén saldorij — het pictogram, de naam, de waarde en de chevron |
| `.whop-BalancesSurface` | De saldolijst — één rij per tegoed of account |
| `.whop-CashBalanceSurface` | De saldopagina van een tegoed — terug, titel, bedrag, uitsplitsing, acties en activiteit |
| `.whop-PlatformCreditsRow` | Door Whop uitgegeven credits — alleen op Whop te besteden, nooit op te nemen |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-ActivityRow': { borderRadius: '8px', fontWeight: '600' },
      'whop-ActivitySurface': { borderRadius: '8px', fontWeight: '600' },
      'whop-BalanceBreakdownSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 7 classes use this shape
wallet.update({
  appearance: { classes: { 'whop-ActivityRow': { fontWeight: '700' } } }
});
```

Geef in React `appearance` door aan `<Wallet>`. Stel het globaal in met `WhopElements({ appearance })`.

## Parameters

**accountId** `String` *required*

Het account waarvan de view het geld leest. Gebruik een account-ID met het voorvoegsel `biz_`. Een gebruikers-ID met het voorvoegsel `user_` leest het eigen saldo van de kijker en vereist kijkerauthenticatie (`WhopSDK.configureWithOAuth`), geen accounttoken.

**onBalanceSelected** `((WalletBalance) -\> Void)?`

Wordt aangeroepen met de rij waarop de kijker heeft getikt. Laat je het weg, dan worden de rijen zonder chevrons weergegeven en doet tikken niets.

## `WalletBalance`

Wat een selectie teruggeeft:

* `id: String`: stabiel per rij
* `symbol: String`: `USD`, `BTC`, …
* `displayName: String`: de naam die op de rij wordt getoond
* `amountUsd: Decimal`: de waarde van de rij in dollars
* `isCrypto: Bool`: een cryptotegoed in plaats van fiat

## Statussen

Toont twee placeholderrijen terwijl de saldi laden. Een account-ID dat niet kan worden opgelost, toont `Couldn't load this account.` Als het lezen van het saldo zelf mislukt, wordt de lijst leeg weergegeven in plaats van een fout te tonen.

## Goed om te weten

* Het scrolt niet zelfstandig, dus plaats het in een `ScrollView` wanneer het een scherm deelt met andere inhoud.
* Werkt samen met [`BalanceElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-balance#swift), dat het totaal van hetzelfde account toont en hoe het is veranderd.

> [!NOTE]
>
> Roep `WhopSDK.configure(tokenProvider:)` eenmaal aan bij het opstarten. Views wachten op het token. Zie [Aan de slag](https://docs.whop.com/nl/elements/latest/getting-started.md). Pas een thema toe met `.whopTheme(_:)`.


## Related topics

- [Aan de slag met Elements](https://docs.whop.com/nl/elements/latest/getting-started.md)
- [BalanceElement](https://docs.whop.com/nl/elements/latest/wallet/balances-balance.md)
- [Uitbetalingen voor subaccounts inschakelen](https://docs.whop.com/nl/developer/platforms/render-payout-portal.md)
