> ## 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.
# getMultipleAccounts
> Retorna as informações da conta para uma lista de Chaves Públicas.
**Nova Funcionalidade**: `getMultipleAccounts` 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
Conjunto de endereços de contas Solana (até 100) para buscar em uma única solicitação de lote otimizada.
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
* `processed`
O slot mínimo em que a solicitação pode ser avaliada.
Solicitar um fragmento dos dados da conta.
Número de bytes a retornar.
Deslocamento de byte a partir do qual começar a leitura.
Formato de codificação para os dados da conta retornados.
* `jsonParsed`
* `base58`
* `base64`
* `base64+zstd`
Retornar apenas contas que foram modificadas no ou após este número de slot. Para contas que existem, mas não mudaram desde o slot especificado, a resposta irá conter o status como "unchanged".
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getMultipleAccounts.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de recuperação de dados de contas em lote otimizada da Solana para
acessar eficientemente várias contas blockchain em uma única solicitação com
opções de codificação 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: Ponto de extremidade da Mainnet RPC
- url: https://devnet.helius-rpc.com
description: Ponto de extremidade da Devnet RPC
security: []
paths:
/:
post:
tags:
- RPC
summary: getMultipleAccounts
description: >
Recupere dados para várias contas Solana em uma única solicitação de
lote eficiente.
Esta API otimizada para desempenho reduz a sobrecarga da rede ao buscar
até 100 contas
simultaneamente, com suporte para várias codificações de dados,
incluindo análise JSON para tipos de programas conhecidos. Ideal para
DApps, carteiras e serviços que precisam acessar múltiplos
saldos de tokens, metadados NFTs, estados de programas ou qualquer
combinação de dados de conta em cadeia
com latência mínima e uso de largura de banda.
operationId: getMultipleAccounts
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'
example: '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:
- getMultipleAccounts
example: getMultipleAccounts
default: getMultipleAccounts
params:
type: array
description: Parâmetros para o método.
default:
- - vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg
- 4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA
items:
oneOf:
- type: array
description: >-
Matriz de endereços de contas Solana (até 100) para
buscar em uma única solicitação de lote otimizada.
items:
type: string
example:
- vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg
- 4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA
- type: object
description: >-
Opções de configuração avançadas para personalizar a
recuperação de dados de conta em lote.
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
- processed
example: finalized
minContextSlot:
type: integer
description: >-
O slot mínimo em que a solicitação pode ser
avaliada.
example: 1000
dataSlice:
type: object
description: Solicite uma parte dos dados da conta.
properties:
length:
type: integer
description: Número de bytes a serem retornados.
example: 50
offset:
type: integer
description: >-
Deslocamento de byte a partir do qual começar
a ler.
example: 0
encoding:
type: string
description: >-
Formato de codificação para os dados de conta
retornados.
enum:
- jsonParsed
- base58
- base64
- base64+zstd
example: base58
changedSinceSlot:
type: integer
description: >-
Retorne somente contas que foram modificadas neste
slot ou depois dele. Para contas que existem, mas
não mudaram desde o slot especificado, a resposta
conterá o status como "unchanged".
example: 464175999
responses:
'200':
description: Detalhes da conta 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 correspondente à solicitação.
example: '1'
result:
type: object
description: Informações das contas com contexto.
properties:
context:
type: object
description: Contexto da resposta.
properties:
apiVersion:
type: string
description: Versão da API da resposta.
example: 2.0.15
slot:
type: integer
description: O slot no qual os dados foram buscados.
example: 341197247
value:
type: array
description: Array de detalhes da conta.
items:
oneOf:
- type: 'null'
description: Nulo se a conta não existir.
- type: object
description: Detalhes da conta.
properties:
lamports:
type: integer
description: Número de lamports atribuídos à conta.
example: 88849814690250
owner:
type: string
description: >-
Pubkey codificado em Base-58 do programa ao
qual a conta está atribuída.
example: '11111111111111111111111111111111'
data:
type: array
description: >-
Dados da conta como formato binário
codificado ou JSON.
items:
type: string
example:
- ''
- base58
executable:
type: boolean
description: Indica se a conta contém um programa.
example: false
rentEpoch:
type: integer
description: >-
Época em que esta conta precisará pagar
aluguel novamente.
example: 18446744073709552000
space:
type: integer
description: 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
'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
data:
additionalInfo: >-
Por favor, verifique os parâmetros da solicitação e
certifique-se de que são vá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
data:
additionalInfo: Por favor, verifique sua chave de API e tente novamente.
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
data:
additionalInfo: >-
Você excedeu o número permitido de solicitações. Por
favor, espere e tente novamente mais tarde.
id: '1'
'500':
description: Erro Interno do Servidor - Um erro ocorreu no servidor.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Erro interno
data:
additionalInfo: >-
Ocorreu um erro inesperado no servidor. Por favor, tente
novamente mais tarde ou entre em contato com o suporte.
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
data:
additionalInfo: >-
O serviço está atualmente indisponível. Por favor, tente
novamente mais tarde ou entre em contato com o suporte.
id: '1'
'504':
description: Tempo Limite de Gateway - A solicitação expirou.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tempo limite de gateway
data:
additionalInfo: >-
A solicitação expirou. Por favor, tente novamente mais
tarde ou entre em contato com o suporte.
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 do Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````