Returns net rewards, as received by withdrawal addresses

• This is the endpoint to use if you are using Onchain Billing
• Returns all consensus layer (CL) rewards swept to wallet + execution layer (EL) rewards (with onchain split)
• Note that any CL rewards that have been earned but not yet swept to your wallet are not included in the response

General features described in Rewards Overview

network

• type: string
• enum: required
• Description: Network to stake on.

Allowed:

• mainnet
• hoodi

start

• type: string
• required
• Description: Rewards received after this date

end

• type: string
• required
• Description: Rewards received before this date

Response Structure

200 Got rewards

• type: object
• properties:
  • data:
    • type: array of objects
      • object:
        • wallet: string
        • timestamp: string
        • rewards: array
          • object:
            • type: string
            • pubkey: string
            • index: integer
            • tx_hash: string
            • timestamp: string
            • block: integer
            • payees: array of objects
              • object:
                • address: string
                • amount: string
                • network: string

Sample CURL Request

curl --request POST \
     --url https://api.figment.io/ethereum/rewards_net \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: your-api-key-here' \
     --data '{\
  "network": "mainnet"\
}'

Example Response

{
  "data": [
    {
      "wallet": "string",
      "timestamp": "string",
      "rewards": [
        {
          "type": "execution",
          "pubkey": "0x9027ebabf426534ae093b552880616acf5c487a89fb6de124785387200719f17c4161a07a933c335a16b38b2ce907e7f",
          "index": 2345,
          "tx_hash": "0x3a340300942ea74c8d8029dc82160609f36c27196e9daf7dd3e69dae81447463",
          "timestamp": "2024-10-24T00:01:00Z",
          "block": 2000034,
          "payees": [
            {
              "address": "string",
              "amount": "string"
            }
          ],
          "network": "hoodi"
        },
        {
          "type": "withdrawal",
          "pubkey": "0x9027ebabf426534ae093b552880616acf5c487a89fb6de124785387200719f17c4161a07a933c335a16b38b2ce907e7f",
          "index": 2345,
          "amount": "string",
          "withdrawal_address": "0xe86154635fd73979fef12b65a5683f06054ae8a3",
          "block": 2000034,
          "epoch": 2345,
          "slot": 234,
          "network": "hoodi"
        }
      ]
    }
  ]
}