> ## 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.
# getSignatureStatuses
> Devuelve los estados de una lista de firmas. Cada firma debe ser un txid, es decir, la primera firma de una transacción.
## Parámetros de solicitud
Arreglo de firmas de transacciones (hasta 256), codificadas como cadenas en base 58.
Habilita la búsqueda más allá de la caché de estados recientes para encontrar transacciones históricas más antiguas.
## OpenAPI
````yaml es/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API de seguimiento de confirmaciones de transacciones para monitorear el
estado y el nivel de finalidad de varias transacciones de Solana con
actualizaciones en tiempo real.
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: getSignatureStatuses
description: >
Obtén el estado de confirmación de varias transacciones de Solana en una
única solicitud por lotes eficiente.
Esta API esencial de seguimiento de transacciones permite que las
aplicaciones monitoreen el avance de las transacciones
a través del proceso de consenso de Solana, desde el envío inicial hasta
la confirmación final. Devuelve información
detallada sobre el estado de las transacciones, incluido el slot de
procesamiento, el recuento de confirmaciones, los detalles de errores
y el nivel de finalidad. Es fundamental para billeteras, exchanges,
procesadores de pagos y cualquier aplicación que
necesite verificar cuándo las transacciones se han liquidado
correctamente en la blockchain, con opciones configurables
para buscar transacciones históricas.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: El nombre del método RPC que se invocará.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Arreglo que contiene las firmas de las transacciones y un
objeto de configuración opcional.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Arreglo de firmas de transacciones (hasta 256), como
cadenas codificadas en base 58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Opciones de configuración.
properties:
searchTransactionHistory:
type: boolean
description: >-
Permite buscar más allá de la caché de estados
recientes para encontrar transacciones históricas
más antiguas.
example: true
responses:
'200':
description: Los estados de las firmas se obtuvieron 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: object
description: >-
Contiene el contexto y los valores de estado de las
firmas.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot en el que se obtuvieron los datos.
example: 82
value:
type: array
description: Lista de estados de las firmas de transacciones.
items:
oneOf:
- type: 'null'
description: Es null si la transacción es desconocida.
- type: object
properties:
slot:
type: integer
description: >-
Número de slot de la blockchain de Solana en
el que esta transacción se incluyó en un
bloque.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Número de bloques confirmados desde que
se procesó esta transacción (null si
está completamente finalizada).
- type: 'null'
description: >-
null indica que la transacción alcanzó
la finalidad máxima (con raíz
establecida).
example: 48
err:
oneOf:
- type: object
description: >-
Objeto de error que contiene detalles si
la transacción falló durante la
ejecución.
- type: 'null'
description: >-
null indica que la transacción se
ejecutó correctamente y sin errores.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Estado de finalidad actual de la transacción
en la red de Solana (processed → confirmed →
finalized).
example: finalized
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 82
value:
- slot: 48
confirmations: 48
err: null
confirmationStatus: finalized
- null
'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: Parámetros no válidos
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: No autorizado
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: Demasiadas solicitudes
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: Error interno
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: Servicio no disponible
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: Tiempo de espera de la puerta de enlace agotado
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).
````