> ## 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.
# Obtener el saldo histórico de un token
> Obtén el saldo de un token específico o de SOL nativo de una billetera en una marca de tiempo, fecha y hora o slot pasados.
Cada solicitud cuesta **100 créditos**.
## Parámetros de la solicitud
Dirección de la billetera de Solana (codificada en base58)
Dirección de acuñación del token. Para SOL nativo, usa `So11111111111111111111111111111111111111111`.
Marca de tiempo Unix en **segundos**. Devuelve el saldo correspondiente a este momento. Proporciona exactamente uno de los siguientes valores: `time`, `datetime` o `slot`.
Cadena de fecha y hora. Formatos aceptados: `2025-01-10` (medianoche UTC), `2025-01-10 19:20:00`,
`2025-01-10T19:20:00` (segundos opcionales) o con una zona horaria explícita
(`2025-01-10T19:20:00Z`, `...+02:00`). **Se interpreta como UTC, a menos que se incluya una zona
horaria explícita.** Proporciona exactamente uno de los siguientes valores: `time`, `datetime` o `slot`.
Número de slot. Devuelve el saldo correspondiente a este slot. Es exacto y determinista. Proporciona exactamente uno de los siguientes valores: `time`, `datetime` o `slot`.
## OpenAPI
````yaml es/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/balance-at
openapi: 3.0.3
info:
title: API de billeteras
description: >
Una API REST de alto rendimiento para consultar datos de billeteras de
Solana, incluidos saldos, historial de transacciones, transferencias e
información de identidad.
## Autenticación
Todas las solicitudes requieren una clave de API enviada de una de estas
formas:
- Parámetro de consulta: `?api-key=YOUR_API_KEY`
- Encabezado: `X-Api-Key: YOUR_API_KEY`
version: 1.0.0
contact:
name: Soporte de API
url: https://helius.dev
servers:
- url: https://api.helius.xyz
description: Servidor de producción
security:
- ApiKeyQuery: []
- ApiKeyHeader: []
tags:
- name: Identidad
description: Busca identidades de billeteras y direcciones conocidas
- name: Saldos
description: Consulta saldos de tokens y NFT
- name: Historial
description: Historial de transacciones y cambios de saldo
- name: Transferencias
description: Actividad de transferencia de tokens
- name: Financiamiento
description: Información de financiamiento de billeteras
paths:
/v1/wallet/{wallet}/balance-at:
get:
tags:
- Saldos
summary: Obtén el saldo histórico
description: >
Recupera el saldo de una billetera para un token específico (o SOL
nativo) en un momento pasado,
especificado como una marca de tiempo Unix, una cadena de fecha y hora o
un número de slot.
El saldo se obtiene de la transacción más reciente de la billetera
relacionada con el token **en el momento
solicitado o antes**: su saldo posterior a la transacción, que por
definición se mantuvo
hasta la siguiente transacción de la billetera. Es un valor exacto, no
una estimación.
Debes proporcionar **exactamente uno** de `time`, `datetime` o `slot`.
Los valores de `datetime`
sin una zona horaria explícita se interpretan como **UTC**. Para obtener
resultados exactos y deterministas,
usa `slot`; las horas de bloque informadas por los validadores pueden
variar algunos segundos.
Para SOL nativo, pasa la pseudoacuñación
`So11111111111111111111111111111111111111111` como `mint`.
Una billetera sin actividad coincidente en el momento solicitado o antes
**no** genera un error:
el endpoint devuelve `200` con `balance: "0"` y `asOf: null`.
`balance` y `balanceRaw` se devuelven como **cadenas** para evitar
perder precisión con valores grandes.
operationId: getWalletBalanceAt
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: mint
in: query
required: true
description: >-
Dirección de acuñación del token. Para SOL nativo, usa
`So11111111111111111111111111111111111111111`.
schema:
type: string
default: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
- name: time
in: query
description: >-
Marca de tiempo Unix en **segundos**. Devuelve el saldo en este
momento. Proporciona exactamente uno de `time`, `datetime` o `slot`.
schema:
type: integer
default: 1750000000
minimum: 0
example: 1736536800
- name: datetime
in: query
description: >
Cadena de fecha y hora. Formatos aceptados: `2025-01-10` (medianoche
UTC), `2025-01-10 19:20:00`,
`2025-01-10T19:20:00` (los segundos son opcionales) o con una zona
horaria explícita
(`2025-01-10T19:20:00Z`, `...+02:00`). **Se interpreta como UTC
salvo que incluyas una
zona horaria explícita.** Proporciona exactamente uno de `time`,
`datetime` o `slot`.
schema:
type: string
example: '2025-01-10 19:20:00'
- name: slot
in: query
description: >-
Número de slot. Devuelve el saldo en este slot. Es exacto y
determinista. Proporciona exactamente uno de `time`, `datetime` o
`slot`.
schema:
type: integer
minimum: 0
example: 313000000
responses:
'200':
description: El saldo histórico se recuperó correctamente
content:
application/json:
schema:
$ref: '#/components/schemas/BalanceAtResponse'
'400':
description: >-
Falta `mint`; acuñación no válida; ninguno o más de uno entre
`time`/`datetime`/`slot`; `time`/`slot` no entero; o `datetime` no
analizable
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Debes proporcionar exactamente uno de time, datetime o slot
code: 400
'401':
$ref: '#/components/responses/Unauthorized'
'404':
description: La dirección de billetera en la ruta no es válida
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
'502':
description: >-
Error o tiempo de espera agotado del RPC ascendente. Se puede
reintentar con espera exponencial.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: UPSTREAM_ERROR
code: 502
details: La solicitud RPC ascendente falló. Vuelve a intentarlo.
components:
parameters:
WalletAddress:
name: wallet
in: path
required: true
description: Dirección de billetera de Solana (codificada en base58)
schema:
type: string
pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
default: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
schemas:
BalanceAtResponse:
type: object
properties:
wallet:
type: string
description: Repetición de la dirección de billetera consultada
example: 5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9
mint:
type: string
description: >-
Repetición de la acuñación consultada (la pseudoacuñación de SOL
cuando es nativo)
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
isNative:
type: boolean
description: Indica si el resultado corresponde a SOL nativo
example: false
balance:
type: string
description: >-
Cantidad legible como **cadena** decimal (no como número, para que
los saldos grandes no pierdan precisión). Se eliminan los ceros
finales.
example: '284961463.392936'
balanceRaw:
type: string
description: >-
Cantidad exacta en la unidad más pequeña (lamports para SOL), como
cadena
example: '284961463392936'
decimals:
type: integer
description: Decimales del token (9 para SOL)
example: 6
requested:
type: object
description: >-
Repetición de la consulta. Cuando se usa `datetime`, `time` también
se completa con los segundos de época resueltos para mostrar la
interpretación UTC.
properties:
time:
type: integer
nullable: true
description: >-
Hora solicitada en segundos de época (también se establece
cuando se usa `datetime`)
example: 1736536800
slot:
type: integer
nullable: true
description: Slot solicitado, cuando se usó `slot`
example: null
datetime:
type: string
nullable: true
description: La cadena de fecha y hora original, cuando se usó `datetime`
example: null
required:
- time
- slot
- datetime
asOf:
type: object
nullable: true
description: >-
La transacción de la que se obtuvo el saldo. **Es `null` cuando la
billetera no tenía ninguna transacción coincidente en el momento
solicitado o antes**; esto significa que el saldo es realmente `0`
(la billetera todavía no poseía el token), no que haya ocurrido un
error.
properties:
slot:
type: integer
description: Slot de la transacción
example: 313000000
blockTime:
type: integer
nullable: true
description: >-
Hora de bloque de la transacción en segundos Unix (puede ser
null)
example: 1736536794
signature:
type: string
description: Firma de la transacción
example: 5Cyy7Mh9nVgFq3T8wJp2sKxR4dE6bA1uZoNcLrXmYqUpon
required:
- slot
- signature
required:
- wallet
- mint
- isNative
- balance
- balanceRaw
- decimals
- requested
- asOf
Error:
type: object
properties:
error:
type: string
description: Mensaje de error
example: Dirección de billetera no válida
code:
type: integer
description: Código de estado HTTP
example: 400
details:
type: string
description: Detalles adicionales del error
example: '''invalid-address'' no es una dirección de Solana válida'
required:
- error
- code
responses:
Unauthorized:
description: Falta la clave de API o no es válida
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: >-
Se requiere una clave de API. Envíala mediante ?api-key=xxx o el
encabezado X-Api-Key
code: 401
RateLimited:
description: Se superó el límite de solicitudes.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: RATE_LIMIT_EXCEEDED
code: 429
details: Demasiadas solicitudes. Vuelve a intentarlo después de 2 segundos.
InternalError:
description: >-
Error transitorio del servidor. Se puede reintentar con espera
exponencial.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: INTERNAL_ERROR
code: 500
details: Ocurrió un error inesperado. Vuelve a intentarlo.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: Clave de API enviada como parámetro de consulta
ApiKeyHeader:
type: apiKey
in: header
name: X-Api-Key
description: Clave de API enviada en el encabezado de la solicitud
````