Descripción general
El endpoint de historial de transacciones devuelve el historial de transacciones legible de cualquier dirección de Solana. En lugar de trabajar con datos de instrucciones sin procesar y listas de cuentas, obtienes información estructurada sobre:- Qué ocurrió en la transacción (transferencias, intercambios y actividades con NFT).
- Qué cuentas participaron.
- Cuánto SOL o cuántos tokens se transfirieron.
- Metadatos asociados (direcciones de acuñación de tokens, nombres de tokens, símbolos de tokens y más).
GET a /v0/addresses/{address}/transactions. Internamente, este endpoint utiliza el método RPC getTransactionsForAddress.
Cuándo usarlo
- Muestras a los usuarios el historial de transacciones de una dirección (billeteras, rastreadores de portafolios o exploradores).
- Quieres un historial preanalizado y legible sin escribir tu propio decodificador.
- Necesitas filtrar el historial por tipo de transacción, rango de tiempo o rango de slots.
- Necesitas el historial completo de tokens de una billetera, incluidas las cuentas de tokens asociadas (ATA); consulta la sección siguiente.
getTransactionsForAddress es la opción moderna y nativa de Helius, con filtrado del lado del servidor y búsquedas de cuentas de tokens.
Inicio rápido
1
Get your API key
Regístrate en dashboard.helius.dev y copia tu clave de API.
2
GET the address transactions endpoint
Obtén el historial de transacciones de cualquier dirección de Solana.
- JavaScript
- Python
3
Filter and paginate
Limita los resultados con los filtros
type, de tiempo y de slots que aparecen a continuación. Luego, recorre por páginas las direcciones de gran volumen mediante cursores de firmas.Compatibilidad con redes
Parámetros de la solicitud
Filtrado por tiempo
Filtrado por slots
Notas sobre el filtrado:
- Los parámetros de tiempo usan marcas de tiempo Unix (segundos desde el inicio de la época); los parámetros de slots usan números de slot de Solana.
- No puedes combinar filtros de tiempo y de slots en la misma solicitud.
- Usa
sort-order=ascpara el orden ascendente (las más antiguas primero) osort-order=descpara el orden descendente (las más recientes primero). - Usa filtros de tiempo o de slots para reducir el espacio de búsqueda cuando conozcas el periodo aproximado. Combínalos con
limitpara controlar el tamaño de la página.
Cuentas de tokens asociadas
En Solana, una billetera no almacena tokens directamente. En su lugar, la billetera posee cuentas de tokens, y esas cuentas almacenan los tokens. Cuando alguien te envía USDC, los fondos llegan a tu cuenta de tokens USDC en lugar de a la dirección principal de tu billetera. Este endpoint es único porque puede consultar el historial completo de tokens de una billetera, incluidas las cuentas de tokens asociadas (ATA). Los métodos RPC nativos, comogetSignaturesForAddress, no incluyen las ATA.
El filtro token-accounts controla este comportamiento:
none(valor predeterminado): solo devuelve transacciones que hacen referencia directa a la dirección de la billetera. Úsalo si solo te interesan las interacciones directas con la billetera.balanceChanged(recomendado): devuelve transacciones que hacen referencia a la dirección de la billetera o modifican el saldo de una cuenta de tokens propiedad de la billetera. Esto excluye el spam y las operaciones no relacionadas, como el cobro de comisiones o las delegaciones, para ofrecerte una vista clara de la actividad relevante de la billetera.all: devuelve todas las transacciones que hacen referencia a la dirección de la billetera o a cualquier cuenta de tokens propiedad de la billetera.
Filtros
Filtrar por tipo de transacción
Obtén solo tipos específicos de transacciones, como ventas de NFT, transferencias de tokens o intercambios:- NFT Sales
- Token Transfers
- Swaps
Filtrado de tipos en tiempo de ejecución
El filtrado por tipo se realiza en tiempo de ejecución: la API busca transacciones de forma secuencial hasta encontrar al menos 50 elementos coincidentes. Si no encuentra ninguna coincidencia dentro de la ventana de búsqueda, devuelve un error con una firma para continuar la búsqueda. Este es el comportamiento esperado, no un fallo.
before-signature para el orden descendente o after-signature para el ascendente) en tu siguiente solicitud.
Continuation loop for type filters (full example)
Continuation loop for type filters (full example)
- La API busca en un máximo de 50 transacciones a la vez cuando usas filtros de tipo.
- Si no se encuentra ninguna coincidencia, usa la firma del mensaje de error para continuar la búsqueda.
- Usa
before-signaturecuando busques en orden descendente (valor predeterminado, las más recientes primero). - Usa
after-signaturecuando busques en orden ascendente (las más antiguas primero); es obligatorio para las búsquedas cronológicas. - Implementa un límite máximo de reintentos para evitar bucles infinitos.
Ejemplos
Los siguientes escenarios abarcan rangos de tiempo y de slots, ordenamiento, ATA y filtros combinados.Filter by time range
Filter by time range
Obtén transacciones dentro de un periodo específico:
- Last 24 Hours
- Specific Date Range
Filter by slot range
Filter by slot range
Obtén transacciones dentro de un rango de slots específico:
Change sort order
Change sort order
Obtén transacciones en orden ascendente (las más antiguas primero):
Combine multiple filters
Combine multiple filters
Combina el filtrado por tipo con un rango de tiempo y un orden personalizado:
Paginación
Para las direcciones de gran volumen, recorre los resultados por páginas usando como cursor la última firma de cada lote:before-signature en cada iteración:
Próximos pasos
getTransactionsForAddress
El reemplazo moderno y nativo de Helius para consultar el historial de transacciones y completar datos históricos.
Wallet API
Endpoints REST para obtener datos de billeteras legibles: saldos, historial y transferencias.
Parse Transactions
Analiza una o más firmas de transacciones y conviértelas en datos legibles.
Getting Data overview
Compara todas las opciones de Helius para consultar datos de Solana.