> ## 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.
# getSignaturesForAddress
> getSignaturesForAddress devuelve las firmas de transacciones confirmadas que incluyen una dirección de Solana en accountKeys, retrocediendo en el tiempo desde el bloque más reciente.
Para usar filtros avanzados, ordenamiento e historial de cuentas de tokens, usa [`getTransactionsForAddress`](/docs/es/rpc/gettransactionsforaddress). Ten en cuenta que `getSignaturesForAddress` no incluye transacciones relacionadas con cuentas de tokens asociadas.
## Parámetros de la solicitud
Dirección de la cuenta de Solana cuyo historial de transacciones quieres obtener (billetera, token, programa, NFT, etc.).
El nivel de confirmación de la solicitud. El nivel de confirmación `processed` no es compatible.
* `confirmed`
* `finalized`
El slot mínimo en el que se puede evaluar la solicitud.
Número máximo de firmas de transacciones que se devolverán en una sola solicitud (1-1,000).
Parámetro de paginación para obtener las transacciones anteriores a esta firma (más antiguas).
Obtén transacciones hasta llegar a esta firma. Es útil para intervalos de tiempo específicos.
## OpenAPI
````yaml es/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API integral del historial de transacciones de Solana para recuperar y
analizar actividades históricas de la blockchain asociadas con cualquier
dirección de billetera o programa.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Endpoint RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignaturesForAddress
description: >
Recupera las firmas de las transacciones correspondientes a la actividad
de una dirección específica de Solana con una paginación avanzada.
Esta API esencial proporciona el historial de transacciones de cualquier
dirección de billetera, token, programa o NFT de Solana
y devuelve las firmas de las transacciones en orden cronológico con su
estado, tiempo y resultados de ejecución.
Es perfecta para crear historiales de transacciones de billeteras,
supervisar la actividad de programas, analizar direcciones
y desarrollar cualquier aplicación que necesite dar seguimiento a
operaciones históricas en la blockchain de Solana.
Admite una paginación flexible para acceder al historial completo de
transacciones.
operationId: getSignaturesForAddress
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:
- getSignaturesForAddress
example: getSignaturesForAddress
description: El nombre del método RPC que se invocará.
default: getSignaturesForAddress
params:
type: array
description: >-
Arreglo que contiene la dirección de cuenta requerida y un
objeto de configuración opcional.
default:
- Vote111111111111111111111111111111111111111
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 la consulta para
personalizar la recuperación del historial de
transacciones.
properties:
commitment:
type: string
description: >-
El nivel de compromiso de la solicitud. El nivel
de compromiso `processed` no es compatible.
enum:
- confirmed
- finalized
example: finalized
minContextSlot:
type: integer
description: >-
La ranura mínima en la que se puede evaluar la
solicitud.
example: 1000
limit:
type: integer
description: >-
Cantidad máxima de firmas de transacciones que se
devolverán en una sola solicitud (1-1,000).
example: 1000
before:
type: string
description: >-
Parámetro de paginación para obtener transacciones
anteriores a esta firma (previas en el tiempo).
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
until:
type: string
description: >-
Obtiene transacciones hasta alcanzar esta firma.
Es útil para intervalos de tiempo específicos.
example: >-
3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
responses:
'200':
description: >-
Las firmas de la dirección especificada se recuperaron
correctamente.
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: array
description: >-
Lista de información sobre las firmas de las
transacciones.
items:
type: object
description: Detalles de cada firma de transacción.
properties:
signature:
type: string
description: >-
Firma de la transacción como una cadena codificada
en base 58.
example: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot:
type: integer
description: La ranura que contiene el bloque con la transacción.
example: 114
err:
oneOf:
- type: object
description: Error si la transacción falló
- type: 'null'
description: >-
Error si la transacción falló, o null si se realizó
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 estimado de producción como marca de
tiempo Unix
- type: 'null'
description: >-
Tiempo estimado de producción como marca de tiempo
Unix (segundos desde la época), o null si no está
disponible.
example: null
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
examples:
response:
value:
jsonrpc: '2.0'
id: 1
result:
- signature: >-
5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
slot: 114
err: null
memo: null
blockTime: null
confirmationStatus: finalized
application/json; schema=examples/request:
example:
jsonrpc: '2.0'
id: 1
method: getSignaturesForAddress
params:
- Vote111111111111111111111111111111111111111
- limit: 1
'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 se proporcionó.'
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: ocurrió 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 de la puerta de enlace agotado: 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:
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'
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).
````