> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la API de billeteras (Beta)

> Consulta datos de billeteras de Solana con la API de billeteras. Obtén saldos, historial de transacciones, transferencias, información de identidad y fuentes de fondos en una sola solicitud.

<Note>
  La API de billeteras está en Beta. Los endpoints y los formatos de respuesta pueden cambiar.
</Note>

## ¿Qué es la API de billeteras?

La API de billeteras proporciona endpoints REST de alto nivel para consultar todos los datos de una billetera de Solana: saldos, historial de transacciones, transferencias de tokens, resolución de identidad, saldos históricos y fuentes de fondos. En lugar de realizar varias llamadas RPC y analizar datos sin procesar de la blockchain, obtienes información estructurada y legible con precios en USD en una sola solicitud.

Está diseñada para billeteras, rastreadores de portafolios, exploradores, procesadores de pagos, herramientas fiscales y sistemas de cumplimiento y AML. Todos los endpoints comparten la URL base `https://api.helius.xyz` y devuelven los importes en unidades legibles (no es necesario convertir lamports).

## ¿Por qué usar Helius para los datos de billeteras?

<CardGroup cols={2}>
  <Card title="One REST call" icon="bolt">
    Saldos, historial y transferencias estructurados sin tener que combinar respuestas
    RPC sin procesar.
  </Card>

  <Card title="USD pricing built in" icon="dollar-sign">
    Los saldos de tokens incluyen valores en USD y totales del portafolio, obtenidos de DAS.
  </Card>

  <Card title="Identity resolution" icon="address-card">
    Más de 32,500 cuentas y programas etiquetados, además de más de 21.5 millones de etiquetas categóricas para
    exchanges, protocolos e instituciones.
  </Card>

  <Card title="Human-readable output" icon="book-open">
    Datos claros con decimales ajustados, en lugar de lamports e instrucciones sin procesar.
  </Card>
</CardGroup>

## Endpoints principales

<CardGroup cols={2}>
  <Card title="Wallet Identity" icon="address-card" href="/docs/es/wallet-api/identity">
    Identifica billeteras conocidas por dirección o dominio SNS/ANS: exchanges, protocolos e
    instituciones.
  </Card>

  <Card title="Wallet Balances" icon="scale-balanced" href="/docs/es/wallet-api/balances">
    Todos los saldos de tokens y NFT con valores en USD, logotipos y metadatos.
  </Card>

  <Card title="Historical Balance" icon="clock" href="/docs/es/wallet-api/balance-at">
    El saldo de un token o de SOL en una marca de tiempo, fecha y hora o slot del pasado.
  </Card>

  <Card title="Wallet History" icon="clock-rotate-left" href="/docs/es/wallet-api/history">
    Historial completo de transacciones con los cambios de saldo de cada transacción.
  </Card>

  <Card title="Token Transfers" icon="arrow-right-arrow-left" href="/docs/es/wallet-api/transfers">
    Todas las transferencias entrantes y salientes con información del remitente y del destinatario.
  </Card>

  <Card title="Funding Source" icon="money-bill-transfer" href="/docs/es/wallet-api/funded-by">
    La fuente de fondos original de una billetera, rastreada hasta su primera recepción de SOL.
  </Card>
</CardGroup>

## ¿Qué endpoint debo usar?

| Necesitas                                                             | Usa                                          | Devuelve                                                                  |
| --------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------- |
| Saber a quién pertenece una billetera (exchange, protocolo, etiqueta) | [Identidad](/docs/es/wallet-api/identity)         | Nombre, categoría y etiquetas de direcciones conocidas                    |
| El portafolio actual de una billetera                                 | [Saldos](/docs/es/wallet-api/balances)            | Todos los tokens y NFT con sus valores en USD                             |
| Un saldo en un momento del pasado                                     | [Saldo histórico](/docs/es/wallet-api/balance-at) | El saldo de un token o de SOL en una marca de tiempo, fecha y hora o slot |
| La actividad completa de transacciones                                | [Historial](/docs/es/wallet-api/history)          | Transacciones analizadas con cambios de saldo por transacción             |
| Solo transferencias enviadas o recibidas                              | [Transferencias](/docs/es/wallet-api/transfers)   | Vista por transferencia con contraparte y dirección                       |
| El origen de los fondos de una billetera                              | [Fuente de fondos](/docs/es/wallet-api/funded-by) | Primera transferencia entrante de SOL y su remitente                      |

Referencia rápida de las rutas subyacentes (URL base `https://api.helius.xyz`):

* `GET /v1/wallet/{wallet}/identity` — obtén la identidad de una billetera por dirección o dominio SNS/ANS
* `POST /v1/wallet/batch-identity` — consulta identidades por lotes (hasta 100 direcciones o dominios)
* `GET /v1/wallet/{wallet}/balances` — obtén todos los saldos de tokens y NFT
* `GET /v1/wallet/{wallet}/balance-at` — obtén el saldo de un token o de SOL en una marca de tiempo, fecha y hora o slot del pasado
* `GET /v1/wallet/{wallet}/history` — obtén el historial de transacciones con cambios de saldo
* `GET /v1/wallet/{wallet}/transfers` — obtén toda la actividad de transferencias de tokens
* `GET /v1/wallet/{wallet}/funded-by` — encuentra la fuente de fondos original

## Autenticación

Todas las solicitudes a la API de billeteras requieren una clave de API. Puedes pasarla como parámetro de consulta o como encabezado:

<Tabs>
  <Tab title="Query Parameter">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"
    ```
  </Tab>

  <Tab title="Header">
    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/{wallet}/balances" \
      -H "X-Api-Key: YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## Requisitos del plan

Los endpoints de identidad y fuente de fondos requieren un plan de pago. En el plan gratuito, las solicitudes a estos endpoints devuelven `403 Forbidden`. Todos los demás endpoints están disponibles en todos los planes, incluido el gratuito.

| Endpoint                             | Plan gratuito               |
| ------------------------------------ | --------------------------- |
| `GET /v1/wallet/{wallet}/identity`   | `403` — solo planes de pago |
| `POST /v1/wallet/batch-identity`     | `403` — solo planes de pago |
| `GET /v1/wallet/{wallet}/funded-by`  | `403` — solo planes de pago |
| `GET /v1/wallet/{wallet}/balances`   | Disponible                  |
| `GET /v1/wallet/{wallet}/balance-at` | Disponible                  |
| `GET /v1/wallet/{wallet}/history`    | Disponible                  |
| `GET /v1/wallet/{wallet}/transfers`  | Disponible                  |

Cualquier nivel de pago desbloquea los endpoints restringidos: Developer, Business y todos los niveles superiores (como Enterprise). Para habilitar las consultas de identidad y fuente de fondos, [mejora tu plan en el panel](https://dashboard.helius.dev).

## Importes y unidades

La API de billeteras es una abstracción de alto nivel de los datos sin procesar de Solana. Todos los campos `amount` de las respuestas son **legibles** — ya están divididos por el valor `decimals` del token — para que puedas mostrarlos directamente sin realizar conversiones. Las llamadas RPC de Solana sin procesar devuelven valores en lamports (la unidad más pequeña, 10⁻⁹ SOL); la API de billeteras no. `"amount": 1.5` significa 1.5 SOL, no 1.5 lamports.

Cuando se requiere aritmética exacta, algunos endpoints también exponen `amountRaw`: el mismo valor como entero sin procesar serializado como cadena para evitar la pérdida de precisión de punto flotante. La fórmula de conversión es:

`amount = parseInt(amountRaw) / 10**decimals`

| Endpoint                         | `amount` legible                     | Cadena `amountRaw` sin procesar |
| -------------------------------- | ------------------------------------ | ------------------------------- |
| **Saldos**                       | Campo `balance`                      | No disponible                   |
| **Saldo histórico**              | Campo `balance` (**cadena** decimal) | Campo `balanceRaw`              |
| **Fuente de fondos**             | Campo `amount`                       | Campo `amountRaw`               |
| **Transferencias**               | Campo `amount`                       | Campo `amountRaw`               |
| **Historial** (`balanceChanges`) | Campo `amount`                       | No disponible                   |

Usa `amount` para mostrar valores. Usa `amountRaw` cuando pases valores a instrucciones en cadena o a otros sistemas que requieran aritmética exacta con enteros.

## Comienza

<Steps>
  <Step title="Get your API key">
    Regístrate en [dashboard.helius.dev](https://dashboard.helius.dev) para obtener tu clave de API.
  </Step>

  <Step title="Choose your endpoint">
    Usa la tabla anterior para elegir el endpoint que corresponda a tu caso de uso.
  </Step>

  <Step title="Make your first request">
    Comienza con una consulta de saldo sencilla:

    ```bash theme={"system"}
    curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
    ```
  </Step>

  <Step title="Handle the response">
    Analiza la respuesta JSON y muestra los datos en tu aplicación.
  </Step>
</Steps>

## Próximos pasos

<CardGroup cols={3}>
  <Card title="Getting Data" icon="database" href="/docs/es/getting-data">
    Explora todas las formas de consultar datos de Solana en Helius.
  </Card>

  <Card title="API Reference" icon="code" href="/docs/es/api-reference/wallet-api">
    Esquemas de solicitudes y respuestas para todos los endpoints de la API de billeteras.
  </Card>

  <Card title="Contact Support" icon="headset" href="/docs/es/support/contact-support">
    Obtén ayuda mediante Discord, chat o correo electrónico.
  </Card>
</CardGroup>