Path Parameters

epoch

integer

REQUIRED

The epoch to get rewards info from

Body Parameters

public_key

array

REQUIRED

An array of either hex encoded public key (any bytes48 with 0x prefix) or validator index

Returns

execution_optimistic

boolean

A boolean indicating whether the execution of rewards for the specified epoch is done optimistically or not

finalized

boolean

(Optional) A boolean indicating whether the rewards for the specified epoch have been finalized

data

object

An object containing two arrays of reward-related information for attestations in the specified epoch

ideal_rewards

object

An array containing ideal reward metrics for attestations in the specified epoch

effective_balance

string

The effective balance for the ideal reward calculation

head

string

The reward for attesting to the head block

target

string

The reward for attesting to the target block

source

string

The reward for attesting to the source block

inclusion_delay

string

(Optional) The reward for including the attestation in a block with a specific delay

inactivity

string

(Optional) The inactivity penalty for the ideal reward calculation

total_rewards

object

An array containing total reward metrics for individual validators in the specified epoch

validator_index

string

The index of the validator

head

string

The reward for attesting to the head block for the specified validator

target

string

The reward for attesting to the target block for the specified validator

source

string

The reward for attesting to the source block for the specified validator

inclusion_delay

string

(Optional) The reward for including the attestation in a block with a specific delay for the specified validator

inactivity

string

(Optional) The inactivity penalty for the total reward calculation for the specified validator

Request

1
curl -X POST "https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -d '[
5
  "0"
6
]'

1
curl -X POST "https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json" \
4
  -d '[
5
  "0"
6
]'

1
const body = [
2
    "0"
3
]
4

5
async function main() {
6
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000', {
7
        method: 'POST',
8
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'},
9
        body: JSON.stringify(body)
10
    })
11
    const data = await response.json()
12
    console.log(data)
13
}
14

15
main()

1
const body = [
2
    "0"
3
]
4

5
async function main() {
6
    const response = await fetch('https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000', {
7
        method: 'POST',
8
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'},
9
        body: JSON.stringify(body)
10
    })
11
    const data = await response.json()
12
    console.log(data)
13
}
14

15
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000"
5

6
payload = json.dumps([
7
  "0"
8
])
9

10
headers = {
11
  'Content-Type': 'application/json',
12
  'Accept': 'application/json'
13
}
14

15
response = requests.request("POST", url, headers=headers, data=payload)
16

17
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000"
5

6
payload = json.dumps([
7
  "0"
8
])
9

10
headers = {
11
  'Content-Type': 'application/json',
12
  'Accept': 'application/json'
13
}
14

15
response = requests.request("POST", url, headers=headers, data=payload)
16

17
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000")
6

7
payload = [
8
  "0"
9
]
10

11
request = Net::HTTP::Post.new(uri)
12
request["Content-Type"] = "application/json"
13
request["Accept"] = "application/json"
14
request.body = JSON.generate(payload)
15

16
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
17
  http.request(request)
18
end
19

20
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/300000")
6

7
payload = [
8
  "0"
9
]
10

11
request = Net::HTTP::Post.new(uri)
12
request["Content-Type"] = "application/json"
13
request["Accept"] = "application/json"
14
request.body = JSON.generate(payload)
15

16
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
17
  http.request(request)
18
end
19

20
puts response.body

Response

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": {
5
    "ideal_rewards": [
6
      {
7
        "effective_balance": "1",
8
        "head": "2500",
9
        "target": "5000",
10
        "source": "5000",
11
        "inclusion_delay": "1",
12
        "inactivity": "5000"
13
      }
14
    ],
15
    "total_rewards": [
16
      {
17
        "validator_index": "1",
18
        "head": "2000",
19
        "target": "2000",
20
        "source": "4000",
21
        "inclusion_delay": "1",
22
        "inactivity": "2000"
23
      }
24
    ]
25
  }
26
}

1
{
2
  "execution_optimistic": false,
3
  "finalized": false,
4
  "data": {
5
    "ideal_rewards": [
6
      {
7
        "effective_balance": "1",
8
        "head": "2500",
9
        "target": "5000",
10
        "source": "5000",
11
        "inclusion_delay": "1",
12
        "inactivity": "5000"
13
      }
14
    ],
15
    "total_rewards": [
16
      {
17
        "validator_index": "1",
18
        "head": "2000",
19
        "target": "2000",
20
        "source": "4000",
21
        "inclusion_delay": "1",
22
        "inactivity": "2000"
23
      }
24
    ]
25
  }
26
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free