> ## 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
> Retorna os status de uma lista de assinaturas. Cada assinatura deve ser um txid, a primeira assinatura de uma transação.
## Parâmetros da Requisição
Matriz de assinaturas de transação (até 256), como strings codificadas em base-58.
Habilitar busca além do cache de status recente para encontrar transações históricas mais antigas.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de rastreamento de confirmação de transações para monitoramento do
status e nível de finalidade de várias transações Solana com atualizações em
tempo 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 Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
Recuperar status de confirmação para várias transações Solana em uma
única solicitação de lote eficiente.
Esta API essencial de rastreamento de transações permite que os
aplicativos monitorem o progresso das transações
através do processo de consenso do Solana, desde a submissão inicial até
a confirmação final. Retorna informações detalhadas
sobre o status da transação, incluindo slot de processamento, contagem
de confirmações, detalhes de erro
e nível de finalidade. Crítico para carteiras, exchanges, processadores
de pagamento e qualquer aplicação que
precisa verificar quando as transações foram liquidadas com sucesso na
blockchain com opções configuráveis
de consulta de transações históricas.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: A versão do protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Um identificador exclusivo para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: O nome do método RPC a ser invocado.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Array contendo assinaturas de transações e objeto de
configuração opcional.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Array de assinaturas de transações (até 256), como
strings codificadas em base-58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Opções de configuração.
properties:
searchTransactionHistory:
type: boolean
description: >-
Ativar busca além do cache de status recente para
encontrar transações históricas mais antigas.
example: true
responses:
'200':
description: Status de assinatura recuperado com sucesso.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
result:
type: object
description: Contém o contexto e os valores de status de assinatura.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot no qual os dados foram buscados.
example: 82
value:
type: array
description: Lista de status de assinaturas de transação.
items:
oneOf:
- type: 'null'
description: Nulo se a transação for desconhecida.
- type: object
properties:
slot:
type: integer
description: >-
Número do slot da blockchain Solana onde
esta transação foi incluída em um bloco.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Número de blocos confirmados desde que
esta transação foi processada (nulo se
totalmente finalizada).
- type: 'null'
description: >-
Nulo indica que a transação atingiu a
máxima finalidade (enraizada).
example: 48
err:
oneOf:
- type: object
description: >-
Objeto de erro contendo detalhes se a
transação falhou durante a execução.
- type: 'null'
description: >-
Nulo indica que a transação foi
executada com sucesso sem erros.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Status de finalidade atual da transação na
rede 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: >-
Solicitação Inválida - Parâmetros de solicitação inválidos ou
solicitação malformada.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Não autorizado - Chave de API inválida ou ausente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Muitas Solicitações - Limite de taxa excedido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Erro Interno do Servidor - Ocorreu um erro no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Serviço Indisponível - O serviço está temporariamente indisponível.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Tempo Limite do Gateway - A solicitação expirou.
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: A versão do protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: O código de erro.
example: -32602
message:
type: string
description: A mensagem de erro.
data:
type: object
description: Dados adicionais sobre o erro.
id:
type: string
description: Identificador correspondente à solicitação.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````