API Reference

Get rewards and APR stats for a specific ZkVerify delegator

get
https://api.stake.fish/api/v1/chains/zkverify/rewards/

Retrieve rewards and APR statistics for a delegator with the stake.fish validator.

APR Calculation:

  • Calculated backwards from historical validator rewards data
  • Based on validator's total delegation rewards over the time window and current total delegation amount
  • Assumes constant delegation amount for the time window (any changes will affect the calculation)
  • Net of validator commission
  • Parametrized by time window (7d or 30d)

Time Windows:

  • 7d: APR calculated from last 7 days of validator rewards (default)
  • 30d: APR calculated from last 30 days of validator rewards

Note: For delegation amounts and staking information, use the /stakes/:address endpoint

Path Params
string
required

zkVerify address of the delegator

Query Params
string
enum
Defaults to 7d

Time window for APR calculation

Allowed:
Responses

400

Invalid delegator address or time window parameter

404

No delegation found for this address with stake.fish validator

503

Failed to fetch delegator stats or rewards data

Updated about 1 month ago

Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated about 1 month ago