> ## 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 historial de la billetera
> Recupera el historial completo de transacciones de una billetera de Solana con paginación.
Cada solicitud cuesta **100 créditos**.
## Parámetros de la solicitud
Dirección de la billetera de Solana (codificada en base58)
Número máximo de transacciones por solicitud
Obtén las transacciones anteriores a esta firma (usa `pagination.nextCursor` de la respuesta anterior)
Obtén las transacciones posteriores a esta firma (para la paginación en orden ascendente)
Filtra por tipo de transacción. Tipos disponibles: SWAP, TRANSFER, NFT\_SALE, NFT\_BID, NFT\_LISTING,
NFT\_MINT, NFT\_CANCEL\_LISTING, TOKEN\_MINT, BURN, COMPRESSED\_NFT\_MINT, COMPRESSED\_NFT\_TRANSFER,
COMPRESSED\_NFT\_BURN, CREATE\_STORE, WHITELIST\_CREATOR, ADD\_TO\_WHITELIST, REMOVE\_FROM\_WHITELIST,
AUCTION\_MANAGER\_CLAIM\_BID, EMPTY\_PAYMENT\_ACCOUNT, UPDATE\_PRIMARY\_SALE\_METADATA, ADD\_TOKEN\_TO\_VAULT,
ACTIVATE\_VAULT, INIT\_VAULT, INIT\_BANK, INIT\_STAKE, MERGE\_STAKE, SPLIT\_STAKE, CREATE\_AUCTION\_MANAGER,
START\_AUCTION, CREATE\_AUCTION\_MANAGER\_V2, UPDATE\_EXTERNAL\_PRICE\_ACCOUNT, EXECUTE\_TRANSACTION
* `SWAP`
* `TRANSFER`
* `NFT_SALE`
* `NFT_BID`
* `NFT_LISTING`
* `NFT_MINT`
* `NFT_CANCEL_LISTING`
* `TOKEN_MINT`
* `BURN`
* `COMPRESSED_NFT_MINT`
* `COMPRESSED_NFT_TRANSFER`
* `COMPRESSED_NFT_BURN`
* `CREATE_STORE`
* `WHITELIST_CREATOR`
* `ADD_TO_WHITELIST`
* `REMOVE_FROM_WHITELIST`
* `AUCTION_MANAGER_CLAIM_BID`
* `EMPTY_PAYMENT_ACCOUNT`
* `UPDATE_PRIMARY_SALE_METADATA`
* `ADD_TOKEN_TO_VAULT`
* `ACTIVATE_VAULT`
* `INIT_VAULT`
* `INIT_BANK`
* `INIT_STAKE`
* `MERGE_STAKE`
* `SPLIT_STAKE`
* `CREATE_AUCTION_MANAGER`
* `START_AUCTION`
* `CREATE_AUCTION_MANAGER_V2`
* `UPDATE_EXTERNAL_PRICE_ACCOUNT`
* `EXECUTE_TRANSACTION`
Filtra las transacciones que involucren cuentas de tokens propiedad de la billetera.
* `balanceChanged` (recomendado): Incluye las transacciones que cambiaron los saldos de tokens y filtra el spam
* `none`: Solo transacciones que hacen referencia directa a la billetera
* `all`: Todas las transacciones, incluidas las cuentas de tokens (puede incluir spam)
* `none`
* `balanceChanged`
* `all`
## OpenAPI
````yaml es/openapi/wallet-api/openapi.yaml GET /v1/wallet/{wallet}/history
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}/history:
get:
tags:
- Historial
summary: Obtén el historial de transacciones
description: >
Recupera el historial de transacciones de una billetera mediante la API
Enhanced Transactions.
Devuelve transacciones analizadas y legibles, con los cambios de saldo
de cada transacción.
**La paginación es manual**: la API devuelve hasta 100 transacciones por
solicitud.
Devuelve las transacciones en orden cronológico inverso (las más
recientes primero).
**Cuentas de tokens asociadas (ATA):** El parámetro `tokenAccounts`
controla si se incluyen las transacciones
que involucran cuentas de tokens propiedad de la billetera:
- `balanceChanged` (recomendado): incluye transacciones que cambiaron
los saldos de las cuentas de tokens y filtra el spam
- `none`: solo interacciones directas de la billetera
- `all`: todas las transacciones de cuentas de tokens, incluido el spam
**Paginación:** Usa el parámetro `before` con `pagination.nextCursor`
para obtener la página siguiente.
La respuesta incluye `pagination.hasMore` para indicar si hay más
resultados disponibles.
Cada solicitud realiza una sola llamada a la API y cuesta 100 créditos.
operationId: getWalletHistory
parameters:
- $ref: '#/components/parameters/WalletAddress'
- name: limit
in: query
description: Cantidad máxima de transacciones por solicitud
schema:
type: integer
minimum: 1
maximum: 100
default: 100
example: 100
- name: before
in: query
description: >-
Obtén transacciones anteriores a esta firma (usa
`pagination.nextCursor` de la respuesta anterior)
schema:
type: string
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
- name: after
in: query
description: >-
Obtén transacciones posteriores a esta firma (para la paginación en
orden ascendente)
schema:
type: string
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
- name: type
in: query
description: >
Filtra por tipo de transacción. Tipos disponibles: SWAP, TRANSFER,
NFT_SALE, NFT_BID, NFT_LISTING,
NFT_MINT, NFT_CANCEL_LISTING, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT,
COMPRESSED_NFT_TRANSFER,
COMPRESSED_NFT_BURN, CREATE_STORE, WHITELIST_CREATOR,
ADD_TO_WHITELIST, REMOVE_FROM_WHITELIST,
AUCTION_MANAGER_CLAIM_BID, EMPTY_PAYMENT_ACCOUNT,
UPDATE_PRIMARY_SALE_METADATA, ADD_TOKEN_TO_VAULT,
ACTIVATE_VAULT, INIT_VAULT, INIT_BANK, INIT_STAKE, MERGE_STAKE,
SPLIT_STAKE, CREATE_AUCTION_MANAGER,
START_AUCTION, CREATE_AUCTION_MANAGER_V2,
UPDATE_EXTERNAL_PRICE_ACCOUNT, EXECUTE_TRANSACTION
schema:
type: string
enum:
- SWAP
- TRANSFER
- NFT_SALE
- NFT_BID
- NFT_LISTING
- NFT_MINT
- NFT_CANCEL_LISTING
- TOKEN_MINT
- BURN
- COMPRESSED_NFT_MINT
- COMPRESSED_NFT_TRANSFER
- COMPRESSED_NFT_BURN
- CREATE_STORE
- WHITELIST_CREATOR
- ADD_TO_WHITELIST
- REMOVE_FROM_WHITELIST
- AUCTION_MANAGER_CLAIM_BID
- EMPTY_PAYMENT_ACCOUNT
- UPDATE_PRIMARY_SALE_METADATA
- ADD_TOKEN_TO_VAULT
- ACTIVATE_VAULT
- INIT_VAULT
- INIT_BANK
- INIT_STAKE
- MERGE_STAKE
- SPLIT_STAKE
- CREATE_AUCTION_MANAGER
- START_AUCTION
- CREATE_AUCTION_MANAGER_V2
- UPDATE_EXTERNAL_PRICE_ACCOUNT
- EXECUTE_TRANSACTION
example: SWAP
- name: tokenAccounts
in: query
description: >
Filtra las transacciones que involucran cuentas de tokens propiedad
de la billetera.
- `balanceChanged` (recomendado): incluye transacciones que
cambiaron los saldos de tokens y filtra el spam
- `none`: solo transacciones que hacen referencia directa a la
billetera
- `all`: todas las transacciones, incluidas las cuentas de tokens
(puede incluir spam)
schema:
type: string
enum:
- none
- balanceChanged
- all
default: balanceChanged
example: balanceChanged
responses:
'200':
description: El historial de transacciones se recuperó correctamente
content:
application/json:
schema:
$ref: '#/components/schemas/HistoryResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
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:
HistoryResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/HistoryTransaction'
pagination:
$ref: '#/components/schemas/Pagination'
required:
- data
- pagination
HistoryTransaction:
type: object
properties:
signature:
type: string
description: Firma de la transacción
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
timestamp:
type: integer
nullable: true
description: Marca de tiempo Unix en segundos
example: 1704067200
slot:
type: integer
description: Número de slot
example: 250000000
fee:
type: number
description: Comisión de la transacción en SOL
example: 0.000005
feePayer:
type: string
description: Dirección que pagó la comisión de la transacción
example: GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz
error:
type: string
nullable: true
description: Mensaje de error si la transacción falló
example: null
balanceChanges:
type: array
items:
$ref: '#/components/schemas/BalanceChange'
description: Todos los cambios de saldo de esta transacción
required:
- signature
- slot
- fee
- feePayer
- balanceChanges
Pagination:
type: object
properties:
hasMore:
type: boolean
description: Indica si hay más resultados disponibles
example: true
nextCursor:
type: string
nullable: true
description: Cursor para obtener la página siguiente de resultados
example: 5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE
required:
- hasMore
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
BalanceChange:
type: object
properties:
mint:
type: string
description: Dirección de acuñación del token (o 'SOL' para el token nativo)
example: So11111111111111111111111111111111111111112
amount:
type: number
description: >-
Cantidad del cambio (positiva para un aumento y negativa para una
disminución)
example: -0.05
decimals:
type: integer
description: Decimales del token
example: 9
required:
- mint
- amount
- decimals
responses:
BadRequest:
description: Parámetros de solicitud no válidos
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Dirección de billetera no válida
code: 400
details: '''invalid-address'' no es una dirección de Solana válida'
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
````