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

> En kontos saldo og et diagram over, hvordan den har ændret sig. Totalen og dens ændring står øverst, diagrammet under det og knapperne til tidsinterval nederst. Seeren kan aflæse enkelte punkter på diagrammet og selv skifte tidsinterval.

> [!NOTE]
>
> Denne side dokumenterer `@whop/elements@1.10.0` og `@whop/elements-react@1.10.0`.

*Siden `v1.0.0`.*

Monteres inde i [`Balances`](https://docs.whop.com/da/elements/latest/wallet/balances), i [`Wallet`](https://docs.whop.com/da/elements/latest/wallet/overview). `accountId` og `currency` kommer fra `Wallet`. Send props og callbacks via create-indstillingerne eller React-props.

Monteres hvor som helst i dit view-hierarki. Tager et `accountId` og indlæser sine egne data; `range` vælger det tidsinterval, den åbner på. Roden er en `VStack`, så den tilpasser sin størrelse til indholdet og fylder den bredde, du giver den.

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

Eksempeldata. [Åbn Playground](https://docs.whop.com/da/elements/latest/wallet/overview#playground).

[BalanceElement kørende på en iPhone-simulator](https://app.revyl.ai/embed/bb0f1c0a-4242-486a-a5f5-03dd9711744c?controls=0)

## Props

**accessToken** `string`

Et afgrænset token til læsningerne. En konto skal have `company:balance:read` for totalen og `stats:read` for diagrammet; en brugers egen saldo kræver `user:balance:read`. Udsted det på din server med `POST /api/v1/access_tokens`, og sæt et nyt, før det udløber. Uden det bruger læsningerne seerens egen session, hvilket kun virker på samme origin. Standard er `""`.

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

Det tidsinterval, der åbnes på. Knapperne ændrer det derfra, eller sæt denne prop igen for selv at styre det. Standard er `"1M"`.

**openedAt** `string`

Hvornår kontoen blev oprettet, som et ISO 8601-tidsstempel. `ALL` starter her i stedet for ved sin standard på fem år, så en konto, der er ældre end det, beholder hele sin historik. Standard er `""`.

**accountName** `string`

Tilføjer kontonavnet til etiketten: normalt `Total balance · Acme` og `Acme balance on Jul 9`, mens seeren aflæser et punkt. Uden det er etiketten blot `Total balance`. Standard er `""`.

**brush** `object | null`

Det markerede interval på diagrammet som ISO 8601-tidsstempler. Sæt det for selv at styre markeringen, eller `null` for at rydde den, seeren har lavet. Send det tilbage, som `rangeBrushed` rapporterer, så rydder en nulstilling af et filter et andet sted på din side også markeringen her. Standard er `null`.

**egenskaber**

**from** `string` *required*

**to** `string` *required*

**markedAt** `string`

Et tidspunkt, der skal markeres på diagrammet, som et ISO 8601-tidsstempel – det punkt, noget andet på din side peger på, f.eks. rækken under markøren i en aktivitetsliste. Det opfører sig, som om seeren selv holdt markøren over punktet, og ignoreres, når det falder uden for det viste vindue, eller når seeren aflæser diagrammet. Standard er `""`.

**includeOwnedAccounts** `boolean`

For en bruger: summér vedkommendes egne penge plus alle konti, vedkommende ejer, i stedet for kun egne penge. Ignoreres for en konto, som allerede er en enkelt konto. Standard er `false`.

**hideTotal** `boolean`

Skjul totalen og dens ændring, så diagrammet og intervalknapperne står tilbage. Standard er `false`.

**hideChart** `boolean`

Skjul diagrammet, så totalen og intervalknapperne står tilbage. Standard er `false`.

**height** `number`

Hvor højt diagrammet tegnes, i pixels. Standard er `210`.

## Hændelser

Send callbacks i create-indstillingerne eller React-props.

### `onRangeChanged`

Det synlige tidsinterval ændrede sig. Spejl det, hvis noget andet på din side læser den samme periode.

**payload** `object`

**egenskaber**

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

### `onRangeBrushed`

Seeren trak hen over diagrammet for at markere et interval eller ryddede markeringen (`null`). Giver ISO 8601-tidsstempler plus det interval, de blev aflæst i, så du kan filtrere dine egne visninger, f.eks. en aktivitetsliste eller en tabel, til den samme periode.

**payload** `object | null`

**egenskaber**

**from** `string` *required*

**to** `string` *required*

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

### `onLoaderStart`

Kører, efter at indlæsningsskelettet tegnes første gang, og før `onReady`.

### `onReady`

Kører efter elementets første komplette optegning.

### `onError`

Kører, når elementet ikke kan indlæses eller går ned. Fallback-visningen forbliver synlig. Brug `code` til programmatisk håndtering. `sourceKey` identificerer en host-state-kilde, der fejlede.

**e** `object`

**egenskaber**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metoder

Kald disse på det handle, som `create` returnerer, eller via en React-`ref`.

### `mount`

Monterer elementet i `target` og begynder indlæsningen. React-komponenter monterer sig selv.

**Parametre**

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

### `destroy`

Fjerner elementet og frigiver dets frame og abonnementer. Du kan kalde den mere end én gang. React fjerner elementet automatisk.

### `update`

Fletter nye props ind i det monterede element. I React ændrer du i stedet komponentens props.

**Parametre**

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

## Styling

Style disse dele via `appearance.classes`. Brug camel case eller kebab case til egenskabsnavne, og medtag enheder. Sidens stylesheets kan ikke nå elementets frame. Frameworket validerer hver deklaration, før den indsættes.

| Klasse | Rammer |
| - | - |
| `.whop-Balance` | Totalen, dens linje og vinduesvælgeren |
| `.whop-BalanceBrushSummary` | Det målte stykke |
| `.whop-BalanceChart` | Saldolinjen |
| `.whop-BalanceRanges` | Vinduesvælgeren |
| `.whop-BalanceTotal` | Totalen og dens bevægelse |

```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' } } }
});
```

I React sender du `appearance` til `<Wallet>`. Sæt det globalt med `WhopElements({ appearance })`.

## Parametre

**accountId** `String` *required*

Den konto, hvis penge visningen læser. Brug et konto-ID med præfikset `biz_`. Et bruger-ID med præfikset `user_` læser seerens egen saldo og kræver seergodkendelse (`WhopSDK.configureWithOAuth`), ikke et kontotoken.

**currency** `String`

Den valuta, totalen og diagrammet vises i. Standard er `"usd"`.

**range** `WalletBalanceRange`

Det tidsinterval, diagrammet åbner på: `.oneDay`, `.oneWeek`, `.oneMonth`, `.oneYear`, `.all`. Standard er `.oneMonth`, og seeren kan ændre det med vælgeren.

## Tilstande

Viser et pladsholderdiagram, mens dataene indlæses. Hvis sammenligningsperioden fejler, skjules ændringen i stedet for at blive gættet, så ethvert tal på skærmen er et, der faktisk er målt. Et konto-ID, der ikke kan opløses, viser `Couldn't load this account.` i stedet for at blive ved med at indlæse.

## Godt at vide

* Tryk og træk hen over diagrammet for at scrubbe det. Overskriften følger punktet under din finger og vender tilbage til totalen, når du slipper.
* Saldohistorik er kun tilgængelig for konto-ID'er med præfikset `biz_`, så en personlig konto med præfikset `user_` viser totalen uden et diagram.
* Passer sammen med [`ListElement`](https://docs.whop.com/da/elements/latest/wallet/balances-list#swift), som opdeler den samme total i individuelle beholdninger.

> [!NOTE]
>
> Kald `WhopSDK.configure(tokenProvider:)` én gang ved opstart. Visninger venter på tokenet. Se [Kom godt i gang](https://docs.whop.com/da/elements/latest/getting-started.md). Anvend et tema med `.whopTheme(_:)`.


## Related topics

- [ListElement](https://docs.whop.com/da/elements/latest/wallet/balances-list.md)
- [Kom godt i gang med Elements](https://docs.whop.com/da/elements/latest/getting-started.md)
- [Saldi](https://docs.whop.com/da/elements/latest/wallet/balances.md)
