Skip to main content
GET
/
v1
/
babylon
/
finalityProviders
/
{finality_provider}
/
rewards
Get finality provider rewards metrics
curl --request GET \
  --url https://api.rated.network/v1/babylon/finalityProviders/{finality_provider}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "next": "https://api.rated.network//v1/babylon/finalityProviders/{finality_provider}/rewards?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/babylon/finalityProviders/{finality_provider}/rewards?limit=10&offset=10",
  "results": [
    [
      {
        "btcAddress": "bc1p3j9zphqncyj2c8m657hkngf6fcfp406exnnt8pxx6y79vclacces468ehv",
        "btcPubkey": "8c8a20dc13c124ac1f7aa7af69a13a4e121abf5934e6b384c6d13c5663fdc633",
        "commissionRate": 0.03,
        "day": "2025-01-21",
        "finalityProviderAddress": "bbn14q9h3m6fy9d66p6mzdksc55lq3ug7djdhxp0a0",
        "finalityProviderName": "Babylon Labs 1",
        "fromBlockNumber": 100001,
        "toBlockNumber": 107701,
        "token": "BBN",
        "totalCommissionRewards": 1357.0956718392758,
        "totalDelegationRewards": 45236.52239464253
      }
    ]
  ]
}
Using this endpoint, you can query the historical daily rewards of a finality provider by their unique finality_provider identifier/s. This identifier can be their Babylon address, BTC public key, or BTC address. totalDelegationRewards are the rewards, with its denomination specified by the token field, which delegators are entitled to receive from the finality provider they have staked to. The rewards from the commission a finality provider charges are given by the totalCommissionRewards. You can use the fromDate and toDate parameters to query a range of days.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
finality_provider
string
required

Query Parameters

​
limit
integer
default:10

The number of results returned per page

​
offset
integer
default:0

The number of results to skip before starting to return

​
fromDate
string<date> | null

Start date

Examples:

"2023-01-01"

​
toDate
string<date> | null

End date

Examples:

"2023-12-31"

Response

Successful Response

​
previous
string | null
required
​
next
string | null
required
​
pages
integer
required
Required range: x >= 0
​
results
BabylonFinalityProviderRewards · object[]
required
⌘I