> ## 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.
# getTransaction
> Retorna os detalhes da transação para uma transação confirmada.
## Parâmetros da Requisição
Assinatura da transação Solana como uma string codificada em base-58 para pesquisa.
Formato de codificação para os dados da transação Solana retornados.
* `json`
* `jsonParsed`
* `base64`
* `base58`
Nível de compromisso do blockchain para verificação de finalização da transação.
* `confirmed`
* `finalized`
Versão máxima da transação Solana a ser retornada nas respostas (para suporte a transações versionadas).
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getTransaction.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API avançada de recuperação de transações Solana para acessar dados
detalhados de transações, assinaturas e resultados de execução do blockchain
Solana.
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: getTransaction
description: >-
Recupere detalhes completos da transação do blockchain Solana por
assinatura da transação. Acesse dados completos, incluindo alterações de
conta, detalhes da instrução, transferências de token, logs de programas
e status de execução. Suporte para dados analisados, múltiplos formatos
de codificação e versões de transações.
operationId: getTransaction
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 único para a solicitação.
example: '1'
default: '1'
method:
type: string
enum:
- getTransaction
description: O nome do método RPC a ser invocado.
example: getTransaction
default: getTransaction
params:
type: array
description: >-
Parâmetros para consultar uma transação Solana por
assinatura.
default:
- >-
D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff
items:
oneOf:
- type: string
description: >-
Assinatura da transação Solana como uma string
codificada em base-58 para pesquisa.
example: >-
D13jTJYXoQBcRY9AfT5xRtsew7ENgCkNs6mwwwAcUCp4ZZCEM7YwZ7en4tVsoDa7Gu75Jjj2FgLXNUz8Zmgedff
- type: string
description: >-
Formato de codificação para os dados de transação
Solana retornados.
enum:
- json
- jsonParsed
- base64
- base58
example: json
- type: object
description: >-
Opções avançadas de configuração para recuperação de
transações Solana.
properties:
commitment:
type: string
description: >-
Nível de compromisso do blockchain para
verificação de finalização da transação.
enum:
- confirmed
- finalized
example: finalized
maxSupportedTransactionVersion:
type: integer
description: >-
Versão máxima de transação Solana a ser retornada
nas respostas (para suporte a transações
versionadas).
example: 0
responses:
'200':
description: Dados detalhados da transação Solana recuperados 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 que corresponde à solicitação.
example: '1'
result:
type: object
description: >-
Detalhes completos da transação Solana, incluindo dados de
execução.
properties:
slot:
type: integer
description: >-
Número do slot do blockchain Solana quando esta
transação foi processada.
example: 430
transaction:
type: object
description: >-
Objeto completo de transação Solana com todos os
detalhes da transação.
properties:
message:
type: object
description: >-
Mensagem de transação Solana contendo instruções
detalhadas de execução.
properties:
accountKeys:
type: array
description: >-
Lista de chaves públicas de contas Solana
envolvidas na transação.
items:
type: string
example: 3UVYmECPPMZSCqWKfENfuoTv51fTDTWicX9xmBD2euKe
header:
type: object
description: >-
Metadados do cabeçalho da transação Solana com
informações de controle de acesso.
properties:
numReadonlySignedAccounts:
type: integer
description: >-
Número de contas Solana assinadas de
leitura apenas na transação.
example: 0
numReadonlyUnsignedAccounts:
type: integer
description: >-
Número de contas Solana não assinadas de
leitura apenas na transação.
example: 3
numRequiredSignatures:
type: integer
description: >-
Número de assinaturas necessárias para
validação da transação Solana.
example: 1
instructions:
type: array
description: >-
Lista de instruções do programa executadas na
transação Solana.
items:
type: object
properties:
accounts:
type: array
description: >-
Lista indexada de contas Solana
acessadas por esta instrução.
items:
type: integer
example: 1
data:
type: string
description: >-
Dados de instrução codificados passados
para o programa Solana.
example: >-
37u9WtQpcm6ULa3WRQHmj49EPs4if7o9f1jSRVZpm2dvihR9C8jY4NqEwXUbLwx15HBSNcP1
programIdIndex:
type: integer
description: >-
Índice do programa Solana que processa
esta instrução.
example: 4
recentBlockhash:
type: string
description: >-
Hash de bloco Solana recente usado para a
janela de validade da transação.
example: mfcyqEXB3DnHXki6KjjmZck6YjmZLvpAByy2fj4nh6B
signatures:
type: array
description: >-
Lista de assinaturas criptográficas validando a
transação Solana.
items:
type: string
example: >-
2nBhEBYYvfaAe16UMNqRHre4YNSskvuYgx3M6E4JP1oDYvZEJHvoPzyUidNgNX5r9sTyN1J9UxtbCXy2rqYcuyuv
meta:
type: object
description: >-
Metadados de execução da transação Solana e
resultados.
properties:
err:
oneOf:
- type: object
- type: 'null'
description: >-
Informações de erro se a transação Solana falhou;
nulo se bem sucedida.
example: null
fee:
type: integer
description: >-
Taxa de transação paga em lamports Solana (1 SOL =
1.000.000.000 lamports).
example: 5000
innerInstructions:
type: array
description: >-
Lista de instruções internas geradas durante a
execução da transação Solana.
items:
type: object
'400':
description: >-
Solicitação Incorreta - 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: Parâmetros inválidos
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: Não autorizado
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: Muitas solicitações
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: Erro interno
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: Serviço indisponível
id: '1'
'504':
description: >-
Tempo Limite do Gateway - O tempo limite da solicitação foi
atingido.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite do gateway
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 que corresponde à 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).
````