API Reference

Get rewards and APR stats for a specific Cosmos delegator

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

Stats Include:

  • Pending rewards available for claiming
  • Annual Percentage Rate (APR) based on validator performance
  • Time window used for APR calculation

APR Calculation:

  • Calculated backwards from historical validator rewards data
  • Based on validator's total delegation rewards over the time window
  • 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

Use Cases:

  • Display delegator's current pending rewards
  • Calculate estimated future rewards based on historical APR
  • Monitor validator performance over time

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

Language
Credentials
Header
Click Try It! to start a request and see the response here!