> ## 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.
# getVoteAccounts
> Retorna as informações de conta e a participação associada para todas as contas de votação no banco atual.
## Parâmetros da Solicitação
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
* `processed`
Endereço específico da conta de voto do validador para filtrar resultados (codificado em base-58).
Incluir validadores que estão atrasados, mas não têm participação delegada a eles.
Limite personalizado de slots atrasados para marcar validadores como inadimplentes ou com baixo desempenho.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getVoteAccounts.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API abrangente de monitoramento de validador Solana para rastrear
participantes da rede, atividade de staking e participação no consenso em
todo o ecossistema blockchain.
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: getVoteAccounts
description: >
Recupere informações detalhadas sobre validadores Solana e sua
participação no consenso da rede.
Esta poderosa API fornece métricas abrangentes de validadores, incluindo
endereços de identidade, quantidades de staking,
taxas de comissão, atividade de votação e status de desempenho.
Essencial para aplicativos de staking, ferramentas de seleção de
validadores, painéis de monitoramento de rede e análise de
descentralização. Categoriza validadores
como atuais (participantes ativos) ou delinquentes (com baixo
desempenho), fornecendo insights críticos
para delegadores que buscam otimizar sua estratégia de staking e
recompensas na blockchain Solana.
operationId: getVoteAccounts
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:
- getVoteAccounts
description: O nome do método RPC a ser invocado.
example: getVoteAccounts
default: getVoteAccounts
params:
type: array
description: Objeto de configuração opcional para filtrar contas de voto.
items:
type: object
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
- processed
example: finalized
votePubkey:
type: string
description: >-
Endereço específico da conta de voto do validador para
filtrar resultados (codificado em base-58).
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
keepUnstakedDelinquents:
type: boolean
description: >-
Incluir validadores que ficaram para trás, mas não têm
stake delegado a eles.
example: true
delinquentSlotDistance:
type: integer
description: >-
Limite personalizado de slots de atraso para marcar
validadores como delinquentes ou com baixo desempenho.
example: 128
responses:
'200':
description: Contas de voto recuperadas 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: Lista de contas de voto atuais e delinquentes.
properties:
current:
type: array
description: >-
Validadores ativos que participam corretamente no
consenso da rede Solana.
items:
type: object
properties:
votePubkey:
type: string
description: >-
Endereço exclusivo da conta de voto Solana
associado a este validador.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: >-
Endereço de identidade do validador que controla
a conta de voto.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: >-
Total de SOL delegado a este validador em
lamports, determinando seu peso no consenso.
example: 42
epochVoteAccount:
type: boolean
description: >-
Se este validador é elegível para recompensas no
epoch atual.
example: true
commission:
type: integer
description: >-
Porcentagem da comissão do validador (0-100)
retirada das recompensas de staking.
example: 0
lastVote:
type: integer
description: >-
Slot Solana mais recente em que este validador
votou, indicando atividade.
example: 147
epochCredits:
type: array
description: >-
Histórico recente de créditos ganhos por até
cinco epochs.
items:
type: array
description: >-
Histórico de créditos [epoch, créditos,
créditos anteriores].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot raíz atual para esta conta de voto.
example: 42
delinquent:
type: array
description: >-
Validadores com baixo desempenho que ficaram para trás
na participação no consenso.
items:
type: object
properties:
votePubkey:
type: string
description: Endereço da conta de voto.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: Identidade do validador.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: Stake delegado a esta conta de voto (lamports).
example: 0
epochVoteAccount:
type: boolean
description: Se a conta de voto está staked para este epoch.
example: false
commission:
type: integer
description: >-
Porcentagem (0-100) do pagamento de recompensas
devidas à conta de voto.
example: 0
lastVote:
type: integer
description: Slot mais recente votado por esta conta de voto.
example: 147
epochCredits:
type: array
description: >-
Histórico recente de créditos ganhos por até
cinco epochs.
items:
type: array
description: >-
Histórico de créditos [epoch, créditos,
créditos anteriores].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot raíz atual para esta conta de voto.
example: 42
examples:
default:
value:
jsonrpc: '2.0'
id: '1'
result:
current:
- votePubkey: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake: 42
epochVoteAccount: true
commission: 0
lastVote: 147
epochCredits:
- - 1
- 64
- 0
- - 2
- 192
- 64
rootSlot: 42
delinquent: []
'400':
description: >-
Bad Request - 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: Unauthorized - Chave 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: Too Many Requests - 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: Internal Server Error - 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: Service Unavailable - 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: Gateway Timeout - O tempo de requisiçã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 API Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````