Skip to main content
La API de transacciones mejoradas es un producto heredado en modo de mantenimiento. Sigue funcionando y estas páginas continúan disponibles, pero ya no recibe nuevos tipos de analizadores ni nuevas funcionalidades. Su sucesor es Eventos analizados, que decodifica instrucciones mediante el catálogo de IDL y está en beta abierta para los planes de pago. La guía de migración explica el proceso paso a paso. También puedes usar getTransactionsForAddress para consultar el historial de transacciones y completar datos históricos, y la Wallet API para obtener datos de billeteras legibles.

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).
Envía una solicitud 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.
Para desarrollos nuevos, 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.
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=asc para el orden ascendente (las más antiguas primero) o sort-order=desc para 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 limit para 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, como getSignaturesForAddress, 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.
El filtro token-accounts depende del campo owner de los metadatos de saldo de tokens, que no estaba disponible antes del slot 111,491,819 (aproximadamente diciembre de 2022). Las transacciones que involucren cuentas de tokens activas antes de este slot pueden faltar en los resultados de balanceChanged e all. Consulta el tutorial de getTransactionsForAddress para ver una solución alternativa con un ejemplo de código completo.

Filtros

Filtrar por tipo de transacción

Obtén solo tipos específicos de transacciones, como ventas de NFT, transferencias de tokens o intercambios:
Para ver la lista completa de tipos de transacciones compatibles, consulta la referencia de la API de historial de transacciones.

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.
Cuando no se encuentran transacciones coincidentes dentro de la ventana de búsqueda actual, la API devuelve una respuesta de error como esta:
Para continuar, usa la firma del mensaje de error con el parámetro correspondiente (before-signature para el orden descendente o after-signature para el ascendente) en tu siguiente solicitud.
Puntos clave:
  • 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-signature cuando busques en orden descendente (valor predeterminado, las más recientes primero).
  • Usa after-signature cuando 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.
Obtén transacciones dentro de un periodo específico:
Obtén transacciones dentro de un rango de slots específico:
Obtén transacciones en orden ascendente (las más antiguas primero):
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:
Para paginar dentro de un rango de tiempo, conserva los filtros de tiempo en cada solicitud y avanza el cursor 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.