getInflationReward

POSTStaking & InflationAll plans

Returns the inflation reward paid to a list of stake accounts for a given epoch.

Try itSends a real request from your browser to the selected region.
POST
/

getInflationReward looks up the staking reward credited to one or more stake accounts for a specific epoch: the lamport amount paid, the post-payout balance, and the validator commission applied.

Rewards are recorded only for epochs where the account was staked and a reward was distributed; otherwise the corresponding array slot is null.

Plans & rate limitsAll plans
Free2/s
Operator5/s
Blade Runner50/s
Nexus100/s

Parameters

params is a JSON array, with values in this order: addresses, config.

1addressesstring[]required

Stake account addresses to look up, as base-58 encoded strings.

2configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to read reward history from.

Allowed values:finalizedconfirmedprocessed
epochinteger

Epoch to query rewards for. Defaults to the previous epoch (the most recent one with a finalized reward payout).

minContextSlotinteger

Minimum slot the node must have processed before answering.

Result

result(object | null)[]

An array with one entry per input address, in the same order, each either a reward record or null.

Show one ofOne of
Option 1object
Show propertiesProperties
epochintegerrequired

Epoch the reward was paid for.

effectiveSlotintegerrequired

Slot at which the reward was credited.

amountintegerrequired

Reward amount in lamports.

postBalanceintegerrequired

Stake account balance in lamports immediately after the reward was applied.

commissioninteger | null

Validator commission (0-100) in effect when the reward was calculated.

Option 2null

Notes

  • A null slot does not mean the address is invalid; it usually means the account was not staked, or not yet activated, during the requested epoch.
  • Older epochs cost more to query, since reward data ages out of the node's hottest cache.