This guide will help you monitor the performance of your Ethereum validators using stakefish API. You'll learn how to track both individual and aggregated validator performance over time.

Validator Performance

To track single or multiple validator performance, you can use the following API endpoint (it is public):

curl -X POST "https://api.testnet.stake.fish/v1/eth/rewards/v2/rewards/stats" \
    -H 'Content-Type: application/json' \
    --data '{
        "validatorIndices": [1803068],
        "startDate": "2024-08-28", 
        "endDate": "2024-09-03"
    }'

Explanation of Fields:

validatorIndices: Specifies the list of validator indices. Keep in mind it will return aggregated data for all selected validators.
startDate: Start date in YYYY-MM-DD format.
endDate: End date in YYYY-MM-DD format. You can check the latest available date using the syncing endpoint.

Stakefish tracks rewards using UTC time. Always.

Example Response

After sending the POST request, you’ll receive a response similar to the following:

{
  "percentageTotal": "1.4525487427734375",
  "percentageExecution": "0",
  "percentageConsensus": "1.4525487427734375",
  "estimatedTotalIncome": "5090383000000000",
  "estimatedConsensusIncome": "5090383000000000",
  "estimatedExecutionIncome": "0",
  "aprType": "backward",
  "timeWindow": "7d"
}

Visualizing the Data

Here you can find examples, how stakefish is using this endpoint to display wallet's annual reward rates: