Allora — Cosmos REST methods (2/4)

API reference for Allora. All methods ->

Part 2 of 4: 1 · 2 · 3 · 4

Cosmos REST methods

`/cosmos/slashing/v1beta1/signing_infos`

Retrieves signing info of all validators.

Parameters

pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

The signing info of all validators.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/slashing/v1beta1/signing_infos

Response example

{
  "info": [
    {
      "address": "string",
      "start_height": "string",
      "index_offset": "string",
      "jailed_until": "2021-01-19T06:33:32.230Z",
      "tombstoned": true,
      "missed_blocks_counter": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/slashing/v1beta1/signing_infos/{cons_address}`

Retrieves the signing info of given cons address.

Parameters

cons_address (string, required): an address to query signing info for.

Returns

The signing info of all specified cons address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Response example

{
  "val_signing_info": {
    "address": "string",
    "start_height": "string",
    "index_offset": "string",
    "jailed_until": "2021-01-19T06:34:40.106Z",
    "tombstoned": true,
    "missed_blocks_counter": "string"
  }
}

Staking methods

`/cosmos/staking/v1beta1/delegations/{delegator_addr}`

Retrieves all delegations of a given delegator address.

Parameters

delegator_addr (string, required): a delegator address to query for.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Delegations from a specific delegator address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/delegations/{delegator_addr}

Response example

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations`

Retrieves the redelegations of a given address.

Parameters

delegator_addr (string, required): a delegator address to query for.
src_validator_addr (string): the validator address to redelegate from.
dst_validator_addr (string): the validator address to redelegate to.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key string, uint64: a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Delegations from a specific delegator address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

Response example

{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "string",
        "validator_src_address": "string",
        "validator_dst_address": "string",
        "entries": [
          {
            "creation_height": "string",
            "completion_time": "2021-01-19T06:58:45.718Z",
            "initial_balance": "string",
            "shares_dst": "string"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "string",
            "completion_time": "2021-01-19T06:58:45.718Z",
            "initial_balance": "string",
            "shares_dst": "string"
          },
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations`

Retrieves all unbonding delegations of a given delegator address.

Parameters

delegator_addr (string, required): a delegator address to query for.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Unbonding delegations from a specific delegator address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Response example

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2021-01-19T07:01:25.628Z",
          "initial_balance": "string",
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators`

Retrieves all validators info for given delegator address.

Parameters

delegator_addr (string; required): a delegator address to query for.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Validator info for a specific delegator address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

Response example

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2021-01-19T07:06:38.006Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2021-01-19T07:06:38.006Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}`

Retrieves validator info for a given delegator-validator pair.

Parameters

delegator_addr (string; required): a delegator address to query for.
validator_addr (string; required): a validator address to query for.

Returns

Validator info for a given delegator pair.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}

Response example

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2021-01-19T07:08:34.100Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2021-01-19T07:08:34.100Z"
    },
    "min_self_delegation": "string"
  }
}

`/cosmos/staking/v1beta1/historical_info/{height}`

Retrieves the historical info for a given height.

Parameters

height (string, int64): defines at which height to query the historical info for.

Returns

Historical info for a given height.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/historical_info/{height}

Response example

{
  "hist": {
    "header": {
      "version": {
        "block": "string",
        "app": "string"
      },
      "chain_id": "string",
      "height": "string",
      "time": "2021-01-19T07:13:57.974Z",
      "last_block_id": {
        "hash": "string",
        "part_set_header": {
          "total": 0,
          "hash": "string"
        }
      },
      "last_commit_hash": "string",
      "data_hash": "string",
      "validators_hash": "string",
      "next_validators_hash": "string",
      "consensus_hash": "string",
      "app_hash": "string",
      "last_results_hash": "string",
      "evidence_hash": "string",
      "proposer_address": "string"
    },
    "valset": [
      {
        "operator_address": "string",
        "consensus_pubkey": {
          "type_url": "string",
          "value": "string"
        },
        "jailed": true,
        "status": "BOND_STATUS_UNSPECIFIED",
        "tokens": "string",
        "delegator_shares": "string",
        "description": {
          "moniker": "string",
          "identity": "string",
          "website": "string",
          "security_contact": "string",
          "details": "string"
        },
        "unbonding_height": "string",
        "unbonding_time": "2021-01-19T07:13:57.974Z",
        "commission": {
          "commission_rates": {
            "rate": "string",
            "max_rate": "string",
            "max_change_rate": "string"
          },
          "update_time": "2021-01-19T07:13:57.974Z"
        },
        "min_self_delegation": "string"
      }
    ]
  }
}

`/cosmos/staking/v1beta1/params`

Retrieves the staking parameters.

Parameters

None.

Returns

Staking parameters.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/params

Response example

{
  "params": {
    "unbonding_time": "string",
    "max_validators": 0,
    "max_entries": 0,
    "historical_entries": 0,
    "bond_denom": "string"
  }
}

`/cosmos/staking/v1beta1/pool`

Retrieves the pool info.

Parameters

None.

Returns

Pool info.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/pool

Response example

{
  "pool": {
    "not_bonded_tokens": "string",
    "bonded_tokens": "string"
  }
}

/cosmos/staking/v1beta1/validators

Retrieves all validators that match the given status.

Parameters

status (string): a status to query validators by.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Validators that match the given status.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators

Response example

{
  "validators": [
    {
      "operator_address": "string",
      "consensus_pubkey": {
        "type_url": "string",
        "value": "string"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "string",
      "delegator_shares": "string",
      "description": {
        "moniker": "string",
        "identity": "string",
        "website": "string",
        "security_contact": "string",
        "details": "string"
      },
      "unbonding_height": "string",
      "unbonding_time": "2021-01-19T07:21:25.914Z",
      "commission": {
        "commission_rates": {
          "rate": "string",
          "max_rate": "string",
          "max_change_rate": "string"
        },
        "update_time": "2021-01-19T07:21:25.914Z"
      },
      "min_self_delegation": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}`

Retrieves validator info for a given validator address.

Parameters

validator_addr (string; required): a validator address to query for.

Returns

Validator info for a given validator address.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators/{validator_addr}

Response example

{
  "validator": {
    "operator_address": "string",
    "consensus_pubkey": {
      "type_url": "string",
      "value": "string"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "string",
    "delegator_shares": "string",
    "description": {
      "moniker": "string",
      "identity": "string",
      "website": "string",
      "security_contact": "string",
      "details": "string"
    },
    "unbonding_height": "string",
    "unbonding_time": "2021-01-19T07:25:26.679Z",
    "commission": {
      "commission_rates": {
        "rate": "string",
        "max_rate": "string",
        "max_change_rate": "string"
      },
      "update_time": "2021-01-19T07:25:26.679Z"
    },
    "min_self_delegation": "string"
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations`

Retrieves delegate info for a given validator.

Parameters

validator_addr (string; required): a validator address to query for.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key string, uint64: a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Delegate info for a given validator.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Response example

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "string",
        "validator_address": "string",
        "shares": "string"
      },
      "balance": {
        "denom": "string",
        "amount": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}`

Retrieves delegate info for a given validator-delegator pair.

Parameters

validator_addr (string; required): a validator address to query for.
delegator_addr (string; required): a delegator address to query for.

Returns

Delegate info for a given validator delegator pair.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Response example

{
  "delegation_response": {
    "delegation": {
      "delegator_address": "string",
      "validator_address": "string",
      "shares": "string"
    },
    "balance": {
      "denom": "string",
      "amount": "string"
    }
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation`

Retrieves unbonding info for a given validator-delegator pair.

Parameters

validator_addr (string; required): a validator address to query for.
delegator_addr (string; required): a delegator address to query for.

Returns

Unbonding info for a given validator delegator pair.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Response example

{
  "unbond": {
    "delegator_address": "string",
    "validator_address": "string",
    "entries": [
      {
        "creation_height": "string",
        "completion_time": "2021-01-19T07:35:28.235Z",
        "initial_balance": "string",
        "balance": "string"
      }
    ]
  }
}

`/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations`

Retrieves unbonding delegations of a validator.

Parameters

validator_addr (string, required): a validator address to query for.
pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns

Unbonding info for a given validator.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Response example

{
  "unbonding_responses": [
    {
      "delegator_address": "string",
      "validator_address": "string",
      "entries": [
        {
          "creation_height": "string",
          "completion_time": "2021-01-19T07:37:20.281Z",
          "initial_balance": "string",
          "balance": "string"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

Upgrade methods

`/cosmos/upgrade/v1beta1/applied_plan/{name}`

Retrieves a previously applied upgrade plan by its name.

Parameters

name (string; required): a name of the applied plan to query for.

Returns

Previously applied upgrade plan.

Request example

curl https://rpc.ankr.com/http/allora_cosmos_testnet/cosmos/upgrade/v1beta1/applied_plan/{name}

Response example

{
  "height": "string"
}

Cosmos REST methods​

/cosmos/slashing/v1beta1/signing_infos​

Parameters​

Returns​

Request example​

Response example​

/cosmos/slashing/v1beta1/signing_infos/{cons_address}​

Parameters​

Returns​

Request example​

Response example​

Staking methods​

/cosmos/staking/v1beta1/delegations/{delegator_addr}​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/historical_info/{height}​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/params​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/pool​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators/{validator_addr}​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation​

Parameters​

Returns​

Request example​

Response example​

/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations​

Parameters​

Returns​

Cosmos REST methods

`/cosmos/slashing/v1beta1/signing_infos`

Parameters

Returns

Request example

Response example

`/cosmos/slashing/v1beta1/signing_infos/{cons_address}`

Parameters

Returns

Request example

Response example

Staking methods

`/cosmos/staking/v1beta1/delegations/{delegator_addr}`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/historical_info/{height}`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/params`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/pool`

Parameters

Returns

Request example

Response example

/cosmos/staking/v1beta1/validators

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/validators/{validator_addr}`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation`

Parameters

Returns

Request example

Response example

`/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations`

Parameters

Returns