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

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

> [!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 [`Balances`](https://docs.whop.com/es/elements/latest/wallet/balances), en [`Wallet`](https://docs.whop.com/es/elements/latest/wallet/overview). `accountId` y `openHoldingOnSelect` provienen de `Wallet`. Pasa las props y los callbacks a través de las opciones de creación o de las props de React.

Se monta en cualquier lugar de tu jerarquía de vistas. Recibe un `accountId` y carga sus propios datos; pasa también un closure y las filas se vuelven pulsables. La raíz es un `VStack`, por lo que se ajusta a su contenido y ocupa el ancho que le des.

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

Datos de ejemplo. [Abre el Playground](https://docs.whop.com/es/elements/latest/wallet/overview#playground).

[ListElement ejecutándose en un simulador de iPhone](https://app.revyl.ai/embed/f128a268-f5e0-47c1-8919-86e4f04d6876?controls=0)

## Props

**accessToken** `string`

Un token con alcance limitado para la lectura. Una cuenta necesita `company:balance:read`; los activos de un usuario o su lista de cuentas propias necesitan `user:balance:read`. Genéralo en tu servidor con `POST /api/v1/access_tokens`. Sin él, la lectura usa la propia sesión del visitante, que solo funciona en el mismo origen.

**includeOwnedAccounts** `boolean`

Para la cuenta `user_…` de un usuario, lista su saldo personal seguido de cada cuenta propia que devuelve el backend, en lugar de listar los activos dentro de su cuenta personal. Se ignora para una cuenta. Por defecto es `false`.

**showSourceCurrency** `boolean`

Muestra cada fila en la moneda en la que se mantiene (€4.20, 0.00000009 cbBTC) y coloca el valor en dólares debajo. Desactivado por defecto, así que todas las filas están en dólares. Por defecto es `false`.

**showUsdEquivalent** `boolean`

Mantiene el valor en dólares debajo de un activo mostrado en su propia moneda. Solo se aplica cuando `showSourceCurrency` está activado. Por defecto es `true`.

**showPersonalAccount** `boolean`

Mantiene la fila personal cuando `includeOwnedAccounts` está activado. Desactívalo si tu app no tiene ninguna cuenta personal que abrir. Por defecto es `true`.

**maxItems** `number`

Muestra como máximo este número de filas de activos, de mayor a menor. Cuando hay más, la lista incorpora un control Show all balances que despliega el resto en el mismo lugar. Sin él, se listan todos los activos.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onBalanceSelected`

Se hizo clic en una fila de activo, con `includeOwnedAccounts` desactivado. `holding` es `usd` para la fila combinada en dólares; en caso contrario, el símbolo del activo (`cbBTC`, `EUR`), y `kind` te indica cuál de los tres es, para que puedas enrutar sin tener que clasificar los símbolos tú mismo. El elemento nunca navega.

**payload** `object`

**propiedades**

**holding** `string` *required*

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

### `onAccountSelected`

Se hizo clic en una fila de cuenta, con `includeOwnedAccounts` activado. `accountId` es la etiqueta personal `user_…` o una etiqueta `biz_…` de una cuenta propia, y `kind` te permite enrutar sin inspeccionarla. El elemento nunca navega.

**payload** `object`

**propiedades**

**accountId** `string` *required*

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

### `onCreditsSelected`

Se hizo clic en la fila de créditos de Whop. Los créditos solo se pueden gastar en Whop y nunca se pueden retirar, por lo que quedan fuera de todas las filas de activos; el host abre su propia pantalla de créditos. El elemento nunca navega.

### `onLoaderStart`

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de `onReady`.

### `onReady`

Se ejecuta después del primer pintado completo del elemento.

### `onError`

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa `code` para el manejo programático. `sourceKey` identifica una fuente de estado del host que falló.

**e** `object`

**propiedades**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Métodos

Llámalos en el handle que devuelve `create`, o a través de una `ref` de React.

### `mount`

Monta el elemento en `target` y comienza a cargarlo. Los componentes de React se montan solos.

**Parámetros**

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

### `destroy`

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

### `update`

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.

**Parámetros**

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

## Estilos

Aplica estilo a estas partes mediante `appearance.classes`. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.

| Clase | Aplica a |
| - | - |
| `.whop-ActivityRow` | Una fila de actividad del libro contable: su icono, título, marca de tiempo e importe |
| `.whop-ActivitySurface` | El feed de actividad: título, filtros y hasta todas las filas obtenidas |
| `.whop-BalanceBreakdownSurface` | El total del saldo de una moneda, la barra segmentada y las filas de importes |
| `.whop-BalanceRow` | Una fila de saldo: su icono, nombre, valor y chevron |
| `.whop-BalancesSurface` | La lista de saldos: una fila por activo o cuenta |
| `.whop-CashBalanceSurface` | La página de saldo del activo: atrás, título, importe, división, acciones y actividad |
| `.whop-PlatformCreditsRow` | Créditos emitidos por Whop: solo se pueden gastar en Whop y nunca se pueden retirar |

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

En React, pasa `appearance` a `<Wallet>`. Establécelo globalmente con `WhopElements({ appearance })`.

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

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

Se llama con la fila que pulsó el visitante. Si lo omites, las filas se renderizan sin chevrons y pulsarlas no hace nada.

## `WalletBalance`

Lo que devuelve una selección:

* `id: String`: estable por fila
* `symbol: String`: `USD`, `BTC`, …
* `displayName: String`: el nombre que se muestra en la fila
* `amountUsd: Decimal`: el valor de la fila en dólares
* `isCrypto: Bool`: un activo cripto en lugar de fiat

## Estados

Muestra dos filas de marcador de posición mientras se cargan los saldos. Un ID de cuenta que no se puede resolver muestra `Couldn't load this account.` Si falla la propia lectura del saldo, la lista se renderiza vacía en lugar de mostrar un error.

## Información útil

* No se desplaza por sí sola, así que colócala en un `ScrollView` cuando comparta pantalla con otro contenido.
* Se combina con [`BalanceElement`](https://docs.whop.com/es/elements/latest/wallet/balances-balance#swift), que muestra el total de la misma cuenta y cómo ha cambiado.

> [!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(_:)`.


## Related topics

- [Primeros pasos con Elements](https://docs.whop.com/es/elements/latest/getting-started.md)
- [BalanceElement](https://docs.whop.com/es/elements/latest/wallet/balances-balance.md)
- [Habilitar pagos salientes de subcuentas](https://docs.whop.com/es/developer/platforms/render-payout-portal.md)
