> ## 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.
# getTransactionsForAddress
> getTransactionsForAddress devuelve el historial completo de transacciones de Solana de una dirección en una sola llamada: filtros por tiempo, slot y estado, ordenamiento y paginación por conjunto de claves.
## Parámetros de la solicitud
Dirección de una cuenta de Solana cuyo historial de transacciones se recuperará (billetera, token, programa, NFT, etc.).
Nivel de detalle de las transacciones que se devolverá.
* `signatures`
* `full`
Orden de las transacciones devueltas.
* `asc`
* `desc`
Nivel de compromiso de la solicitud. No se admite el nivel de compromiso `processed`.
* `confirmed`
* `finalized`
Slot de contexto mínimo que se usará para la solicitud (opcional).
Número máximo de transacciones por solicitud. Usa de 1 a 1000 para transactionDetails:"signatures" y de 1 a 1000 para transactionDetails:"full".
Token de paginación de la respuesta anterior para obtener la siguiente página de resultados (formato "slot:position").
Formato de codificación de los datos de la transacción (solo se aplica cuando transactionDetails=full).
* `json`
* `jsonParsed`
* `base58`
* `base64`
Versión máxima de transacción que se devolverá (solo se aplica cuando transactionDetails=full). Establécela en 1 para recibir transacciones heredadas, v0 y v1.
Filtros avanzados para restringir los resultados de las transacciones.
Filtra por número de slot.
Mayor o igual que el número de slot.
Mayor que el número de slot.
Menor o igual que el número de slot.
Menor que el número de slot.
Filtra por marca de tiempo del bloque (marca de tiempo Unix).
Mayor o igual que la marca de tiempo.
Mayor que la marca de tiempo.
Menor o igual que la marca de tiempo.
Menor que la marca de tiempo.
Igual que la marca de tiempo.
Filtra por firma de la transacción.
Obtén las transacciones cuyas firmas sean mayores o iguales que este valor.
Obtén las transacciones posteriores a esta firma.
Obtén las transacciones cuyas firmas sean menores o iguales que este valor.
Obtén las transacciones anteriores a esta firma.
Filtra por estado de la transacción.
* `succeeded`
* `failed`
* `any`
Filtra las transacciones de cuentas de token relacionadas. Controla si se incluyen las transacciones que involucran cuentas de token pertenecientes a la dirección.
* `none`
* `balanceChanged`
* `all`
Restringe los resultados a las transacciones en las que la dirección consultada participó en una transferencia de tokens que coincide con criterios específicos. Todos los campos son opcionales y se combinan con la semántica AND.
Dirección de la contraparte. Coincide con transferencias cuya otra parte sea esta dirección.
Dirección de la transferencia con respecto a la dirección consultada.
* `in`
* `out`
* `any`
Acuñación del token por la que se filtrará.
Filtro por intervalo del importe bruto en cadena. Todos los campos son opcionales y se pueden combinar.
## OpenAPI
````yaml es/openapi/rpc-http/getTransactionsForAddress.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API avanzada para el historial de transacciones de Solana con potentes
funciones de filtrado, ordenamiento y paginación para recuperar datos
completos de transacciones de cualquier dirección.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getTransactionsForAddress
description: >
API mejorada para el historial de transacciones que ofrece potentes
funciones de filtrado, ordenamiento y paginación
para recuperar datos de transacciones asociados con cualquier dirección
de Solana. Este método avanzado supera las
limitaciones de getSignaturesForAddress al ofrecer:
- Ordenamiento bidireccional (orden cronológico ascendente/descendente)
- Filtrado avanzado por slot, tiempo, firma y estado de la transacción
- Compatibilidad con cuentas de tokens (incluye transacciones de cuentas
de tokens asociadas)
- Filtrado de transferencias de tokens por contraparte, dirección,
acuñación e importe sin procesar
- Paginación eficiente basada en claves mediante claves basadas en slots
- Opción para devolver todos los detalles de la transacción o solo las
firmas
- Compatibilidad con consultas por intervalo de tiempo y filtrado por
estado
Ideal para crear historiales completos de billeteras, paneles de
análisis, registros de auditoría
y cualquier aplicación que requiera un análisis detallado de
transacciones con un control preciso sobre la recuperación de datos.
operationId: getTransactionsForAddress
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
example: '2.0'
description: La versión del protocolo JSON-RPC.
default: '2.0'
id:
type: string
example: '1'
description: Un identificador único para la solicitud.
default: '1'
method:
type: string
enum:
- getTransactionsForAddress
example: getTransactionsForAddress
description: El nombre del método RPC que se invocará.
default: getTransactionsForAddress
params:
type: array
description: >-
Arreglo que contiene la dirección de cuenta requerida y un
objeto de configuración opcional.
minItems: 1
maxItems: 2
default:
- Vote111111111111111111111111111111111111111
- transactionDetails: signatures
limit: 50
sortOrder: desc
filters:
status: succeeded
slot:
gte: 1000
lt: 2000
tokenTransfer:
direction: in
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
items:
oneOf:
- type: string
description: >-
Dirección de la cuenta de Solana cuyo historial de
transacciones se recuperará (billetera, token,
programa, NFT, etc.).
example: Vote111111111111111111111111111111111111111
- type: object
description: >-
Configuración avanzada de consultas para filtrado,
ordenamiento y paginación.
properties:
transactionDetails:
type: string
description: >-
Nivel de detalle de la transacción que se
devolverá.
enum:
- signatures
- full
default: signatures
example: signatures
sortOrder:
type: string
description: Orden de las transacciones devueltas.
enum:
- asc
- desc
default: desc
example: desc
commitment:
type: string
description: >-
El nivel de compromiso de la solicitud. El
compromiso `processed` no es compatible.
enum:
- confirmed
- finalized
default: finalized
example: finalized
minContextSlot:
type: integer
description: >-
Slot de contexto mínimo que se usará para la
solicitud (opcional).
example: 1000
limit:
type: integer
description: >-
Número máximo de transacciones por solicitud. Usa
de 1 a 1000 para transactionDetails:"signatures" y
de 1 a 1000 para transactionDetails:"full".
minimum: 1
maximum: 1000
default: 1000
example: 100
paginationToken:
type: string
description: >-
Token de paginación de la respuesta anterior para
obtener la siguiente página de resultados (formato
"slot:position").
example: '1053:13'
encoding:
type: string
description: >-
Formato de codificación de los datos de
transacción (solo se aplica cuando
transactionDetails=full).
enum:
- json
- jsonParsed
- base58
- base64
default: json
example: json
maxSupportedTransactionVersion:
type: integer
description: >-
Versión máxima de transacción que se devolverá
(solo se aplica cuando transactionDetails=full).
Establécela en 1 para recibir transacciones
heredadas, v0 y v1.
example: 1
filters:
type: object
description: >-
Filtros avanzados para limitar los resultados de
las transacciones.
properties:
slot:
type: object
description: Filtra por número de slot.
properties:
gte:
type: integer
description: Mayor o igual que el número de slot.
example: 100
gt:
type: integer
description: Mayor que el número de slot.
example: 100
lte:
type: integer
description: Menor o igual que el número de slot.
example: 200
lt:
type: integer
description: Menor que el número de slot.
example: 200
additionalProperties: false
blockTime:
type: object
description: >-
Filtra por marca de tiempo del bloque (marca
de tiempo Unix).
properties:
gte:
type: integer
description: Mayor o igual que la marca de tiempo.
example: 1640995200
gt:
type: integer
description: Mayor que la marca de tiempo.
example: 1640995200
lte:
type: integer
description: Menor o igual que la marca de tiempo.
example: 1641081600
lt:
type: integer
description: Menor que la marca de tiempo.
example: 1641081600
eq:
type: integer
description: Igual a la marca de tiempo.
example: 1641038400
additionalProperties: false
signature:
type: object
description: Filtra por firma de transacción.
properties:
gte:
type: string
description: >-
Obtén transacciones con firmas mayores o
iguales que este valor.
example: >-
4h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
gt:
type: string
description: >-
Obtén transacciones posteriores a esta
firma.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lte:
type: string
description: >-
Obtén transacciones con firmas menores o
iguales que este valor.
example: >-
6k7xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
lt:
type: string
description: >-
Obtén transacciones anteriores a esta
firma.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
additionalProperties: false
status:
type: string
description: Filtra por estado de la transacción.
enum:
- succeeded
- failed
- any
default: any
example: succeeded
tokenAccounts:
type: string
description: >-
Filtra las transacciones de cuentas de tokens
relacionadas. Controla si se incluyen las
transacciones que involucran cuentas de tokens
propiedad de la dirección.
enum:
- none
- balanceChanged
- all
default: none
example: balanceChanged
tokenTransfer:
$ref: '#/components/schemas/TokenTransferFilter'
description: >-
Filtra las transacciones en las que la
dirección consultada participó en una
transferencia de tokens que coincide con una
contraparte, dirección, acuñación o intervalo
de importes sin procesar.
additionalProperties: false
responses:
'200':
description: >-
Se recuperaron correctamente las transacciones de la dirección
especificada.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: object
description: Datos de transacciones e información de paginación.
properties:
data:
type: array
description: Lista de información de transacciones.
items:
oneOf:
- type: object
description: >-
Resumen de la transacción a nivel de firma
(cuando transactionDetails es "signatures").
properties:
signature:
type: string
description: >-
Firma de la transacción como una cadena
codificada en base 58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: >-
El slot que contiene el bloque con la
transacción.
example: 1054
transactionIndex:
type: integer
description: >-
El índice de base cero de la transacción
dentro de su bloque. Es útil para determinar
el orden de las transacciones dentro de un
bloque.
example: 42
err:
oneOf:
- type: object
description: Error si la transacción falló
- type: 'null'
description: >-
Error si la transacción falló, o null si se
completó correctamente.
example: null
memo:
oneOf:
- type: string
description: Nota asociada con la transacción
- type: 'null'
description: >-
Nota asociada con la transacción, o null si
no hay ninguna.
example: null
blockTime:
oneOf:
- type: integer
description: >-
Tiempo de producción estimado como marca
de tiempo Unix
- type: 'null'
description: >-
Tiempo de producción estimado como marca de
tiempo Unix (segundos desde la época), o
null si no está disponible.
example: 1641038400
confirmationStatus:
oneOf:
- type: string
enum:
- processed
- confirmed
- finalized
description: >-
Estado de confirmación de la transacción
en el clúster
- type: 'null'
description: >-
Estado de confirmación de la transacción en
el clúster.
example: finalized
required:
- signature
- slot
- transactionIndex
additionalProperties: false
- type: object
description: >-
Transacción completa con metadatos de estado
(cuando transactionDetails es "full").
properties:
slot:
type: integer
description: >-
El slot que contiene el bloque con la
transacción.
example: 1054
transactionIndex:
type: integer
description: >-
El índice de base cero de la transacción
dentro de su bloque. Es útil para determinar
el orden de las transacciones dentro de un
bloque.
example: 42
transaction:
type: object
description: >-
Objeto de transacción codificado o analizado
según la codificación seleccionada.
meta:
type: object
description: >-
Metadatos del estado de la transacción:
tienen la misma estructura que
getTransaction e incluyen err, fee,
preBalances/postBalances,
preTokenBalances/postTokenBalances,
innerInstructions, logMessages y
computeUnitsConsumed.
blockTime:
oneOf:
- type: integer
description: >-
Tiempo de producción estimado como marca
de tiempo Unix
- type: 'null'
description: >-
Tiempo de producción estimado como marca de
tiempo Unix (segundos desde la época), o
null si no está disponible.
required:
- slot
- transactionIndex
- transaction
paginationToken:
oneOf:
- type: string
description: >-
Token para recuperar la siguiente página de
resultados
- type: 'null'
description: >-
Token de paginación para la siguiente página, o null
si no hay más resultados.
example: '1055:5'
examples:
signaturesResponse:
summary: Respuesta solo con los detalles de las firmas
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1054
transactionIndex: 42
err: null
memo: null
blockTime: 1641038400
confirmationStatus: finalized
- signature: >-
kwjd820slPK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 1055
transactionIndex: 15
err: null
memo: null
blockTime: 1641038460
confirmationStatus: finalized
paginationToken: '1055:5'
fullResponse:
summary: Respuesta con todos los detalles de la transacción
value:
jsonrpc: '2.0'
id: '1'
result:
data:
- slot: 1054
transactionIndex: 42
transaction:
signatures:
- >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
message:
accountKeys:
- ...
- ...
instructions:
- ...
meta:
err: null
fee: 5000
preBalances:
- 1000000
- 2000000
postBalances:
- 999995000
- 2000000
preTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '1500000'
decimals: 6
uiAmount: 1.5
uiAmountString: '1.5'
postTokenBalances:
- accountIndex: 1
mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
owner: ...
programId: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA
uiTokenAmount:
amount: '500000'
decimals: 6
uiAmount: 0.5
uiAmountString: '0.5'
logMessages:
- ...
computeUnitsConsumed: 2100
blockTime: 1641038400
paginationToken: '1055:5'
'400':
description: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o no está presente.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: 'Error interno del servidor: se produjo un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: >-
Tiempo de espera agotado en la puerta de enlace: se agotó el tiempo
de espera de la solicitud.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
TokenTransferFilter:
type: object
description: >-
Limita los resultados a las transacciones en las que la dirección
consultada participó en una transferencia de tokens que coincide con
criterios específicos. Todos los campos son opcionales y se combinan con
semántica AND.
properties:
with:
type: string
description: >-
Dirección de la contraparte. Coincide con las transferencias cuyo
otro lado es esta dirección.
example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
direction:
type: string
description: >-
Dirección de la transferencia con respecto a la dirección
consultada.
enum:
- in
- out
- any
default: any
example: in
mint:
type: string
description: Acuñación del token por la que se filtrará.
example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount:
$ref: '#/components/schemas/TokenTransferAmountFilter'
description: >-
Comparación de importes mediante el importe sin procesar en cadena,
no el importe de la interfaz de usuario ni el ajustado por
decimales.
additionalProperties: false
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
TokenTransferAmountFilter:
type: object
description: >-
Filtro de intervalo del importe sin procesar en cadena. Todos los campos
son opcionales y pueden combinarse.
properties:
gt:
type: number
description: Estrictamente mayor que.
example: 1000000
gte:
type: number
description: Mayor o igual que.
example: 1000000
lt:
type: number
description: Estrictamente menor que.
example: 5000000
lte:
type: number
description: Menor o igual que.
example: 5000000
additionalProperties: false
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````