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

# Saldos

> Tres vistas del dinero de una cuenta. La vista de saldo muestra el total, un gráfico de cómo ha cambiado y un selector del intervalo de tiempo. La vista de lista muestra los activos que componen ese total, valorados en dólares. La vista de desglose divide una moneda en importes disponibles, pendientes, en reserva y negativos, sin controles de movimiento de dinero. Cuando `openHoldingOnSelect` está activado, una fila de la lista reemplaza el lienzo de esta unidad (el gráfico y la lista) por la página de saldo de ese activo, en lugar de solo informar del clic.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

Se monta dentro de [`Wallet`](https://docs.whop.com/es/elements/latest/wallet/overview). Créalo para obtener un handle y después monta sus elementos en ese handle. Llama a `destroy()` para eliminar el subcontrolador. Vuelve a crearlo para obtener un handle nuevo.

## Vista previa

Una demostración en vivo e interactiva de la disposición predeterminada de este subcontrolador con datos de ejemplo:

Se monta en cualquier lugar de tu jerarquía de vistas. [`BalanceElement`](https://docs.whop.com/es/elements/latest/wallet/balances-balance#swift) y [`ListElement`](https://docs.whop.com/es/elements/latest/wallet/balances-list#swift) son independientes, así que usa uno solo o ambos en una misma pantalla. Cada uno recibe un `accountId` y carga sus propios datos.

## Vista previa

Ejecutándose en un iPhone, en la app de ejemplo:

[BalanceElement ejecutándose en un simulador de iPhone](https://app.revyl.ai/embed/c1954726-8f9b-483d-9f50-247fa7bfb007?controls=0)

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <BalanceElement />
          <BreakdownElement />
          <ListElement />
        </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').mount('#wallet-balances-balance');
  balances.create('breakdown').mount('#wallet-balances-breakdown');
  balances.create('list').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 {
    let account = "biz_xxxx"

    var body: some View {
        ScrollView {
            VStack(spacing: 24) {
                BalanceElement(accountId: account)
                ListElement(accountId: account)
            }
            .padding()
        }
    }
}
```

## Opciones

Pásalas a `wallet.create('balances', { … })`, o como props de `<Balances>` en React. Las props inyectadas por el elemento padre nunca aparecen aquí.

**accessToken** `string`

Un token con alcance limitado para las lecturas del desglose del saldo y de la liquidación. Una cuenta necesita `company:balance:read`. Si se omite, se usa la sesión del visitante en el mismo origen.

**openHoldingOnSelect** `boolean`

Muestra la página de saldo del activo de esta unidad en lugar del gráfico y la lista cuando se hace clic en una fila. Desactivado por defecto para que un host que enruta con `balanceSelected` no quede tapado por una segunda pantalla. Por defecto es `false`.

## Métodos

Llámalos en el subhandle obtenido de `wallet.create('balances', { … })`.

### `update`

Combina nuevas props y callbacks en el subcontrolador.

**Parámetros**

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

### `destroy`

Destruye el subcontrolador y sus elementos y después libera su ranura exclusiva. Un `create("balances")` posterior empieza de cero.

## Parámetros

**accountId** `String` *required*

La cuenta cuyo dinero lee la vista. Usa un ID de cuenta con el prefijo `biz_`. Un ID de usuario con el prefijo `user_` lee el saldo propio del visitante y necesita autenticación del visitante (`WhopSDK.configureWithOAuth`), no un token de cuenta.

## Estados

Cada vista gestiona sus propios estados, así que ninguna impide que la otra se renderice.

## Información útil

* No comparten estado y se cargan de forma independiente, así que puedes usar uno solo o ambos como se muestra a continuación.
* Consulta los detalles en [`BalanceElement`](https://docs.whop.com/es/elements/latest/wallet/balances-balance#swift) y [`ListElement`](https://docs.whop.com/es/elements/latest/wallet/balances-list#swift); [`ActivityElement`](https://docs.whop.com/es/elements/latest/wallet/activity#swift) lista los movimientos que hay detrás de ellos.

> [!NOTE]
>
> Llama a `WhopSDK.configure(tokenProvider:)` una vez al iniciar. Las vistas esperan al token. Consulta [Primeros pasos](https://docs.whop.com/es/elements/latest/getting-started.md). Aplica un tema con `.whopTheme(_:)`.

## Elementos

Los elementos que monta este subcontrolador. Cada uno tiene su propia página:

> [card] [BalanceElement](https://docs.whop.com/es/elements/latest/wallet/balances-balance.md)
>
> El saldo de una cuenta y un gráfico de cómo ha cambiado. El total y su variación aparecen arriba, el gráfico debajo y los botones del intervalo de tiempo al final. El visitante puede leer puntos individuales del gráfico y cambiar el intervalo de tiempo por sí mismo.

> [card] [BreakdownElement](https://docs.whop.com/es/elements/latest/wallet/balances-breakdown.md)
>
> El total de una moneda dividido en saldos disponibles, pendientes, en reserva y negativos. Las filas con valor cero desaparecen, y la superficie no contiene deliberadamente botones de movimiento de dinero para que el host se encargue de esas acciones.

> [card] [SettlementElement](https://docs.whop.com/es/elements/latest/wallet/balances-settlement.md)
>
> Los detalles del saldo de la cuenta que muestra el panel de Whop: fondos disponibles, fechas de liquidación pendientes, condiciones de la reserva y cualquier saldo negativo. Se abre como un modal de 550px y usa la cuenta, la moneda y la credencial del handle de saldos.

> [card] [ListElement](https://docs.whop.com/es/elements/latest/wallet/balances-list.md)
>
> Los activos que componen el saldo de una cuenta. Cada moneda y token tiene su propia fila, que muestra su nombre y su valor en dólares, de mayor a menor. Las filas pueden informar de cuál pulsó el visitante, para que puedas abrir tu propia pantalla para ella. Cuando `openHoldingOnSelect` está activado, al hacer clic en una fila se muestra la página de saldo de ese activo en lugar del gráfico y la lista de esta unidad.


## Related topics

- [Añadir fondos a tu saldo](https://docs.whop.com/es/developer/platforms/add-funds-to-your-balance.md)
- [SettlementElement](https://docs.whop.com/es/elements/latest/wallet/balances-settlement.md)
- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
