> ## 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.
# getInflationReward
> Devuelve la recompensa por inflación o staking de una lista de direcciones para una época.
## Parámetros de la solicitud
Lista de direcciones de Solana (validadores o delegadores) para las que se recuperarán las recompensas por staking, como cadenas codificadas en base 58.
El nivel de compromiso de la solicitud.
* `confirmed`
* `finalized`
Número específico de época de Solana para el que se recuperarán las recompensas. Si se omite, devuelve las recompensas distribuidas más recientemente.
El slot mínimo en el que se puede evaluar la solicitud.
## OpenAPI
````yaml es/openapi/rpc-http/getInflationReward.yaml POST /
openapi: 3.1.0
info:
title: API RPC de Solana
version: 1.0.0
description: >-
API de análisis de recompensas de staking para recuperar y calcular las
ganancias basadas en la inflación pagadas a delegadores y validadores de
Solana durante épocas específicas.
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: getInflationReward
description: >
Recupera información detallada sobre las recompensas de staking de
validadores y cuentas de delegadores de Solana.
Esta API esencial de staking proporciona datos precisos sobre las
recompensas en SOL distribuidas a las cuentas
especificadas durante una época determinada. Estas recompensas basadas
en la inflación representan las ganancias por
participar en el consenso de prueba de participación de Solana, ya sea
directamente como validadores o
indirectamente como delegadores. Devuelve los importes de las
recompensas, las tasas de comisión, los datos del saldo posterior
y la información temporal para calcular con precisión el rendimiento del
staking. Es fundamental para paneles de staking,
rastreadores de rendimiento, aplicaciones de billetera, herramientas de
declaración de impuestos y cualquier servicio que rastree los
rendimientos
de las actividades de staking en Solana.
operationId: getInflationReward
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
properties:
jsonrpc:
type: string
description: La versión del protocolo JSON-RPC.
enum:
- '2.0'
example: '2.0'
default: '2.0'
id:
type: string
description: Un identificador único para la solicitud.
example: '1'
default: '1'
method:
type: string
description: El nombre del método RPC que se invocará.
enum:
- getInflationReward
example: getInflationReward
default: getInflationReward
params:
type: array
description: Parámetros del método.
default:
- - 6dmNQ5jwLeLk5REvio1JcMshcbvkYMwy26sJ8pbkvStu
items:
oneOf:
- type: array
description: >-
Lista de direcciones de Solana (validadores o
delegadores) cuyas recompensas de staking se
recuperarán, como cadenas codificadas en base 58.
items:
type: string
example:
- 6dmNQ5jwLeLk5REvio1JcMshcbvkYMwy26sJ8pbkvStu
- BGsqMegLpV6n6Ve146sSX2dTjUMj3M92HnU8BbNRMhF2
- type: object
description: >-
Objeto de configuración que contiene parámetros
opcionales.
properties:
commitment:
type: string
description: El nivel de compromiso de la solicitud.
enum:
- confirmed
- finalized
example: finalized
epoch:
type: integer
description: >-
Número específico de época de Solana cuyas
recompensas se recuperarán. Si se omite, devuelve
las recompensas distribuidas más recientemente.
example: 2
minContextSlot:
type: integer
description: >-
El slot mínimo en el que se puede evaluar la
solicitud.
example: 1000
responses:
'200':
description: >-
La información de las recompensas por inflación se recuperó
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: array
description: >-
Arreglo con información detallada sobre las recompensas de
staking de cada cuenta solicitada, en el mismo orden en
que se solicitaron.
items:
oneOf:
- type: object
description: >-
Detalles de las recompensas de staking de Solana
para esta cuenta.
properties:
epoch:
type: integer
description: >-
Número de época de Solana en la que se
distribuyeron estas recompensas de staking.
example: 2
effectiveSlot:
type: integer
description: >-
Slot específico de la cadena de bloques en el
que se calcularon y entraron en vigor estas
recompensas.
example: 224
amount:
type: integer
description: >-
Importe de la recompensa de staking en lamports
(1 SOL = 1,000,000,000 lamports) obtenido por
esta cuenta.
example: 2500
postBalance:
type: integer
description: >-
Saldo de la cuenta en lamports después de
acreditar esta recompensa de staking.
example: 499999442500
commission:
type: integer
description: >-
Porcentaje de comisión del validador deducido de
las recompensas del delegador (null para cuentas
de delegadores, de 0 a 100 para validadores).
nullable: true
example: 5
- type: 'null'
description: >-
Null si esta cuenta no recibió ninguna recompensa de
staking durante la época especificada.
example: null
'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 falta.'
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).
````