Stakes

get https://api.kiln.fi/v1/osmo/stakes

Get the status of OSMO stakes. Units are in uOSMO (10⁻⁶ OSMO).

Responses

Response body

object

data

array of objects

required

data*

object

validator_address

string

required

Public key of the validator

delegator_address

string

required

Public key of the delegator

delegated_at

date-time

Date of first delegation ever for the stake. Unavailable for stakes older than Theta v7 (12/04/2022).

delegated_block

number

Block of first delegation ever for the stake. Unavailable for stakes older than Theta v7 (12/04/2022).

undelegated_at

date-time

Date of undelegation for the stake

undelegated_block

number

Block of undelegation for the stake

rewards

string

required

Total rewards accumulated by this stake since its first ever delegation in uOSMO. Includes currently available rewards not yet withdrawn.

available_rewards

string

required

Available rewards in uOSMO that can be withdrawn from this stake

balance

string

required

Staked balance on this stake in uOSMO

net_apy

number

required

Net annual percentage yield. Unavailable for stakes older than Theta v7 (12/04/2022).

state

string

required

State of the Osmosis stake

active deactivating inactive

updated_at

date-time

Last date this data was updated

permissions

array of objects

required

permissions related to the stake currently active, ignored if there is no ongoing grants

permissions*

object

source

string

whether the stake is recipient (grantee) or the giver (granter) of the permissions

creation_height

number

Block at which the unbonding was created

permission

string

Kind of permission been grantee, can be: "Staking.MsgDelegate", "Staking.MsgUndelegate", "Staking.MsgRedelegate" or "Distribution.MsgWithdrawDelegatorReward"

expires_at

date-time | null

Exact time at which the permissions will be revoked

allow_list

array of strings | null

List of address on which the granted permission can be applied (ie validator on which delegation is allowed)

allow_list

deny_list

array of strings | null

List of address on which the granted permission cannot be applied (ie validator on which delegation is allowed)

deny_list

unbondings

array of objects

required

unbondings currently active on the stakes. ignored if no unbondings are returned

unbondings*

object

creation_height

number

required

Block at which the unbonding was created

completion_time

date-time

required

Exact time at which the unbonding will take effect

balance

string

required

Amount currently associated with the unbonding (slashes included)

initial_balance

string

required

Amount expected at creation (slashes non-included)

400

Invalid parameters

401

Unauthorized

500

Internal server error

Language

Credentials

Bearer

URL


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.kiln.fi/v1/osmo/stakes \
3
     --header 'accept: application/json; charset=utf-8'


xxxxxxxxxx
42
}
1
{
2
  "data": [
3
    {
4
      "validator_address": "osmovaloper146mj09yzu3mvz7pmy4dvs4z9wr2mst7rq8p8gy",
5
      "delegator_address": "osmo1mfdn23y2ydnp6j3l3f8rw6r2gzazrmprgxn5xl",
6
      "delegated_at": "2023-06-16T03:13:23.058547Z",
7
      "delegated_block": 15739267,
8
      "undelegated_at": "2023-07-14T03:56:13.561156Z",
9
      "undelegated_block": 16126416,
10
      "rewards": "735573808534727891000000",
11
      "available_rewards": "36748808534727891000000",
12
      "balance": "6300000000000000000000000",
13
      "net_apy": 5.76,
14
      "state": "active",
15
      "updated_at": "2023-01-14T01:13:59Z",
16
      "permissions": [
17
        {
18
          "source": "granter",
19
          "creation_height": 15000000,
20
          "permission": "Staking.MsgDelegate",
21
          "expires_at": "2023-01-10T01:12:34Z",
22
          "allow_list": [
23
            "osmovaloper1xyz",
24
            "osmovaloper1abc"
25
          ],

200Successful operation