> ## 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.
# getAccountInfo
> Retorna todas as informações associadas à conta do Pubkey fornecido.
**Nova Funcionalidade**: `getAccountInfo` agora suporta o parâmetro `changedSinceSlot` para atualizações incrementais. Quando especificado, o método retorna apenas contas que foram modificadas no ou após o número de slot dado. Para contas que existem, mas não mudaram desde o slot especificado, a resposta conterá `status: "unchanged"`.
## Parâmetros da Solicitação
Pubkey da conta a ser consultada, como uma string codificada em base-58.
Nível de compromisso para a consulta.
* `finalized`
* `confirmed`
* `processed`
Formato de codificação para os dados da conta.
* `base58`
* `base64`
* `base64+zstd`
* `jsonParsed`
Solicite um segmento dos dados da conta.
Offset de bytes a partir do qual iniciar a leitura.
Número de bytes a retornar.
O slot mínimo em que a solicitação pode ser avaliada.
Retorne a conta apenas se ela foi modificada no ou após este número de slot. Se a conta existir, mas não foi alterada desde o slot especificado, a resposta conterá status como "unchanged".
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getAccountInfo.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API abrangente de recuperação de dados de contas Solana para acessar
propriedade de programas, saldo e dados on-chain com múltiplas opções de
codificação e níveis de compromisso configuráveis.
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 da Mainnet
- url: https://devnet.helius-rpc.com
description: Endpoint RPC da Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getAccountInfo
operationId: getAccountInfo
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
enum:
- '2.0'
default: '2.0'
id:
type: string
description: Um identificador único para a solicitação.
example: '1'
default: '1'
method:
type: string
description: O nome do método RPC a ser invocado.
enum:
- getAccountInfo
default: getAccountInfo
params:
type: array
default:
- 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
items:
oneOf:
- title: Pubkey
type: string
description: >-
Pubkey da conta a ser consultada, como uma string
codificada em base-58.
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- title: Objeto de Configuração
type: object
description: Objeto de configuração.
properties:
commitment:
type: string
description: Nível de compromisso para a consulta.
enum:
- finalized
- confirmed
- processed
example: confirmed
encoding:
type: string
description: Formato de codificação para dados de conta.
enum:
- base58
- base64
- base64+zstd
- jsonParsed
example: base58
dataSlice:
type: object
description: Solicitar um trecho dos dados da conta.
properties:
offset:
type: integer
description: >-
Deslocamento de byte a partir do qual começar
a leitura.
example: 0
length:
type: integer
description: Número de bytes a serem retornados.
example: 64
minContextSlot:
type: integer
description: >-
O slot mínimo em que a solicitação pode ser
avaliada.
example: 100000000
changedSinceSlot:
type: integer
description: >-
Somente retorne a conta se ela tiver sido
modificada neste slot ou após ele. Se a conta
existir, mas não tiver mudado desde o slot
especificado, a resposta conterá o status como
"unchanged".
example: 464175999
responses:
'200':
description: Informações da conta recuperadas com sucesso.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: A versão do protocolo JSON-RPC.
example: '2.0'
result:
type: object
properties:
context:
type: object
description: Contexto da solicitação.
properties:
apiVersion:
type: string
description: Versão da API da solicitação.
example: 2.0.15
slot:
type: integer
description: Número do slot da resposta.
example: 341197053
value:
oneOf:
- type: object
description: Dados da conta se a conta existir.
properties:
lamports:
type: integer
description: Número de lamports atribuídos a esta conta.
example: 88849814690250
owner:
type: string
description: >-
Pubkey codificado em base-58 do programa ao
qual esta conta está atribuída.
example: '11111111111111111111111111111111'
data:
type: array
items:
type: string
description: >-
Dados associados à conta, seja como dados
binários codificados ou no formato JSON.
example:
- ''
- base58
executable:
type: boolean
description: Indica se a conta contém um programa.
example: false
rentEpoch:
type: integer
description: >-
A época em que esta conta deverá pagar aluguel
novamente.
example: 18446744073709552000
space:
type: integer
description: O tamanho dos dados da conta.
example: 0
- type: object
description: >-
Resposta somente de status quando a conta existe,
mas não mudou desde o slot especificado.
properties:
status:
type: string
description: >-
Status indicando que a conta não mudou desde o
slot especificado.
enum:
- unchanged
example: unchanged
id:
type: integer
description: >-
Um identificador único correspondente ao ID de
solicitação.
example: 1
method:
type: string
description: O método sendo chamado.
example: getAccountInfo
params:
type: array
description: Parâmetros para a solicitação.
items:
oneOf:
- type: string
- type: object
properties:
encoding:
type: string
examples:
response:
value:
jsonrpc: '2.0'
result:
context:
apiVersion: 2.0.15
slot: 341197053
value:
lamports: 88849814690250
owner: '11111111111111111111111111111111'
data:
- ''
- base58
executable: false
rentEpoch: 18446744073709552000
space: 0
id: 1
'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: Parâmetros inválidos
id: '1'
'401':
description: Não autorizado - Chave 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 - A solicitação ultrapassou o tempo limite.
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'
default: '2.0'
error:
type: object
properties:
code:
type: integer
description: Código de erro.
message:
type: string
description: Mensagem de erro.
id:
type: string
description: Um identificador único para a solicitação.
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Sua chave de API Helius. Você pode obter uma gratuitamente no
[painel](https://dashboard.helius.dev/api-keys).
````