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>'
{
  "previous": "<string>",
  "next": "<string>",
  "pages": 1,
  "results": [
    {
      "day": "2023-12-25",
      "fromBabylonHeight": 123,
      "toBabylonHeight": 123,
      "fromBtcHeight": 123,
      "toBtcHeight": 123,
      "delegator": "<string>",
      "delegatorBtcPubkey": "<string>",
      "delegatorBtcAddress": "<string>",
      "finalityProviderAddress": "<string>",
      "finalityProviderBtcAddress": "<string>",
      "finalityProviderBtcPubkey": "<string>",
      "activeStake": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rated.network/llms.txt

Use this file to discover all available pages before exploring further.

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

Example:

"2023-01-01"

​
toDate
string<date> | null

End date

Example:

"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