Skip to main content

/cosmos/staking/v1beta1/delegations/{delegator_addr} REST API Endpoint

Queries all delegations of a given delegator address.

Updated on
May 09, 2024

Path Parameters

delegator_addr
string
REQUIRED

The delegator 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 | null

A key used for retrieving the next page of data, if available

total
string

The total number of delegations in the dataset

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free