Validator Rewards by Pubkey
Paginated reward buckets aggregated by epoch, day, week, or month for a validator identified by BLS pubkey.
Cost: 1 credit per call. Automatically refunded on 4xx/5xx responses.
Access: Requires portfolio entitlement.
Rate limit: 360 req/min (shared with portfolio bucket)
Get your API key: Dev Portal
Documentation Index
Fetch the complete documentation index at: https://docs.octav.fi/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
48-byte BLS pubkey, hex-encoded with 0x prefix (96 hex characters). Case-insensitive.
^0x[a-fA-F0-9]{96}$Query Parameters
Determines how rangeFrom/rangeTo are interpreted. timestamp = Unix seconds (max range 31,536,000 s); epoch = beacon epoch numbers (max range 82,125 epochs).
timestamp, epoch Start of the range (inclusive). Must be ≥ 0 and ≤ rangeTo. Interpreted per rangeType.
x >= 0End of the range (inclusive). Must be ≥ 0. Interpreted per rangeType.
x >= 0Bucket size for aggregation.
epoch, day, week, month Pagination offset.
Number of records to return. Max 10.
x <= 10