Home

Cosmos SDK - gRPC Gateway docs

v1.0.0
Base URL
https://band-rest.nownodes.io

A REST interface for state queries.

Authentication

api-keyAuthapiKey

API Key: api-key in header

Cosmos

Auth

AccountInfo queries account info which is common to all account types.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/account_info/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.47

Parameters

addressstringrequiredpath

address is the account address string.

Response

200OK

A successful response.

default

An unexpected error response.

Accounts returns all the existing accounts.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/accounts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Since: cosmos-sdk 0.43

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Account returns account details based on address.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/accounts/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address defines the address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

AccountAddressByID returns account address based on account number.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/address_by_id/{id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46.2

Parameters

idstring<int64>requiredpath

Deprecated, use account_id instead

id is the account number of the address to be queried. This field should have been an uint64 (like all account numbers), and will be updated to uint64 in a future version of the auth query.

account_idstring<uint64>query

account_id is the account number of the address to be queried.

Since: cosmos-sdk 0.47

Response

200OK

A successful response.

default

An unexpected error response.

Bech32Prefix queries bech32Prefix

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/bech32

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

AddressBytesToString converts Account Address bytes to string

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/bech32/{address_bytes}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

address_bytesstring<byte>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

AddressStringToBytes converts Address string to bytes

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/bech32/{address_string}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

address_stringstringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

ModuleAccounts returns all the existing module accounts.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/module_accounts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

ModuleAccountByName returns the module account info by module name

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/module_accounts/{name}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

namestringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Params queries all parameters.

GET
https://band-rest.nownodes.io/cosmos/auth/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Bank

AllBalances queries the balance of all coins for a single account.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/balances/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

addressstringrequiredpath

address is the address to query balances for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

resolve_denombooleanquery

resolve_denom is the flag to resolve the denom into a human-readable form from the metadata.

Since: cosmos-sdk 0.50

Response

200OK

A successful response.

default

An unexpected error response.

Balance queries the balance of a single coin for a single account.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/balances/{address}/by_denom

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

addressstringrequiredpath

address is the address to query balances for.

denomstringquery

denom is the coin denom to query balances for.

Response

200OK

A successful response.

default

An unexpected error response.

DenomOwners queries for all account addresses that own a particular token denomination.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/denom_owners/{denom}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Since: cosmos-sdk 0.46

Parameters

denomstringrequiredpath

denom defines the coin denomination to query all account holders for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DenomOwnersByQuery queries for all account addresses that own a particular token denomination.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/denom_owners_by_query

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.50.3

Parameters

denomstringquery

denom defines the coin denomination to query all account holders for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DenomsMetadata queries the client metadata for all registered coin denominations.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/denoms_metadata

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DenomMetadata queries the client metadata of a given coin denomination.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/denoms_metadata/{denom}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

denomstringrequiredpath

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

DenomMetadataByQueryString queries the client metadata of a given coin denomination.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/denoms_metadata_by_query_string

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

denomstringquery

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

Params queries the parameters of x/bank module.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

SendEnabled queries for SendEnabled entries.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/send_enabled

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

This query only returns denominations that have specific SendEnabled settings. Any denomination that does not have a specific setting will use the default params.default_send_enabled, and will not be returned by this query.

Since: cosmos-sdk 0.47

Parameters

denomsArray<string>query

denoms is the specific denoms you want look up. Leave empty to get all entries.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

SpendableBalances queries the spendable balance of all coins for a single account.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Since: cosmos-sdk 0.46

Parameters

addressstringrequiredpath

address is the address to query spendable balances for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

SpendableBalanceByDenom queries the spendable balance of a single denom for a single account.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}/by_denom

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Since: cosmos-sdk 0.47

Parameters

addressstringrequiredpath

address is the address to query balances for.

denomstringquery

denom is the coin denom to query balances for.

Response

200OK

A successful response.

default

An unexpected error response.

TotalSupply queries the total supply of all coins.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/supply

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

SupplyOf queries the supply of a single coin.

GET
https://band-rest.nownodes.io/cosmos/bank/v1beta1/supply/by_denom

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

denomstringquery

denom is the coin denom to query balances for.

Response

200OK

A successful response.

default

An unexpected error response.

Base

ABCIQuery defines a query handler that supports ABCI queries directly to the application, bypassing Tendermint completely. The ABCI query must contain a valid and supported path, including app, custom, p2p, and store.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/abci_query

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

datastring<byte>query
pathstringquery
heightstring<int64>query
provebooleanquery

Response

200OK

A successful response.

default

An unexpected error response.

GetLatestBlock returns the latest block.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/latest

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

GetBlockByHeight queries block for given height.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/{height}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

heightstring<int64>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

GetNodeInfo queries the current node info.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/node_info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

GetSyncing queries node syncing.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/syncing

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

GetLatestValidatorSet queries latest validator-set.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/latest

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

GetValidatorSetByHeight queries validator-set at a given height.

GET
https://band-rest.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/{height}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

heightstring<int64>requiredpath
pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Config queries for the operator configuration.

GET
https://band-rest.nownodes.io/cosmos/base/node/v1beta1/config

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Status queries for the node status.

GET
https://band-rest.nownodes.io/cosmos/base/node/v1beta1/status

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Distribution

CommunityPool queries the community pool coins.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/community_pool

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

DelegationTotalRewards queries the total rewards accrued by each validator.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

DelegationRewards queries the total rewards accrued by a delegation.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

DelegatorValidators queries the validators of a delegator.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

DelegatorWithdrawAddress queries withdraw address of a delegator.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Params queries params of the distribution module.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorCommission queries accumulated commission for a validator.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/commission

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorOutstandingRewards queries rewards of a validator address.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorSlashes queries slash events of a validator.

GET
https://band-rest.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/slashes

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

starting_heightstring<uint64>query

starting_height defines the optional starting height to query the slashes.

ending_heightstring<uint64>query

starting_height defines the optional ending height to query the slashes.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Evidence

AllEvidence queries all evidence.

GET
https://band-rest.nownodes.io/cosmos/evidence/v1beta1/evidence

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Evidence queries evidence based on evidence hash.

GET
https://band-rest.nownodes.io/cosmos/evidence/v1beta1/evidence/{hash}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

hashstringrequiredpath

hash defines the evidence hash of the requested evidence.

Since: cosmos-sdk 0.47

evidence_hashstring<byte>query

evidence_hash defines the hash of the requested evidence. Deprecated: Use hash, a HEX encoded string, instead.

Response

200OK

A successful response.

default

An unexpected error response.

Cosmos

Params queries all parameters of the gov module.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/params/{params_type}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

params_typestringrequiredpath

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

Response

200OK

A successful response.

default

An unexpected error response.

GetTxsEvent fetches txs by event.

GET
https://band-rest.nownodes.io/cosmos/tx/v1beta1/txs

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

eventsArray<string>query

events is the list of transaction event type. Deprecated post v0.47.x: use query instead, which should contain a valid events query.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

order_bystringORDER_BY_UNSPECIFIEDORDER_BY_ASCORDER_BY_DESCORDER_BY_UNSPECIFIEDquery
  • ORDER_BY_UNSPECIFIED: ORDER_BY_UNSPECIFIED specifies an unknown sorting order. OrderBy defaults to ASC in this case.
  • ORDER_BY_ASC: ORDER_BY_ASC defines ascending order
  • ORDER_BY_DESC: ORDER_BY_DESC defines descending order
pagestring<uint64>query

page is the page number to query, starts at 1. If not provided, will default to first page.

limitstring<uint64>query

limit is 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.

querystringquery

query defines the transaction event query that is proxied to Tendermint's TxSearch RPC method. The query must be valid.

Since cosmos-sdk 0.50

Response

200OK

A successful response.

default

An unexpected error response.

Gov

Proposals queries all proposals based on given status.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_statusstringPROPOSAL_STATUS_UNSPECIFIEDPROPOSAL_STATUS_DEPOSIT_PERIODPROPOSAL_STATUS_VOTING_PERIODPROPOSAL_STATUS_PASSEDPROPOSAL_STATUS_REJECTEDPROPOSAL_STATUS_FAILEDPROPOSAL_STATUS_UNSPECIFIEDquery

proposal_status defines the status of the proposals.

  • PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
  • PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
  • PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
  • PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
  • PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
  • PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.
voterstringquery

voter defines the voter address for the proposals.

depositorstringquery

depositor defines the deposit addresses from the proposals.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Proposal queries proposal details based on ProposalID.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Deposits queries all deposits of a single proposal.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Deposit queries single deposit information based on proposalID, depositor address.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits/{depositor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

depositorstringrequiredpath

depositor defines the deposit addresses from the proposals.

Response

200OK

A successful response.

default

An unexpected error response.

TallyResult queries the tally of a proposal vote.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Votes queries votes of a given proposal.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/votes

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Vote queries voted information based on proposalID, voterAddr.

GET
https://band-rest.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/votes/{voter}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

voterstringrequiredpath

voter defines the voter address for the proposals.

Response

200OK

A successful response.

default

An unexpected error response.

Constitution queries the chain's constitution.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/constitution

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Params queries all parameters of the gov module.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/params/{params_type}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

params_typestringrequiredpath

params_type defines which parameters to query for, can be one of "voting", "tallying" or "deposit".

Response

200OK

A successful response.

default

An unexpected error response.

Proposals queries all proposals based on given status.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_statusstringPROPOSAL_STATUS_UNSPECIFIEDPROPOSAL_STATUS_DEPOSIT_PERIODPROPOSAL_STATUS_VOTING_PERIODPROPOSAL_STATUS_PASSEDPROPOSAL_STATUS_REJECTEDPROPOSAL_STATUS_FAILEDPROPOSAL_STATUS_UNSPECIFIEDquery

proposal_status defines the status of the proposals.

  • PROPOSAL_STATUS_UNSPECIFIED: PROPOSAL_STATUS_UNSPECIFIED defines the default proposal status.
  • PROPOSAL_STATUS_DEPOSIT_PERIOD: PROPOSAL_STATUS_DEPOSIT_PERIOD defines a proposal status during the deposit period.
  • PROPOSAL_STATUS_VOTING_PERIOD: PROPOSAL_STATUS_VOTING_PERIOD defines a proposal status during the voting period.
  • PROPOSAL_STATUS_PASSED: PROPOSAL_STATUS_PASSED defines a proposal status of a proposal that has passed.
  • PROPOSAL_STATUS_REJECTED: PROPOSAL_STATUS_REJECTED defines a proposal status of a proposal that has been rejected.
  • PROPOSAL_STATUS_FAILED: PROPOSAL_STATUS_FAILED defines a proposal status of a proposal that has failed.
voterstringquery

voter defines the voter address for the proposals.

depositorstringquery

depositor defines the deposit addresses from the proposals.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Proposal queries proposal details based on ProposalID.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Deposits queries all deposits of a single proposal.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/deposits

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Deposit queries single deposit information based on proposalID, depositAddr.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/deposits/{depositor}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

depositorstringrequiredpath

depositor defines the deposit addresses from the proposals.

Response

200OK

A successful response.

default

An unexpected error response.

TallyResult queries the tally of a proposal vote.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/tally

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Votes queries votes of a given proposal.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/votes

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Vote queries voted information based on proposalID, voterAddr.

GET
https://band-rest.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/votes/{voter}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

voterstringrequiredpath

voter defines the voter address for the proposals.

Response

200OK

A successful response.

default

An unexpected error response.

Mint

AnnualProvisions current minting annual provisions value.

GET
https://band-rest.nownodes.io/cosmos/mint/v1beta1/annual_provisions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Inflation returns the current minting inflation value.

GET
https://band-rest.nownodes.io/cosmos/mint/v1beta1/inflation

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Params returns the total set of minting parameters.

GET
https://band-rest.nownodes.io/cosmos/mint/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Params

Params queries a specific parameter of a module, given its subspace and key.

GET
https://band-rest.nownodes.io/cosmos/params/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

subspacestringquery

subspace defines the module to query the parameter for.

keystringquery

key defines the key of the parameter in the subspace.

Response

200OK

A successful response.

default

An unexpected error response.

Subspaces queries for all registered subspaces and all keys for a subspace.

GET
https://band-rest.nownodes.io/cosmos/params/v1beta1/subspaces

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Slashing

Params queries the parameters of slashing module

GET
https://band-rest.nownodes.io/cosmos/slashing/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

SigningInfos queries signing info of all validators

GET
https://band-rest.nownodes.io/cosmos/slashing/v1beta1/signing_infos

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

SigningInfo queries the signing info of given cons address

GET
https://band-rest.nownodes.io/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

cons_addressstringrequiredpath

cons_address is the address to query signing info of

Response

200OK

A successful response.

default

An unexpected error response.

Staking

DelegatorDelegations queries all delegations of a given delegator address.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/delegations/{delegator_addr}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Redelegations queries redelegations of given address.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

src_validator_addrstringquery

src_validator_addr defines the validator address to redelegate from.

dst_validator_addrstringquery

dst_validator_addr defines the validator address to redelegate to.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DelegatorValidators queries all validators info for given delegator address.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

DelegatorValidator queries validator info for given delegator validator pair.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

HistoricalInfo queries the historical info for given height.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/historical_info/{height}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

heightstring<int64>requiredpath

height defines at which height to query the historical info.

Response

200OK

A successful response.

default

An unexpected error response.

Parameters queries the staking parameters.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/params

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Pool queries the pool info.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/pool

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

Validators queries all validators that match the given status.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

statusstringquery

status enables to query for validators matching a given status.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Validator queries validator info for given validator address.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorDelegations queries delegate info for given validator.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Delegation queries delegate info for given validator delegator pair.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

UnbondingDelegation queries unbonding info for given validator delegator pair.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

delegator_addrstringrequiredpath

delegator_addr defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

GET
https://band-rest.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Tx

TxDecode decodes the transaction.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/decode

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.47

Body

application/json

TxDecodeRequest is the request type for the Cosmos.TxDecode RPC method.

Since: cosmos-sdk 0.47

tx_bytesstring<byte>

tx_bytes is the raw transaction.

Response

200OK

A successful response.

default

An unexpected error response.

TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/decode/amino

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.47

Body

application/json

TxDecodeAminoRequest is the request type for the Cosmos.TxDecodeAmino RPC method.

Since: cosmos-sdk 0.47

amino_binarystring<byte>

Response

200OK

A successful response.

default

An unexpected error response.

TxEncode encodes the transaction.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/encode

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.47

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/encode/amino

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.47

Body

application/json

TxEncodeAminoRequest is the request type for the Cosmos.TxEncodeAmino RPC method.

Since: cosmos-sdk 0.47

amino_jsonstring

Response

200OK

A successful response.

default

An unexpected error response.

Simulate simulates executing a transaction for estimating gas usage.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/simulate

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

BroadcastTx broadcast transaction.

POST
https://band-rest.nownodes.io/cosmos/tx/v1beta1/txs

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Body

application/json

BroadcastTxRequest is the request type for the Cosmos.BroadcastTxRequest RPC method.

tx_bytesstring<byte>

tx_bytes is the raw transaction.

modestringBROADCAST_MODE_UNSPECIFIEDBROADCAST_MODE_BLOCKBROADCAST_MODE_SYNCBROADCAST_MODE_ASYNCBROADCAST_MODE_UNSPECIFIED

BroadcastMode specifies the broadcast mode for the TxCosmos.Broadcast RPC method.

  • BROADCAST_MODE_UNSPECIFIED: zero-value for mode ordering
  • BROADCAST_MODE_BLOCK: DEPRECATED: use BROADCAST_MODE_SYNC instead, BROADCAST_MODE_BLOCK is not supported by the SDK from v0.47.x onwards.
  • BROADCAST_MODE_SYNC: BROADCAST_MODE_SYNC defines a tx broadcasting mode where the client waits for a CheckTx execution response only.
  • BROADCAST_MODE_ASYNC: BROADCAST_MODE_ASYNC defines a tx broadcasting mode where the client returns immediately.

Response

200OK

A successful response.

default

An unexpected error response.

GetBlockWithTxs fetches a block with decoded txs.

GET
https://band-rest.nownodes.io/cosmos/tx/v1beta1/txs/block/{height}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.45.2

Parameters

heightstring<int64>requiredpath

height is the height of the block to query.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

GetTx fetches a tx by hash.

GET
https://band-rest.nownodes.io/cosmos/tx/v1beta1/txs/{hash}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

hashstringrequiredpath

hash is the tx hash to query, encoded as a hex string.

Response

200OK

A successful response.

default

An unexpected error response.

Upgrade

AppliedPlan queries a previously applied upgrade plan by its name.

GET
https://band-rest.nownodes.io/cosmos/upgrade/v1beta1/applied_plan/{name}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

namestringrequiredpath

name is the name of the applied plan to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Returns the account with authority to conduct upgrades

GET
https://band-rest.nownodes.io/cosmos/upgrade/v1beta1/authority

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

CurrentPlan queries the current upgrade plan.

GET
https://band-rest.nownodes.io/cosmos/upgrade/v1beta1/current_plan

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Response

200OK

A successful response.

default

An unexpected error response.

ModuleVersions queries the list of module versions from state.

GET
https://band-rest.nownodes.io/cosmos/upgrade/v1beta1/module_versions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.43

Parameters

module_namestringquery

module_name is a field to query a specific module consensus version from state. Leaving this empty will fetch the full list of module versions from state.

Response

200OK

A successful response.

default

An unexpected error response.

UpgradedConsensusState queries the consensus state that will serve as a trusted kernel for the next version of this chain. It will only be stored at the last height of this chain. UpgradedConsensusState RPC not supported with legacy querier This rpc is deprecated now that IBC has its own replacement (https://github.com/cosmos/ibc-go/blob/2c880a22e9f9cc75f62b527ca94aa75ce1106001/proto/ibc/core/client/v1/query.proto#L54)

GET
https://band-rest.nownodes.io/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

last_heightstring<int64>requiredpath

last height of the current chain must be sent in request as this is the height under which next consensus state is stored

Response

200OK

A successful response.

default

An unexpected error response.

Authz

Returns list of Authorization, granted to the grantee by the granter.

GET
https://band-rest.nownodes.io/cosmos/authz/v1beta1/grants

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

granterstringquery
granteestringquery
msg_type_urlstringquery

Optional, msg_type_url, when set, will query only grants matching given msg type.

pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

GranteeGrants returns a list of GrantAuthorization by grantee.

GET
https://band-rest.nownodes.io/cosmos/authz/v1beta1/grants/grantee/{grantee}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

granteestringrequiredpath
pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

GranterGrants returns list of GrantAuthorization, granted by granter.

GET
https://band-rest.nownodes.io/cosmos/authz/v1beta1/grants/granter/{granter}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

granterstringrequiredpath
pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

Feegrant

Allowance returns granted allwance to the grantee by the granter.

GET
https://band-rest.nownodes.io/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

granterstringrequiredpath

granter is the address of the user granting an allowance of their funds.

granteestringrequiredpath

grantee is the address of the user being granted an allowance of another user's funds.

Response

200OK

A successful response.

default

An unexpected error response.

Allowances returns all the grants for the given grantee address.

GET
https://band-rest.nownodes.io/cosmos/feegrant/v1beta1/allowances/{grantee}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Parameters

granteestringrequiredpath
pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.

AllowancesByGranter returns all the grants given by an address

GET
https://band-rest.nownodes.io/cosmos/feegrant/v1beta1/issued/{granter}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Since: cosmos-sdk 0.46

Parameters

granterstringrequiredpath
pagination.keystring<byte>query

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offsetstring<uint64>query

offset is a 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.limitstring<uint64>query

limit is 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_totalbooleanquery

count_total is set to true to 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.reversebooleanquery

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Response

200OK

A successful response.

default

An unexpected error response.