Skip to main content
GET
/
v1
/
babylon
/
btcDelegators
/
{delegator_address}
/
rewards
Get BTC delegator rewards metrics
curl --request GET \
  --url https://api.rated.network/v1/babylon/btcDelegators/{delegator_address}/rewards \
  --header 'Authorization: Bearer <token>'
{
  "next": "https://api.rated.network//v1/babylon/btcDelegators/{delegator_address}/rewards?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/babylon/btcDelegators/{delegator_address}/rewards?limit=10&offset=10",
  "results": [
    [
      {
        "day": "2025-01-21",
        "delegator": "bbn1g6tgaz3pmk03gvgndh8rwrv5yktrjhvvvyaplq",
        "delegatorBtcAddress": "bc1p7cs5gfwqk6gz7dgw5du4fp7y9hxw73d3lxr52lwtp99q2uzvx3sq60fs0q",
        "delegatorBtcPubkey": "035cd78812a37267f17f8c9b21df5c0e3f85c79bb9c410fe567b2633f35f7092c8",
        "delegatorRewards": 4523.5223,
        "finalityProviderAddress": "bbn19cy5ndzllcqlrcyggsqjg4mu59kw8ewwwhhcxe",
        "finalityProviderBtcAddress": "bc1p0hsx4l7hscn5ffy2q0k4w3kp2dh0u7jq2ryjc8k2u2gf8qpnzexqxgxkj5",
        "finalityProviderBtcPubkey": "99cab14570d12633326afede842d3a9db729f671d2fa1b8a46585d3f62395c1c",
        "fromBabylonHeight": 100001,
        "fromBtcHeight": 40000,
        "toBabylonHeight": 107701,
        "toBtcHeight": 40001,
        "token": "BBN"
      }
    ]
  ]
}
Using this endpoint, you can query the historical daily rewards of a delegator by their unique delegator_address across finality providers they have delegated to. delegatorRewards are the Babylon rewards, with its denomination specified by the token field, which delegators are entitled to receive from the finality provider they have staked to. The finality provider they have staked to is given by the finality_provider_address field. You can use the fromDate and toDate parameters to query a range of days.

Authorizations

​
Authorization
string
header
required

Path Parameters

​
delegator_address
string
required

Query Parameters

​
limit
integer
default:10
​
offset
integer
default:0
​
fromDate
string<date> | null
Examples:
​
toDate
string<date> | null
Examples:

Response

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