Skip to main content
GET
/
v1
/
babylon
/
btcDelegators
/
{delegator_address}
/
state
Get BTC delegator state information
curl --request GET \
  --url https://api.rated.network/v1/babylon/btcDelegators/{delegator_address}/state \
  --header 'Authorization: Bearer <token>'
{
  "next": "https://api.rated.network//v1/babylon/btcDelegators/{delegator_address}/state?limit=10&offset=30",
  "pages": 10,
  "previous": "https://api.rated.network//v1/babylon/btcDelegators/{delegator_address}/state?limit=10&offset=10",
  "results": [
    [
      {
        "activeStake": 1.5,
        "day": "2025-01-21",
        "delegator": "bbn1g6tgaz3pmk03gvgndh8rwrv5yktrjhvvvyaplq",
        "delegatorBtcAddress": "bc1p7cs5gfwqk6gz7dgw5du4fp7y9hxw73d3lxr52lwtp99q2uzvx3sq60fs0q",
        "delegatorBtcPubkey": "035cd78812a37267f17f8c9b21df5c0e3f85c79bb9c410fe567b2633f35f7092c8",
        "finalityProviderAddress": "bbn19cy5ndzllcqlrcyggsqjg4mu59kw8ewwwhhcxe",
        "finalityProviderBtcAddress": "bc1p0hsx4l7hscn5ffy2q0k4w3kp2dh0u7jq2ryjc8k2u2gf8qpnzexqxgxkj5",
        "finalityProviderBtcPubkey": "99cab14570d12633326afede842d3a9db729f671d2fa1b8a46585d3f62395c1c",
        "fromBabylonHeight": 100001,
        "fromBtcHeight": 40000,
        "toBabylonHeight": 107701,
        "toBtcHeight": 40001
      }
    ]
  ]
}
Using this endpoint, you can query the historical daily stake balance of a delegator by their unique Babylon Genesis address. The results are per individual finality provider that the delegator has staked to. 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

​
delegator_address
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
BabylonBtcDelegatorStake · object[]
required
⌘I