> ## 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
> Retorna a recompensa de inflação/staking para uma lista de endereços para uma época.
## Parâmetros da Solicitação
Lista de endereços Solana (validadores ou delegadores) para recuperar recompensas de staking, como strings codificadas em base-58.
O nível de compromisso para a solicitação.
* `confirmed`
* `finalized`
Número específico da época Solana para recuperar recompensas. Se omitido, retorna as recompensas distribuídas mais recentemente.
O slot mínimo no qual a solicitação pode ser avaliada.
## OpenAPI
````yaml pt-BR/openapi/rpc-http/getInflationReward.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API de análise de recompensas de staking para recuperar e calcular ganhos
baseados em inflação pagos a delegadores e validadores da Solana durante
epochs específicos.
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: getInflationReward
description: >
Recuperar informações detalhadas de recompensas de staking para
validadores e contas de delegadores Solana.
Esta API essencial de staking fornece dados precisos sobre recompensas
SOL distribuídas para contas especificadas durante um epoch específico.
Essas recompensas baseadas em inflação representam ganhos pela
participação no consenso proof-of-stake da Solana, seja diretamente como
validadores ou indiretamente como delegadores. Retorna quantias de
recompensas, taxas de comissão, dados de saldo pós-recompensa e
informações de tempo para cálculos precisos de rendimento de staking.
Essencial para painéis de staking, rastreadores de rendimento,
aplicativos de carteira, ferramentas de relatórios fiscais e qualquer
serviço que rastreie retornos de atividades de staking da Solana.
operationId: getInflationReward
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
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:
- getInflationReward
example: getInflationReward
default: getInflationReward
params:
type: array
description: Parâmetros para o método.
default:
- - 6dmNQ5jwLeLk5REvio1JcMshcbvkYMwy26sJ8pbkvStu
items:
oneOf:
- type: array
description: >-
Lista de endereços Solana (validadores ou delegadores)
para recuperar recompensas de staking, como strings
codificadas em base-58.
items:
type: string
example:
- 6dmNQ5jwLeLk5REvio1JcMshcbvkYMwy26sJ8pbkvStu
- BGsqMegLpV6n6Ve146sSX2dTjUMj3M92HnU8BbNRMhF2
- type: object
description: Objeto de configuração contendo parâmetros opcionais.
properties:
commitment:
type: string
description: O nível de compromisso para a solicitação.
enum:
- confirmed
- finalized
example: finalized
epoch:
type: integer
description: >-
Número específico do epoch Solana para recuperar
recompensas. Se omitido, retorna as recompensas
distribuídas mais recentemente.
example: 2
minContextSlot:
type: integer
description: O slot mínimo que a solicitação pode ser avaliada.
example: 1000
responses:
'200':
description: Informações de recompensas de inflação 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: array
description: >-
Array de informações detalhadas de recompensas de staking
para cada conta solicitada, na mesma ordem em que foram
solicitadas.
items:
oneOf:
- type: object
description: >-
Detalhes das recompensas de staking Solana para esta
conta.
properties:
epoch:
type: integer
description: >-
Número do epoch Solana quando estas recompensas
de staking foram distribuídas.
example: 2
effectiveSlot:
type: integer
description: >-
Slot específico do blockchain quando essas
recompensas foram calculadas e se tornaram
eficazes.
example: 224
amount:
type: integer
description: >-
Quantidade de recompensa de staking em lamports
(1 SOL = 1.000.000.000 lamports) ganha por esta
conta.
example: 2500
postBalance:
type: integer
description: >-
Saldo da conta em lamports após esta recompensa
de staking ter sido creditada.
example: 499999442500
commission:
type: integer
description: >-
Porcentagem de comissão do validador retirada
das recompensas do delegador (nulo para contas
de delegador, 0-100 para validadores).
nullable: true
example: 5
- type: 'null'
description: >-
Nulo se esta conta não recebeu quaisquer recompensas
de staking durante o epoch especificado.
example: null
'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: Parâmetros inválidos
id: '1'
'401':
description: Unauthorized - 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
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: Muitas solicitações
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: Erro interno
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: Serviço indisponível
id: '1'
'504':
description: Gateway Timeout - O tempo da solicitação se esgotou.
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'
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 Helius. Você pode obter uma gratuitamente no
[dashboard](https://dashboard.helius.dev/api-keys).
````