Get a Stream of Yield Summaries

Data Availability

Yield data becomes available only after inflation rewards are fully paid out, which can take several hundred blocks after an epoch ends. Once available, the data includes Inflation Rewards, Block Fees, and MEV Rewards.

The mev field in the response represents rewards earned in the previous epoch but paid out in the current one (i.e., MEV earned in epoch X-1 is paid in epoch X).

Parameters

• network
  Type: string
  Required: Yes
  Defaults to mainnet
  Description: The blockchain network to query (e.g., mainnet).

• type
  Type: string
  Enum:
  Required: Yes
  Description: The type of yield data to retrieve:

  • validator: includes the validator’s own rewards.
  • delegator: includes rewards distributed to delegators of that validator.

Call both endpoints and aggregate the results to get a complete network-wide view.

• validatordelegator Allowed: validator, delegator

• startTime
  Type: number
  Required: Yes
  Description: Epoch-based start time for reward queries.

• endTime
  Type: number
  Required: Yes
  Description: Epoch-based end time for reward queries.

• denomination
  Type: string
  Enum:
  Defaults to lamports
  Description: The unit to return the yield in (e.g., lamports).
  Allowed: lamports, sol

• raw
  Type: boolean
  Defaults to false
  Description: Gives the yield values raw per-epoch. Set to true to get per-epoch raw values.

Allowed: true, false

• accept
  Type: string
  Enum:
  Defaults to application/json
  Description: Generated from available response content types
  Allowed: application/json, application/x-ndjson

Example Request

curl --request GET \
     --url 'https://svc.blockdaemon.com/reporting/staking/v2/solana/mainnet/validator/yield?denomination=lamports&raw=false' \
     --header 'X-API-Key: ••••' \
     --header 'accept: application/json'