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

# BalanceElement

> Het saldo van een account en een grafiek van hoe het is veranderd. Het totaal en de verandering staan bovenaan, de grafiek daaronder en de knoppen voor het tijdsbereik onderaan. De kijker kan afzonderlijke punten in de grafiek aflezen en zelf het tijdsbereik wijzigen.

> [!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 `currency` 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; `range` kiest het tijdsbereik waarmee het opent. 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, BalanceElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <BalanceElement onRangeChanged={(e) => console.log(e)} onRangeBrushed={(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('balance', {
    onRangeChanged: (e) => console.log(e),
    onRangeBrushed: (e) => console.log(e)
  }).mount('#wallet-balances-balance');
</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 {
        BalanceElement(
            accountId: "biz_xxxx",
            range: .oneMonth
        )
    }
}
```

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

[BalanceElement draaiend op een iPhone-simulator](https://app.revyl.ai/embed/bb0f1c0a-4242-486a-a5f5-03dd9711744c?controls=0)

## Props

**accessToken** `string`

Een scoped token voor het lezen. Een account heeft `company:balance:read` nodig voor het totaal en `stats:read` voor de grafiek; het eigen saldo van een gebruiker heeft `user:balance:read` nodig. Maak het aan op je server met `POST /api/v1/access_tokens` en stel een nieuw token in voordat het verloopt. Zonder token gebruiken de leesacties de eigen sessie van de kijker, wat alleen same-origin werkt. Standaard `""`.

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"`

Het tijdsbereik waarmee wordt geopend. De knoppen wijzigen het vanaf daar, of stel deze prop opnieuw in om het zelf te beheren. Standaard `"1M"`.

**openedAt** `string`

Wanneer het account is geopend, als ISO 8601-tijdstempel. `ALL` begint hier in plaats van bij de standaard van vijf jaar, zodat een ouder account zijn volledige geschiedenis behoudt. Standaard `""`.

**accountName** `string`

Voegt de accountnaam toe aan het label: normaal `Total balance · Acme`, en `Acme balance on Jul 9` terwijl de kijker een punt afleest. Zonder deze prop is het label gewoon `Total balance`. Standaard `""`.

**brush** `object | null`

Het geselecteerde bereik in de grafiek, als ISO 8601-tijdstempels. Stel het in om de selectie zelf te beheren, of op `null` om de selectie van de kijker te wissen. Geef terug wat `rangeBrushed` meldt, dan wist het wissen van een filter elders op je pagina ook de selectie hier. Standaard `null`.

**eigenschappen**

**from** `string` *required*

**to** `string` *required*

**markedAt** `string`

Een moment om in de grafiek te markeren, als ISO 8601-tijdstempel — het punt waarnaar iets anders op je pagina verwijst, zoals de rij onder de aanwijzer in een activiteitenlijst. Het werkt alsof de kijker zelf over dat punt hovert, en wordt genegeerd wanneer het buiten het zichtbare venster valt of wanneer de kijker de grafiek afleest. Standaard `""`.

**includeOwnedAccounts** `boolean`

Telt voor een gebruiker het eigen geld plus elk account dat de gebruiker bezit op, in plaats van alleen het eigen geld. Wordt genegeerd voor een account, dat al één account is. Standaard `false`.

**hideTotal** `boolean`

Verberg het totaal en de verandering, zodat de grafiek en de bereikknoppen overblijven. Standaard `false`.

**hideChart** `boolean`

Verberg de grafiek, zodat het totaal en de bereikknoppen overblijven. Standaard `false`.

**height** `number`

Hoe hoog de grafiek wordt getekend, in pixels. Standaard `210`.

## Events

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

### `onRangeChanged`

Het zichtbare tijdsbereik is gewijzigd. Neem het over als iets anders op je pagina dezelfde periode leest.

**payload** `object`

**eigenschappen**

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"` *required*

### `onRangeBrushed`

De kijker heeft over de grafiek gesleept om een bereik te selecteren, of heeft de selectie gewist (`null`). Geeft ISO 8601-tijdstempels plus het bereik waarin ze zijn afgelezen, zodat je je eigen views, zoals een activiteitenlijst of een tabel, op dezelfde periode kunt filteren.

**payload** `object | null`

**eigenschappen**

**from** `string` *required*

**to** `string` *required*

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"` *required*

### `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\<BalanceElementProps\>` *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-Balance` | Het totaal, de lijn en de vensterkiezer |
| `.whop-BalanceBrushSummary` | Het gemeten stuk |
| `.whop-BalanceChart` | De saldolijn |
| `.whop-BalanceRanges` | De vensterkiezer |
| `.whop-BalanceTotal` | Het totaal en de verandering |

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

// 5 classes use this shape
wallet.update({
  appearance: { classes: { 'whop-Balance': { 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.

**currency** `String`

De valuta waarin het totaal en de grafiek worden weergegeven. Standaard `"usd"`.

**range** `WalletBalanceRange`

Het tijdsbereik waarmee de grafiek opent: `.oneDay`, `.oneWeek`, `.oneMonth`, `.oneYear`, `.all`. Standaard `.oneMonth`, en de kijker kan het wijzigen met de kiezer.

## Statussen

Toont een placeholdergrafiek terwijl de gegevens laden. Als de vergelijkingsperiode mislukt, wordt de verandering verborgen in plaats van geschat, zodat elk getal op het scherm daadwerkelijk is gemeten. Een account-ID dat niet kan worden opgelost, toont `Couldn't load this account.` in plaats van te blijven laden.

## Goed om te weten

* Druk en sleep over de grafiek om erdoorheen te scrollen. De kop volgt het punt onder je vinger en keert terug naar het totaal wanneer je loslaat.
* Saldogeschiedenis is alleen beschikbaar voor account-ID's met het voorvoegsel `biz_`, dus een persoonlijk account met het voorvoegsel `user_` toont het totaal zonder grafiek.
* Werkt samen met [`ListElement`](https://docs.whop.com/nl/elements/latest/wallet/balances-list#swift), dat hetzelfde totaal opsplitst in afzonderlijke tegoeden.

> [!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

- [Balances](https://docs.whop.com/nl/elements/latest/wallet/balances.md)
- [ListElement](https://docs.whop.com/nl/elements/latest/wallet/balances-list.md)
- [Aan de slag met Elements](https://docs.whop.com/nl/elements/latest/getting-started.md)
