Skip to main content
GET
Validator Rewards by Pubkey

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

pubkey
string
required

48-byte BLS pubkey, hex-encoded with 0x prefix (96 hex characters). Case-insensitive.

Pattern: ^0x[a-fA-F0-9]{96}$

Query Parameters

rangeType
enum<string>
required

Determines how rangeFrom/rangeTo are interpreted. timestamp = Unix seconds (max range 31,536,000 s); epoch = beacon epoch numbers (max range 82,125 epochs).

Available options:
timestamp,
epoch
rangeFrom
integer
required

Start of the range (inclusive). Must be ≥ 0 and ≤ rangeTo. Interpreted per rangeType.

Required range: x >= 0
rangeTo
integer
required

End of the range (inclusive). Must be ≥ 0. Interpreted per rangeType.

Required range: x >= 0
granularity
enum<string>
required

Bucket size for aggregation.

Available options:
epoch,
day,
week,
month
offset
number
default:0

Pagination offset.

limit
number
default:10

Number of records to return. Max 10.

Required range: x <= 10

Response

Paginated validator rewards

data
object[]
offset
number

Current pagination offset

limit
number

Records per page

totalRows
number

Total number of matching buckets

pages
number

Total number of pages