Skip to main content

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations REST API Endpoint

Queries delegate info for given validator.

Updated on
May 9, 2024

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations REST API Endpoint

Path Parameters

validator_addr
string
REQUIRED
The validator address to query for

Query Parameters

pagination.key
string
The value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set
pagination.offset
string
The numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set
pagination.limit
string
The total number of results to be returned in the result page. If left empty it will default to a value to be set by each app
pagination.count_total
boolean
When set to true it indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set
pagination.reverse
boolean
It is set to true if results are to be returned in the descending order

Returns

delegation_responses
array
An array containing information about delegations
delegation
object
The delegation object which contains the following fields:
delegator_address
string
The address of the delegator
validator_address
string
The address of the validator to which the tokens are being delegated
shares
string
The number of shares delegated to the validator
balance
object
The balance object which contains the following fields:
denom
string
The denomination of the token being delegated
amount
string
The amount of tokens being delegated
pagination
object
The pagination object which contains the following fields:
next_key
string
A key used for retrieving the next page of data, if available
total
string
The total number of delegations in the dataset
Request
1
curl --location 'https://docs-demo.sei-pacific.quiknode.pro/cosmos/staking/v1beta1/validators/seivaloper1q2k0p9x6f5jlvnsdzu7cj2k9jfp9ee22cvqya4/delegations'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free