> ## 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
> Devuelve la información de la cuenta y el stake asociado de todas las cuentas de voto del banco actual.
## Parámetros de la solicitud
El nivel de compromiso de la solicitud.
* `confirmed`
* `finalized`
* `processed`
Dirección específica de la cuenta de voto del validador para filtrar los resultados (codificada en base 58).
Incluye validadores que se han retrasado, pero no tienen ningún stake delegado.
Umbral personalizado de slots de retraso para marcar a los validadores como morosos o con bajo rendimiento.
## OpenAPI
````yaml es/openapi/rpc-http/getVoteAccounts.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API integral de monitoreo de validadores de Solana para rastrear
participantes de la red, actividad de staking y participación en el consenso
en todo el ecosistema blockchain.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Punto de conexión RPC de Mainnet
- url: https://devnet.helius-rpc.com
description: Punto de conexión RPC de Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getVoteAccounts
description: >
Obtén información detallada sobre los validadores de Solana y su
participación en el consenso de la red.
Esta potente API proporciona métricas integrales de los validadores,
incluidas las direcciones de identidad, los montos de staking,
las tasas de comisión, la actividad de votación y el estado de
rendimiento. Es esencial para aplicaciones de staking, herramientas
de selección de validadores, paneles de monitoreo de red y análisis de
descentralización. Clasifica a los validadores
como actuales (participantes activos) o morosos (con bajo rendimiento),
lo que proporciona información clave
para los delegadores que buscan optimizar su estrategia de staking y sus
recompensas en la blockchain de Solana.
operationId: getVoteAccounts
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: La versión del protocolo JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
enum:
- getVoteAccounts
description: El nombre del método RPC que se invocará.
example: getVoteAccounts
default: getVoteAccounts
params:
type: array
description: >-
Objeto de configuración opcional para filtrar las cuentas de
voto.
items:
type: object
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- confirmed
- finalized
- processed
example: finalized
votePubkey:
type: string
description: >-
Dirección específica de la cuenta de voto del
validador para filtrar los resultados (codificada en
base 58).
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
keepUnstakedDelinquents:
type: boolean
description: >-
Incluye los validadores que se han retrasado pero no
tienen stake delegado.
example: true
delinquentSlotDistance:
type: integer
description: >-
Umbral personalizado de slots de retraso para marcar a
los validadores como morosos o con bajo rendimiento.
example: 128
responses:
'200':
description: Las cuentas de voto se obtuvieron correctamente.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
result:
type: object
description: Lista de cuentas de voto actuales y morosas.
properties:
current:
type: array
description: >-
Validadores activos que participan correctamente en el
consenso de la red de Solana.
items:
type: object
properties:
votePubkey:
type: string
description: >-
Dirección única de la cuenta de voto de Solana
asociada con este validador.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: >-
Dirección de identidad del validador que
controla la cuenta de voto.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: >-
Total de SOL delegado a este validador en
lamports, que determina su peso en el consenso.
example: 42
epochVoteAccount:
type: boolean
description: >-
Indica si este validador puede recibir
recompensas en la época actual.
example: true
commission:
type: integer
description: >-
Porcentaje de comisión del validador (0-100)
deducido de las recompensas de staking.
example: 0
lastVote:
type: integer
description: >-
Slot más reciente de Solana en el que votó este
validador, lo que indica su actividad.
example: 147
epochCredits:
type: array
description: >-
Historial más reciente de créditos obtenidos
durante un máximo de cinco épocas.
items:
type: array
description: >-
Historial de créditos [epoch, credits,
previousCredits].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot raíz actual de esta cuenta de voto.
example: 42
delinquent:
type: array
description: >-
Validadores con bajo rendimiento que se han retrasado
en su participación en el consenso.
items:
type: object
properties:
votePubkey:
type: string
description: Dirección de la cuenta de voto.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: Identidad del validador.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: Stake delegado a esta cuenta de voto (lamports).
example: 0
epochVoteAccount:
type: boolean
description: >-
Indica si la cuenta de voto tiene stake para
esta época.
example: false
commission:
type: integer
description: >-
Porcentaje (0-100) del pago de recompensas que
corresponde a la cuenta de voto.
example: 0
lastVote:
type: integer
description: >-
Slot más reciente en el que votó esta cuenta de
voto.
example: 147
epochCredits:
type: array
description: >-
Historial más reciente de créditos obtenidos
durante un máximo de cinco épocas.
items:
type: array
description: >-
Historial de créditos [epoch, credits,
previousCredits].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot raíz actual de esta cuenta 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: >-
Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
con formato incorrecto.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Parámetros no válidos
id: '1'
'401':
description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: No autorizado
id: '1'
'429':
description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Demasiadas solicitudes
id: '1'
'500':
description: 'Error interno del servidor: se produjo un error en el servidor.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Error interno
id: '1'
'503':
description: >-
Servicio no disponible: el servicio no está disponible
temporalmente.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Servicio no disponible
id: '1'
'504':
description: >-
Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
de espera de la solicitud.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Tiempo de espera de la puerta de enlace agotado
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: El código de error.
example: -32602
message:
type: string
description: El mensaje de error.
data:
type: object
description: Datos adicionales sobre el error.
id:
type: string
description: Identificador que coincide con la solicitud.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Tu clave de API de Helius. Puedes obtener una gratis en el
[panel](https://dashboard.helius.dev/api-keys).
````