Home

Cosmos SDK - gRPC Gateway docs

v1.0.0
Base URLs
https://lunc.nownodes.io
https://lunc-fcd.nownodes.io
https://lunc-tendermint.nownodes.io

A REST interface for state queries.

Authentication

api-keyAuthapiKey

API Key: api-key in header

API reference

Auth

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

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/account_info/{address}

Since: cosmos-sdk 0.47

Parameters

addressstringrequiredpath

address is the account address string.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Accounts returns all the existing accounts.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/accounts

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.

Authorization

api-keyAuthapiKey in header

Account returns account details based on address.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/accounts/{address}

Parameters

addressstringrequiredpath

address defines the address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AccountAddressByID returns account address based on account number.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/address_by_id/{id}

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.

Authorization

api-keyAuthapiKey in header

Bech32Prefix queries bech32Prefix

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AddressBytesToString converts Account Address bytes to string

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32/{address_bytes}

Since: cosmos-sdk 0.46

Parameters

address_bytesstring<byte>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AddressStringToBytes converts Address string to bytes

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32/{address_string}

Since: cosmos-sdk 0.46

Parameters

address_stringstringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleAccounts returns all the existing module accounts.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/module_accounts

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleAccountByName returns the module account info by module name

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/module_accounts/{name}

Parameters

namestringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Bank

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/balances/{address}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/balances/{address}/by_denom

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denom_owners/{denom}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denom_owners_by_query

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.

Authorization

api-keyAuthapiKey in header

DenomsMetadata queries the client metadata for all registered coin denominations.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata

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.

Authorization

api-keyAuthapiKey in header

DenomMetadata queries the client metadata of a given coin denomination.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata/{denom}

Parameters

denomstringrequiredpath

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DenomMetadataByQueryString queries the client metadata of a given coin denomination.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata_by_query_string

Parameters

denomstringquery

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries the parameters of x/bank module.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SendEnabled queries for SendEnabled entries.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/send_enabled

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}/by_denom

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.

Authorization

api-keyAuthapiKey in header

TotalSupply queries the total supply of all coins.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/supply

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.

Authorization

api-keyAuthapiKey in header

SupplyOf queries the supply of a single coin.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/supply/by_denom

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.

Authorization

api-keyAuthapiKey in header

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://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/abci_query

Since: cosmos-sdk 0.46

Parameters

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetLatestBlock returns the latest block.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/latest

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetBlockByHeight queries block for given height.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/{height}

Parameters

heightstring<int64>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetNodeInfo queries the current node info.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/node_info

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetSyncing queries node syncing.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/syncing

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetLatestValidatorSet queries latest validator-set.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/latest

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.

Authorization

api-keyAuthapiKey in header

GetValidatorSetByHeight queries validator-set at a given height.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/{height}

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.

Authorization

api-keyAuthapiKey in header

Config queries for the operator configuration.

GET
https://lunc.nownodes.io/cosmos/base/node/v1beta1/config

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Status queries for the node status.

GET
https://lunc.nownodes.io/cosmos/base/node/v1beta1/status

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Distribution

CommunityPool queries the community pool coins.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/community_pool

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegationTotalRewards queries the total rewards accrued by each validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegationRewards queries the total rewards accrued by a delegation.

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

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidators queries the validators of a delegator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegatorWithdrawAddress queries withdraw address of a delegator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries params of the distribution module.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorCommission queries accumulated commission for a validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/commission

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorOutstandingRewards queries rewards of a validator address.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorSlashes queries slash events of a validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/slashes

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.

Authorization

api-keyAuthapiKey in header

Evidence

AllEvidence queries all evidence.

GET
https://lunc.nownodes.io/cosmos/evidence/v1beta1/evidence

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.

Authorization

api-keyAuthapiKey in header

Evidence queries evidence based on evidence hash.

GET
https://lunc.nownodes.io/cosmos/evidence/v1beta1/evidence/{hash}

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.

Authorization

api-keyAuthapiKey in header

Cosmos

Params queries all parameters of the gov module.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/params/{params_type}

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.

Authorization

api-keyAuthapiKey in header

GetTxsEvent fetches txs by event.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs

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.

Authorization

api-keyAuthapiKey in header

Gov

Proposals queries all proposals based on given status.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals

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.

Authorization

api-keyAuthapiKey in header

Proposal queries proposal details based on ProposalID.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Deposits queries all deposits of a single proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits

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.

Authorization

api-keyAuthapiKey in header

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

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

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.

Authorization

api-keyAuthapiKey in header

TallyResult queries the tally of a proposal vote.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Votes queries votes of a given proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/votes

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.

Authorization

api-keyAuthapiKey in header

Vote queries voted information based on proposalID, voterAddr.

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

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.

Authorization

api-keyAuthapiKey in header

Constitution queries the chain's constitution.

GET
https://lunc.nownodes.io/cosmos/gov/v1/constitution

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters of the gov module.

GET
https://lunc.nownodes.io/cosmos/gov/v1/params/{params_type}

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.

Authorization

api-keyAuthapiKey in header

Proposals queries all proposals based on given status.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals

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.

Authorization

api-keyAuthapiKey in header

Proposal queries proposal details based on ProposalID.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Deposits queries all deposits of a single proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/deposits

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.

Authorization

api-keyAuthapiKey in header

Deposit queries single deposit information based on proposalID, depositAddr.

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

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.

Authorization

api-keyAuthapiKey in header

TallyResult queries the tally of a proposal vote.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/tally

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Votes queries votes of a given proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/votes

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.

Authorization

api-keyAuthapiKey in header

Vote queries voted information based on proposalID, voterAddr.

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

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.

Authorization

api-keyAuthapiKey in header

Mint

AnnualProvisions current minting annual provisions value.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/annual_provisions

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Inflation returns the current minting inflation value.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/inflation

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params returns the total set of minting parameters.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params

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

GET
https://lunc.nownodes.io/cosmos/params/v1beta1/params

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/params/v1beta1/subspaces

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Slashing

Params queries the parameters of slashing module

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SigningInfos queries signing info of all validators

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/signing_infos

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.

Authorization

api-keyAuthapiKey in header

SigningInfo queries the signing info of given cons address

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Parameters

cons_addressstringrequiredpath

cons_address is the address to query signing info of

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Staking

DelegatorDelegations queries all delegations of a given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegations/{delegator_addr}

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.

Authorization

api-keyAuthapiKey in header

Redelegations queries redelegations of given address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

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.

Authorization

api-keyAuthapiKey in header

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidators queries all validators info for given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidator queries validator info for given delegator validator pair.

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

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.

Authorization

api-keyAuthapiKey in header

HistoricalInfo queries the historical info for given height.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/historical_info/{height}

Parameters

heightstring<int64>requiredpath

height defines at which height to query the historical info.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Parameters queries the staking parameters.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Pool queries the pool info.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/pool

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Validators queries all validators that match the given status.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators

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.

Authorization

api-keyAuthapiKey in header

Validator queries validator info for given validator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorDelegations queries delegate info for given validator.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

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.

Authorization

api-keyAuthapiKey in header

Delegation queries delegate info for given validator delegator pair.

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

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.

Authorization

api-keyAuthapiKey in header

UnbondingDelegation queries unbonding info for given validator delegator pair.

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

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.

Authorization

api-keyAuthapiKey in header

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

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.

Authorization

api-keyAuthapiKey in header

Tx

TxDecode decodes the transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/decode

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.

Authorization

api-keyAuthapiKey in header

TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/decode/amino

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.

Authorization

api-keyAuthapiKey in header

TxEncode encodes the transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/encode

Since: cosmos-sdk 0.47

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/encode/amino

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.

Authorization

api-keyAuthapiKey in header

Simulate simulates executing a transaction for estimating gas usage.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/simulate

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

BroadcastTx broadcast transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs

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.

Authorization

api-keyAuthapiKey in header

GetBlockWithTxs fetches a block with decoded txs.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs/block/{height}

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.

Authorization

api-keyAuthapiKey in header

GetTx fetches a tx by hash.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs/{hash}

Parameters

hashstringrequiredpath

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

EstimateFee simulates executing a transaction for estimating gas usage.

POST
https://lunc.nownodes.io/terra/tx/v1beta1/compute_tax

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Upgrade

AppliedPlan queries a previously applied upgrade plan by its name.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/applied_plan/{name}

Parameters

namestringrequiredpath

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Returns the account with authority to conduct upgrades

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/authority

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

CurrentPlan queries the current upgrade plan.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/current_plan

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleVersions queries the list of module versions from state.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/module_versions

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.

Authorization

api-keyAuthapiKey in header

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://lunc.nownodes.io/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

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.

Authorization

api-keyAuthapiKey in header

Authz

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

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants

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.

Authorization

api-keyAuthapiKey in header

GranteeGrants returns a list of GrantAuthorization by grantee.

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants/grantee/{grantee}

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.

Authorization

api-keyAuthapiKey in header

GranterGrants returns list of GrantAuthorization, granted by granter.

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants/granter/{granter}

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.

Authorization

api-keyAuthapiKey in header

Feegrant

Allowance returns granted allwance to the grantee by the granter.

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}

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.

Authorization

api-keyAuthapiKey in header

Allowances returns all the grants for the given grantee address.

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/allowances/{grantee}

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.

Authorization

api-keyAuthapiKey in header

AllowancesByGranter returns all the grants given by an address

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/issued/{granter}

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.

Authorization

api-keyAuthapiKey in header

Code

Codes gets the metadata for all stored wasm codes

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/code

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.

Authorization

api-keyAuthapiKey in header

Code gets the binary code and metadata for a singe wasm code

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/code/{code_id}

Parameters

code_idstring<uint64>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ContractsByCode lists all smart contracts for a code id

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/code/{code_id}/contracts

Parameters

code_idstring<uint64>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.

Authorization

api-keyAuthapiKey in header

Codes

Params gets the module params

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/codes/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PinnedCodes gets the pinned code ids

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/codes/pinned

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.

Authorization

api-keyAuthapiKey in header

Contract

ContractInfo gets the contract meta data

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contract/{address}

Parameters

addressstringrequiredpath

address is the address of the contract to query

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ContractHistory gets the contract code history

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contract/{address}/history

Parameters

addressstringrequiredpath

address is the address of the contract 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.

Authorization

api-keyAuthapiKey in header

RawContractState gets single key from the raw store data of a contract

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contract/{address}/raw/{query_data}

Parameters

addressstringrequiredpath

address is the address of the contract

query_datastring<byte>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SmartContractState get smart query result from the contract

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contract/{address}/smart/{query_data}

Parameters

addressstringrequiredpath

address is the address of the contract

query_datastring<byte>requiredpath

QueryData contains the query data passed to the contract

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AllContractState gets all raw store data for a single contract

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contract/{address}/state

Parameters

addressstringrequiredpath

address is the address of the contract

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.

Authorization

api-keyAuthapiKey in header

ContractsByCreator gets the contracts by creator

GET
https://lunc.nownodes.io/cosmwasm/wasm/v1/contracts/creator/{creator_address}

Parameters

creator_addressstringrequiredpath

CreatorAddress is the address of contract creator

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.

Authorization

api-keyAuthapiKey in header

Core

Channels queries all the IBC channels of a chain.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels

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.

Authorization

api-keyAuthapiKey in header

Channel queries an IBC Channel.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ChannelClientState queries for the client state for the channel associated with the provided channel identifiers.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/client_state

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ChannelConsensusState queries for the consensus state for the channel associated with the provided channel identifiers.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

revision_numberstring<uint64>requiredpath

revision number of the consensus state

revision_heightstring<uint64>requiredpath

revision height of the consensus state

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

NextSequenceReceive returns the next receive sequence for a given channel.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/next_sequence

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PacketAcknowledgements returns all the packet acknowledgements associated with a channel.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_acknowledgements

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

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

packet_commitment_sequencesArray<string>query

list of packet sequences.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PacketAcknowledgement queries a stored packet acknowledgement hash.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

sequencestring<uint64>requiredpath

packet sequence

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PacketCommitments returns all the packet commitments hashes associated with a channel.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

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.

Authorization

api-keyAuthapiKey in header

UnreceivedAcks returns all the unreceived IBC acknowledgements associated with a channel and sequences.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

packet_ack_sequencesArray<string>requiredpath

list of acknowledgement sequences

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

UnreceivedPackets returns all the unreceived IBC packets associated with a channel and sequences.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

packet_commitment_sequencesArray<string>requiredpath

list of packet sequences

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PacketCommitment queries a stored packet commitment hash.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

sequencestring<uint64>requiredpath

packet sequence

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

PacketReceipt queries if a given packet sequence has been received on the queried chain

GET
https://lunc.nownodes.io/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}

Parameters

channel_idstringrequiredpath

channel unique identifier

port_idstringrequiredpath

port unique identifier

sequencestring<uint64>requiredpath

packet sequence

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ConnectionChannels queries all the channels associated with a connection end.

GET
https://lunc.nownodes.io/ibc/core/channel/v1/connections/{connection}/channels

Parameters

connectionstringrequiredpath

connection unique identifier

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.

Authorization

api-keyAuthapiKey in header

ClientStates queries all the IBC light clients of a chain.

GET
https://lunc.nownodes.io/ibc/core/client/v1/client_states

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.

Authorization

api-keyAuthapiKey in header

ClientState queries an IBC light client.

GET
https://lunc.nownodes.io/ibc/core/client/v1/client_states/{client_id}

Parameters

client_idstringrequiredpath

client state unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Status queries the status of an IBC client.

GET
https://lunc.nownodes.io/ibc/core/client/v1/client_status/{client_id}

Parameters

client_idstringrequiredpath

client unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ConsensusStates queries all the consensus state associated with a given client.

GET
https://lunc.nownodes.io/ibc/core/client/v1/consensus_states/{client_id}

Parameters

client_idstringrequiredpath

client identifier

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.

Authorization

api-keyAuthapiKey in header

ConsensusStateHeights queries the height of every consensus states associated with a given client.

GET
https://lunc.nownodes.io/ibc/core/client/v1/consensus_states/{client_id}/heights

Parameters

client_idstringrequiredpath

client identifier

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.

Authorization

api-keyAuthapiKey in header

ConsensusState queries a consensus state associated with a client state at a given height.

GET
https://lunc.nownodes.io/ibc/core/client/v1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}

Parameters

client_idstringrequiredpath

client identifier

revision_numberstring<uint64>requiredpath

consensus state revision number

revision_heightstring<uint64>requiredpath

consensus state revision height

latest_heightbooleanquery

latest_height overrrides the height field and queries the latest stored ConsensusState.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ClientParams queries all parameters of the ibc client submodule.

GET
https://lunc.nownodes.io/ibc/core/client/v1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

UpgradedClientState queries an Upgraded IBC light client.

GET
https://lunc.nownodes.io/ibc/core/client/v1/upgraded_client_states

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

UpgradedConsensusState queries an Upgraded IBC consensus state.

GET
https://lunc.nownodes.io/ibc/core/client/v1/upgraded_consensus_states

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ClientConnections queries the connection paths associated with a client state.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/client_connections/{client_id}

Parameters

client_idstringrequiredpath

client identifier associated with a connection

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Connections queries all the IBC connections of a chain.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/connections

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.

Authorization

api-keyAuthapiKey in header

Connection queries an IBC connection end.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/connections/{connection_id}

Parameters

connection_idstringrequiredpath

connection unique identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ConnectionClientState queries the client state associated with the connection.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/connections/{connection_id}/client_state

Parameters

connection_idstringrequiredpath

connection identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ConnectionConsensusState queries the consensus state associated with the connection.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Parameters

connection_idstringrequiredpath

connection identifier

revision_numberstring<uint64>requiredpath
revision_heightstring<uint64>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ConnectionParams queries all parameters of the ibc connection submodule.

GET
https://lunc.nownodes.io/ibc/core/connection/v1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Apps

EscrowAddress returns the escrow address for a particular port and channel id.

GET
https://lunc.nownodes.io/ibc/apps/transfer/v1/channels/{channel_id}/ports/{port_id}/escrow_address

Parameters

channel_idstringrequiredpath

unique channel identifier

port_idstringrequiredpath

unique port identifier

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DenomHash queries a denomination hash information.

GET
https://lunc.nownodes.io/ibc/apps/transfer/v1/denom_hashes/{trace}

Parameters

tracestringrequiredpath

The denomination trace ([port_id]/[channel_id])+/[denom]

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DenomTraces queries all denomination traces.

GET
https://lunc.nownodes.io/ibc/apps/transfer/v1/denom_traces

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.

Authorization

api-keyAuthapiKey in header

DenomTrace queries a denomination trace information.

GET
https://lunc.nownodes.io/ibc/apps/transfer/v1/denom_traces/{hash}

Parameters

hashstringrequiredpath

hash (in hex format) or denom (full denom with ibc prefix) of the denomination trace information.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters of the ibc-transfer module.

GET
https://lunc.nownodes.io/ibc/apps/transfer/v1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Market

Params queries all parameters.

GET
https://lunc.nownodes.io/terra/market/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Swap returns simulated swap amount.

GET
https://lunc.nownodes.io/terra/market/v1beta1/swap

Parameters

offer_coinstringquery

offer_coin defines the coin being offered (i.e. 1000000uluna).

ask_denomstringquery

ask_denom defines the denom of the coin to swap to.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TerraPoolDelta returns terra_pool_delta amount.

GET
https://lunc.nownodes.io/terra/market/v1beta1/terra_pool_delta

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Oracle

Actives returns all active denoms

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/actives

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ExchangeRates returns exchange rates of all denoms

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/exchange_rates

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TobinTaxes returns tobin taxes of all denoms

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/tobin_taxes

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

VoteTargets returns all vote target denoms

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/vote_targets

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ExchangeRate returns exchange rate of a denom

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/{denom}/exchange_rate

Parameters

denomstringrequiredpath

denom defines the denomination to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TobinTax returns tobin tax of a denom

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/denoms/{denom}/tobin_tax

Parameters

denomstringrequiredpath

denom defines the denomination to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters.

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AggregateVote returns an aggregate vote of a validator

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/valdiators/{validator_addr}/aggregate_vote

Parameters

validator_addrstringrequiredpath

validator defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AggregatePrevotes returns aggregate prevotes of all validators

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/validators/aggregate_prevotes

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AggregateVotes returns aggregate votes of all validators

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/validators/aggregate_votes

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AggregatePrevote returns an aggregate prevote of a validator

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/validators/{validator_addr}/aggregate_prevote

Parameters

validator_addrstringrequiredpath

validator defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

FeederDelegation returns feeder delegation of a validator

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/validators/{validator_addr}/feeder

Parameters

validator_addrstringrequiredpath

validator defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

MissCounter returns oracle miss counter of a validator

GET
https://lunc.nownodes.io/terra/oracle/v1beta1/validators/{validator_addr}/miss

Parameters

validator_addrstringrequiredpath

validator defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Treasury

BurnTaxExemptionList returns all registered burn tax exemption addresses

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/burn_tax_exemption_list

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.

Authorization

api-keyAuthapiKey in header

Indicators return the current trl informations

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/indicators

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters.

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

RewardWeight return the current reward weight

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/reward_weight

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SeigniorageProceeds return the current seigniorage proceeds

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/seigniorage_proceeds

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TaxCaps returns the all tax caps

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/tax_caps

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TaxCap returns the tax cap of a denom

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/tax_caps/{denom}

Parameters

denomstringrequiredpath

denom defines the denomination to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TaxProceeds return the current tax proceeds

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/tax_proceeds

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TaxRate return the current tax rate

GET
https://lunc.nownodes.io/terra/treasury/v1beta1/tax_rate

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Tax

BurnTaxRate return the current tax rate

GET
https://lunc.nownodes.io/terra/tax/v1beta1/burn_tax_rate

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Dyncomm

Params queries all parameters.

GET
https://lunc.nownodes.io/terra/dyncomm/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header
GET
https://lunc.nownodes.io/terra/dyncomm/v1beta1/rate/{validator_addr}

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

FCD

Auth

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

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/account_info/{address}

Since: cosmos-sdk 0.47

Parameters

addressstringrequiredpath

address is the account address string.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Accounts returns all the existing accounts.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/accounts

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.

Authorization

api-keyAuthapiKey in header

Account returns account details based on address.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/accounts/{address}

Parameters

addressstringrequiredpath

address defines the address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AccountAddressByID returns account address based on account number.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/address_by_id/{id}

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.

Authorization

api-keyAuthapiKey in header

Bech32Prefix queries bech32Prefix

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AddressBytesToString converts Account Address bytes to string

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32/{address_bytes}

Since: cosmos-sdk 0.46

Parameters

address_bytesstring<byte>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

AddressStringToBytes converts Address string to bytes

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/bech32/{address_string}

Since: cosmos-sdk 0.46

Parameters

address_stringstringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleAccounts returns all the existing module accounts.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/module_accounts

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleAccountByName returns the module account info by module name

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/module_accounts/{name}

Parameters

namestringrequiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters.

GET
https://lunc.nownodes.io/cosmos/auth/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Bank

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/balances/{address}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/balances/{address}/by_denom

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denom_owners/{denom}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denom_owners_by_query

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.

Authorization

api-keyAuthapiKey in header

DenomsMetadata queries the client metadata for all registered coin denominations.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata

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.

Authorization

api-keyAuthapiKey in header

DenomMetadata queries the client metadata of a given coin denomination.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata/{denom}

Parameters

denomstringrequiredpath

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DenomMetadataByQueryString queries the client metadata of a given coin denomination.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/denoms_metadata_by_query_string

Parameters

denomstringquery

denom is the coin denom to query the metadata for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries the parameters of x/bank module.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SendEnabled queries for SendEnabled entries.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/send_enabled

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/spendable_balances/{address}/by_denom

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.

Authorization

api-keyAuthapiKey in header

TotalSupply queries the total supply of all coins.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/supply

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.

Authorization

api-keyAuthapiKey in header

SupplyOf queries the supply of a single coin.

GET
https://lunc.nownodes.io/cosmos/bank/v1beta1/supply/by_denom

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.

Authorization

api-keyAuthapiKey in header

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://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/abci_query

Since: cosmos-sdk 0.46

Parameters

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetLatestBlock returns the latest block.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/latest

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetBlockByHeight queries block for given height.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/blocks/{height}

Parameters

heightstring<int64>requiredpath

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetNodeInfo queries the current node info.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/node_info

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetSyncing queries node syncing.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/syncing

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

GetLatestValidatorSet queries latest validator-set.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/latest

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.

Authorization

api-keyAuthapiKey in header

GetValidatorSetByHeight queries validator-set at a given height.

GET
https://lunc.nownodes.io/cosmos/base/tendermint/v1beta1/validatorsets/{height}

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.

Authorization

api-keyAuthapiKey in header

Config queries for the operator configuration.

GET
https://lunc.nownodes.io/cosmos/base/node/v1beta1/config

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Status queries for the node status.

GET
https://lunc.nownodes.io/cosmos/base/node/v1beta1/status

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Distribution

CommunityPool queries the community pool coins.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/community_pool

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegationTotalRewards queries the total rewards accrued by each validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegationRewards queries the total rewards accrued by a delegation.

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

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidators queries the validators of a delegator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/validators

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

DelegatorWithdrawAddress queries withdraw address of a delegator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address

Parameters

delegator_addressstringrequiredpath

delegator_address defines the delegator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries params of the distribution module.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorCommission queries accumulated commission for a validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/commission

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorOutstandingRewards queries rewards of a validator address.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards

Parameters

validator_addressstringrequiredpath

validator_address defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorSlashes queries slash events of a validator.

GET
https://lunc.nownodes.io/cosmos/distribution/v1beta1/validators/{validator_address}/slashes

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.

Authorization

api-keyAuthapiKey in header

Evidence

AllEvidence queries all evidence.

GET
https://lunc.nownodes.io/cosmos/evidence/v1beta1/evidence

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.

Authorization

api-keyAuthapiKey in header

Evidence queries evidence based on evidence hash.

GET
https://lunc.nownodes.io/cosmos/evidence/v1beta1/evidence/{hash}

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.

Authorization

api-keyAuthapiKey in header

Cosmos

Params queries all parameters of the gov module.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/params/{params_type}

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.

Authorization

api-keyAuthapiKey in header

GetTxsEvent fetches txs by event.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs

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.

Authorization

api-keyAuthapiKey in header

Gov

Proposals queries all proposals based on given status.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals

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.

Authorization

api-keyAuthapiKey in header

Proposal queries proposal details based on ProposalID.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Deposits queries all deposits of a single proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/deposits

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.

Authorization

api-keyAuthapiKey in header

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

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

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.

Authorization

api-keyAuthapiKey in header

TallyResult queries the tally of a proposal vote.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/tally

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Votes queries votes of a given proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1beta1/proposals/{proposal_id}/votes

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.

Authorization

api-keyAuthapiKey in header

Vote queries voted information based on proposalID, voterAddr.

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

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.

Authorization

api-keyAuthapiKey in header

Constitution queries the chain's constitution.

GET
https://lunc.nownodes.io/cosmos/gov/v1/constitution

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params queries all parameters of the gov module.

GET
https://lunc.nownodes.io/cosmos/gov/v1/params/{params_type}

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.

Authorization

api-keyAuthapiKey in header

Proposals queries all proposals based on given status.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals

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.

Authorization

api-keyAuthapiKey in header

Proposal queries proposal details based on ProposalID.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Deposits queries all deposits of a single proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/deposits

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.

Authorization

api-keyAuthapiKey in header

Deposit queries single deposit information based on proposalID, depositAddr.

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

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.

Authorization

api-keyAuthapiKey in header

TallyResult queries the tally of a proposal vote.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/tally

Parameters

proposal_idstring<uint64>requiredpath

proposal_id defines the unique id of the proposal.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Votes queries votes of a given proposal.

GET
https://lunc.nownodes.io/cosmos/gov/v1/proposals/{proposal_id}/votes

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.

Authorization

api-keyAuthapiKey in header

Vote queries voted information based on proposalID, voterAddr.

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

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.

Authorization

api-keyAuthapiKey in header

Mint

AnnualProvisions current minting annual provisions value.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/annual_provisions

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Inflation returns the current minting inflation value.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/inflation

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params returns the total set of minting parameters.

GET
https://lunc.nownodes.io/cosmos/mint/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Params

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

GET
https://lunc.nownodes.io/cosmos/params/v1beta1/params

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.

Authorization

api-keyAuthapiKey in header

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

GET
https://lunc.nownodes.io/cosmos/params/v1beta1/subspaces

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Slashing

Params queries the parameters of slashing module

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

SigningInfos queries signing info of all validators

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/signing_infos

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.

Authorization

api-keyAuthapiKey in header

SigningInfo queries the signing info of given cons address

GET
https://lunc.nownodes.io/cosmos/slashing/v1beta1/signing_infos/{cons_address}

Parameters

cons_addressstringrequiredpath

cons_address is the address to query signing info of

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Staking

DelegatorDelegations queries all delegations of a given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegations/{delegator_addr}

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.

Authorization

api-keyAuthapiKey in header

Redelegations queries redelegations of given address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

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.

Authorization

api-keyAuthapiKey in header

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidators queries all validators info for given delegator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

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.

Authorization

api-keyAuthapiKey in header

DelegatorValidator queries validator info for given delegator validator pair.

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

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.

Authorization

api-keyAuthapiKey in header

HistoricalInfo queries the historical info for given height.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/historical_info/{height}

Parameters

heightstring<int64>requiredpath

height defines at which height to query the historical info.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Parameters queries the staking parameters.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/params

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Pool queries the pool info.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/pool

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Validators queries all validators that match the given status.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators

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.

Authorization

api-keyAuthapiKey in header

Validator queries validator info for given validator address.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}

Parameters

validator_addrstringrequiredpath

validator_addr defines the validator address to query for.

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ValidatorDelegations queries delegate info for given validator.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

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.

Authorization

api-keyAuthapiKey in header

Delegation queries delegate info for given validator delegator pair.

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

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.

Authorization

api-keyAuthapiKey in header

UnbondingDelegation queries unbonding info for given validator delegator pair.

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

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.

Authorization

api-keyAuthapiKey in header

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

GET
https://lunc.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

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.

Authorization

api-keyAuthapiKey in header

Tx

TxDecode decodes the transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/decode

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.

Authorization

api-keyAuthapiKey in header

TxDecodeAmino decodes an Amino transaction from encoded bytes to JSON.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/decode/amino

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.

Authorization

api-keyAuthapiKey in header

TxEncode encodes the transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/encode

Since: cosmos-sdk 0.47

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

TxEncodeAmino encodes an Amino transaction from JSON to encoded bytes.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/encode/amino

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.

Authorization

api-keyAuthapiKey in header

Simulate simulates executing a transaction for estimating gas usage.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/simulate

Body

application/json
any

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

BroadcastTx broadcast transaction.

POST
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs

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.

Authorization

api-keyAuthapiKey in header

GetBlockWithTxs fetches a block with decoded txs.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs/block/{height}

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.

Authorization

api-keyAuthapiKey in header

GetTx fetches a tx by hash.

GET
https://lunc.nownodes.io/cosmos/tx/v1beta1/txs/{hash}

Parameters

hashstringrequiredpath

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Upgrade

AppliedPlan queries a previously applied upgrade plan by its name.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/applied_plan/{name}

Parameters

namestringrequiredpath

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

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

Returns the account with authority to conduct upgrades

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/authority

Since: cosmos-sdk 0.46

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

CurrentPlan queries the current upgrade plan.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/current_plan

Response

200OK

A successful response.

default

An unexpected error response.

Authorization

api-keyAuthapiKey in header

ModuleVersions queries the list of module versions from state.

GET
https://lunc.nownodes.io/cosmos/upgrade/v1beta1/module_versions

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.

Authorization

api-keyAuthapiKey in header

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://lunc.nownodes.io/cosmos/upgrade/v1beta1/upgraded_consensus_state/{last_height}

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.

Authorization

api-keyAuthapiKey in header

Authz

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

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants

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.

Authorization

api-keyAuthapiKey in header

GranteeGrants returns a list of GrantAuthorization by grantee.

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants/grantee/{grantee}

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.

Authorization

api-keyAuthapiKey in header

GranterGrants returns list of GrantAuthorization, granted by granter.

GET
https://lunc.nownodes.io/cosmos/authz/v1beta1/grants/granter/{granter}

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.

Authorization

api-keyAuthapiKey in header

Feegrant

Allowance returns granted allwance to the grantee by the granter.

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/allowance/{granter}/{grantee}

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.

Authorization

api-keyAuthapiKey in header

Allowances returns all the grants for the given grantee address.

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/allowances/{grantee}

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.

Authorization

api-keyAuthapiKey in header

AllowancesByGranter returns all the grants given by an address

GET
https://lunc.nownodes.io/cosmos/feegrant/v1beta1/issued/{granter}

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.

Authorization

api-keyAuthapiKey in header

Tendermint / RPC

abci_info

Get ABCI info

POST
https://lunc.nownodes.io/

Retrieve information about the ABCI application including version and last block state

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringabci_inforequired

The JSON-RPC method name

paramsobjectrequired

Parameters for abci_info method (currently empty)

Response

200OK

Successful ABCI info response

Authorization

api-keyAuthapiKey in header

block_by_hash

Get block by hash

POST
https://lunc.nownodes.io/

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired
Show child attributes
hashstringrequired

Block hash to query

Response

200OK

Block data by hash or empty block if not found

Authorization

api-keyAuthapiKey in header

block_results

Get block transaction results and events by height

POST
https://lunc.nownodes.io/

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired
Show child attributes
heightstringrequired

Block height to query

Response

200OK

Block transaction results and event data

Authorization

api-keyAuthapiKey in header

block

Get block by height

POST
https://lunc.nownodes.io/

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired
Show child attributes
Heightstringrequired

Block height to query

Response

200OK

Full block data for the specified height

Authorization

api-keyAuthapiKey in header

blockchain

Query blockchain block metadata in height range

POST
https://lunc.nownodes.io/

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired
Show child attributes
minHeightstringrequired

Minimum block height (inclusive)

maxHeightstringrequired

Maximum block height (inclusive)

Response

200OK

Block metadata within height range

Authorization

api-keyAuthapiKey in header

check_tx

Check transaction validity

POST
https://lunc.nownodes.io/

Validate a transaction without adding it to the mempool. Returns transaction check results including gas usage and validation errors.

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringcheck_txrequired

The JSON-RPC method name for transaction validation

paramsobjectrequired
Show child attributes
txstringrequired

Hexadecimal encoded transaction data to validate

Response

200OK

Transaction validation result

Authorization

api-keyAuthapiKey in header

commit

Get block commit by height

POST
https://lunc.nownodes.io/

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired
Show child attributes
Heightstringrequired

Block height to query commit for

Response

200OK

Block commit data including signed header and signatures

Authorization

api-keyAuthapiKey in header

consensus_params

Get consensus parameters

POST
https://lunc.nownodes.io/

Retrieve current consensus parameters at specified block height

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringconsensus_paramsrequired

The JSON-RPC method name

paramsobjectrequired

Parameters for consensus_params method (currently empty)

Response

200OK

Successful consensus parameters response

Authorization

api-keyAuthapiKey in header

consensus_state

Get consensus state

POST
https://lunc.nownodes.io/

Retrieve current consensus state including round state, voting information, and proposer details

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringconsensus_staterequired

The JSON-RPC method name

paramsobjectrequired

Parameters for consensus_state method (currently empty)

Response

200OK

Successful consensus state response

Authorization

api-keyAuthapiKey in header

dump_consensus_state

Dump consensus state

POST
https://lunc.nownodes.io/

Retrieve detailed consensus state including round state and complete validator set information

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringdump_consensus_staterequired

The JSON-RPC method name

paramsobjectrequired

Parameters for dump_consensus_state method (currently empty)

Response

200OK

Successful consensus state dump response

Authorization

api-keyAuthapiKey in header

genesis_chunked

Retrieve genesis chunk

POST
https://lunc.nownodes.io/

Get a specific chunk of the genesis file for Cosmos Hub (ATOM)

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringgenesis_chunkedrequired

The JSON-RPC method name

paramsobjectrequired
Show child attributes
chunkstringrequired

Zero-based index of the genesis chunk to retrieve

Response

200OK

Successful genesis chunk response

Authorization

api-keyAuthapiKey in header

genesis

Get genesis data

POST
https://lunc.nownodes.io/

Retrieves the blockchain genesis file using JSON-RPC.

Body

application/json
jsonrpcstringrequired
idintegerrequired
methodstringgenesisrequired
paramsobjectrequired

No parameters required for this method.

Response

200OK

Genesis data retrieved successfully.

Authorization

api-keyAuthapiKey in header

health

Health check

POST
https://lunc.nownodes.io/

Checks if the node is alive and responding correctly.

Body

application/json
jsonrpcstringrequired

JSON-RPC version

idintegerrequired

Request ID

methodstringrequired

RPC method name

paramsobjectrequired

Empty object for health method

Response

200OK

Node is healthy

Authorization

api-keyAuthapiKey in header

net_info

Get network info

POST
https://lunc.nownodes.io/

Provides details about the P2P network, including peers, connection status, and listener info.

Body

application/json
jsonrpcstringrequired
idintegerrequired
methodstringrequired
paramsobjectrequired

Response

200OK

Network information

Authorization

api-keyAuthapiKey in header

num_unconfirmed_txs

Get number of unconfirmed transactions

POST
https://lunc.nownodes.io/

Retrieve the count and size of transactions currently in the mempool without returning the actual transactions

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringnum_unconfirmed_txsrequired

The JSON-RPC method name for getting unconfirmed transactions count

paramsobjectrequired

Parameters for num_unconfirmed_txs method (currently empty)

Response

200OK

Successfully retrieved unconfirmed transactions count

Authorization

api-keyAuthapiKey in header

status

Get node status

POST
https://lunc.nownodes.io/

Sends a JSON-RPC 2.0 POST request to the Tendermint RPC server to get node status.

Body

application/json
jsonrpcstringrequired

JSON-RPC protocol version

idintegerrequired

Request identifier

methodstringrequired

RPC method name

paramsobjectrequired

Method-specific parameters (empty object for status)

Response

200OK

Successful node status response

Authorization

api-keyAuthapiKey in header

Search transactions

POST
https://lunc.nownodes.io/

Search for transactions with query filters, pagination, and sorting options

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringtx_searchrequired

The JSON-RPC method name for transaction search

paramsobjectrequired
Show child attributes
querystringrequired

Query string using Tendermint query syntax. Examples:

  • "tx.height=123456" - Transactions at specific height
  • "transfer.recipient='cosmos1...'" - Transfer transactions to recipient
  • "message.sender='cosmos1...'" - Transactions from specific sender
  • "tx.hash='ABC123...'" - Specific transaction hash
proveboolean

Whether to include merkle proofs for transactions

pageinteger

Page number for pagination (1-based)

per_pageinteger

Number of transactions per page

order_bystringascdesc

Sort order for results

Response

200OK

Transactions found successfully

Authorization

api-keyAuthapiKey in header

tx

Get transaction by hash

POST
https://lunc.nownodes.io/

Retrieve a transaction by its hash with optional proof verification

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringtxrequired

The JSON-RPC method name for transaction query

paramsobjectrequired
Show child attributes
hashstringrequired

Hexadecimal hash of the transaction to query

provebooleanrequired

Whether to include merkle proof of transaction inclusion in block

Response

200OK

Transaction found successfully

Authorization

api-keyAuthapiKey in header

unconfirmed_txs

Get unconfirmed transactions

POST
https://lunc.nownodes.io/

Retrieve transactions currently in the mempool (unconfirmed transactions)

Body

application/json
jsonrpcstring2.0required

JSON-RPC version identifier

idinteger | stringrequired

Request identifier for matching responses

methodstringunconfirmed_txsrequired

The JSON-RPC method name for getting unconfirmed transactions

paramsobjectrequired
Show child attributes
limitinteger

Maximum number of transactions to return (0 = unlimited)

Response

200OK

Successfully retrieved unconfirmed transactions

Authorization

api-keyAuthapiKey in header

validators

Get Validators by Block Height

POST
https://lunc.nownodes.io/

Calls the validators JSON-RPC method to retrieve a paginated list of validators at a given block height.

Body

application/json
jsonrpcstring2.0required

JSON-RPC protocol version, must be "2.0".

idintegerrequired

Unique identifier for the request, used to match the response.

methodstringvalidatorsrequired

The method name to call.

paramsobjectrequired
Show child attributes
heightstringrequired

The block height for which to query the validators.

pagestringrequired

Page number for pagination (1-based).

per_pagestringrequired

Number of validators to return per page.

Response

200OK

Successful response containing validators list and metadata

Authorization

api-keyAuthapiKey in header

Tendermint

REST-API

Returns with the response from CheckTx. Does not wait for DeliverTx result.

GET
https://lunc.nownodes.io/broadcast_tx_sync

This method blocks until CheckTx returns and reports its result, but does not wait for the transaction to be included in a block. To know when the transaction is included in a block, check for the transaction event using JSON-RPC.

Parameters

txstringrequiredquery

The transaction

Response

200OK

Empty

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Returns with the response from CheckTx. Does not wait for DeliverTx result.

GET
https://lunc.nownodes.io/broadcast_tx

This method blocks until CheckTx returns and reports its result, but does not wait for the transaction to be included in a block. To know when the transaction is included in a block, check for the transaction event using JSON-RPC.

Parameters

txstringrequiredquery

The transaction

Response

200OK

Empty

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Returns right away, with no response. Does not wait for CheckTx nor DeliverTx results.

GET
https://lunc.nownodes.io/broadcast_tx_async

This method submits the transaction and returns immediately without waiting for the transaction to be checked (CheckTx) or committed. Too know when the transaction is included in a block, you can check for the transaction event using JSON-RPC.

Parameters

txstringrequiredquery

The transaction

Response

200OK

empty answer

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Returns with the responses from CheckTx and DeliverTx.

GET
https://lunc.nownodes.io/broadcast_tx_commit

This method waits for the transaction to be checked (CheckTx) and makes a best effort to wait for it to be committed into a block before returning. It will report an error if the request times out before the transaction commits. If CheckTx or DeliverTx fails, the RPC will succeed and report the failing (non-zero) ABCI result code.

WARNING: Use this only for testing and development. For production use, call broadcast_tx.

To know when a transaction is included in a block, check for the transaction event using JSON-RPC.

Parameters

txstringrequiredquery

The transaction

Response

200OK

empty answer

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Checks the transaction without executing it.

GET
https://lunc.nownodes.io/check_tx

The transaction won't be added to the mempool.

Please refer to https://docs.tendermint.com/master/tendermint-core/using-tendermint.html#formatting for formatting/encoding rules.

Parameters

txstringrequiredquery

The transaction

Response

200OK

ABCI application's CheckTx response

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Removes a transaction from the mempool.

GET
https://lunc.nownodes.io/remove_tx

Parameters

txKeystringrequiredquery

The transaction key

Response

200OK

empty response.

500Internal Server Error

empty error.

Authorization

api-keyAuthapiKey in header

Fetch events posted by the consensus node.

GET
https://lunc.nownodes.io/events

Fetch a batch of events posted by the consensus node and matching a specified query string.

The query grammar is defined in pubsub/query/syntax. An empty query matches all events; otherwise a query comprises one or more terms comparing event metadata to target values. For example, to select new block events:

Copied!
tm.event = 'NewBlock'

Multiple terms can be combined with AND, for example to match the transaction event with a given hash, use:

Copied!
tm.event = 'Tx' AND tx.hash = 'EA7B33F'

The comparison operators include =, <, <=, >, >=, and CONTAINS. Operands may be strings (in single quotes), numbers, dates, or timestamps. In addition, the EXISTS operator allows you to check for the presence of an attribute regardless of its value.

Tendermint defines a tm.event attribute for all events. Transactions are also assigned tx.hash and tx.height attributes. Other attributes are provided by the application as ABCI Event records. The name of the event in the query is formed by combining the type and attribute key with a period. For example, given:

Copied!
[]abci.Event{{
    Type: "reward",
    Attributes: []abci.EventAttribute{
        {Key: "address", Value: "cosmos1xyz012pdq"},
        {Key: "amount", Value: "45.62"},
        {Key: "balance", Value: "100.390001"},
    },
}}

the query may refer to the names"reward.address,"reward.amount, and reward.balance, as in:

Copied!
reward.address EXISTS AND reward.balance > 45

The node maintains a log of all events within an operator-defined time window. The /events method returns the most recent items from the log that match the query. Each item returned includes a cursor that marks its location in the log. Cursors can be passed via the before and after parameters to fetch events earlier in the log.

Parameters

filterEventFilterquery
maxItemsintegerquery
afterstringquery
beforestringquery
waitTimeintegerquery

Response

200OK

Reports a batch of matching events

500Internal Server Error

Reports an error

Authorization

api-keyAuthapiKey in header

Subscribe for events via WebSocket.

GET
https://lunc.nownodes.io/subscribe

To tell which events you want, you need to provide a query. query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r\()"'=>< are not allowed). operation can be "=", "<", "<=", ">", ">=", "CONTAINS" AND "EXISTS". operand can be a string (escaped with single quotes), number, date or time.

Examples: tm.event = 'NewBlock' # new blocks tm.event = 'CompleteProposal' # node got a complete proposal tm.event = 'Tx' AND tx.hash = 'XYZ' # single transaction tm.event = 'Tx' AND tx.height = 5 # all txs of the fifth block tx.height = 5 # all txs of the fifth block

Tendermint provides a few predefined keys: tm.event, tx.hash and tx.height. Note for transactions, you can define additional keys by providing events with DeliverTx response.

import ( abci "github.com/tendermint/tendermint/abci/types" "github.com/tendermint/tendermint/libs/pubsub/query" )

abci.ResponseDeliverTx{ Events: []abci.Event{ { Type: "rewards.withdraw", Attributes: []abci.EventAttribute{ {Key: "address", Value: "AddrA", Index: true}, {Key: "source", Value: "SrcX", Index: true}, {Key: "amount", Value: "...", Index: true}, {Key: "balance", Value: "...", Index: true}, }, }, { Type: "rewards.withdraw", Attributes: []abci.EventAttribute{ {Key: "address", Value: "AddrB", Index: true}, {Key: "source", Value: "SrcY", Index: true}, {Key: "amount", Value: "...", Index: true}, {Key: "balance", Value: "...", Index: true}, }, }, { Type: "transfer", Attributes: []abci.EventAttribute{ {Key: "sender", Value: "AddrC", Index: true}, {Key: "recipient", Value: "AddrD", Index: true}, {Key: "amount", Value: "...", Index: true}, }, }, }, }

All events are indexed by a composite key of the form {eventType}.{evenAttrKey}. In the above examples, the following keys would be indexed:

  • rewards.withdraw.address
  • rewards.withdraw.source
  • rewards.withdraw.amount
  • rewards.withdraw.balance
  • transfer.sender
  • transfer.recipient
  • transfer.amount

Multiple event types with duplicate keys are allowed and are meant to categorize unique and distinct events. In the above example, all events indexed under the key rewards.withdraw.address will have the following values stored and queryable:

  • AddrA
  • AddrB

To create a query for txs where address AddrA withdrew rewards: query.MustParse("tm.event = 'Tx' AND rewards.withdraw.address = 'AddrA'")

To create a query for txs where address AddrA withdrew rewards from source Y: query.MustParse("tm.event = 'Tx' AND rewards.withdraw.address = 'AddrA' AND rewards.withdraw.source = 'Y'")

To create a query for txs where AddrA transferred funds: query.MustParse("tm.event = 'Tx' AND transfer.sender = 'AddrA'")

The following queries would return no results: query.MustParse("tm.event = 'Tx' AND transfer.sender = 'AddrZ'") query.MustParse("tm.event = 'Tx' AND rewards.withdraw.address = 'AddrZ'") query.MustParse("tm.event = 'Tx' AND rewards.withdraw.source = 'W'")

Copied!
import rpchttp "github.com/tendermint/rpc/client/http"
import "github.com/tendermint/tendermint/types"

client, err := rpchttp.New("tcp://0.0.0.0:26657", "/websocket")
if err != nil {
  // handle error
}

err = client.Start()
if err != nil {
  // handle error
}
defer client.Stop()
ctx, cancel := context.WithTimeout(context.Background(), 1 * time.Second)
defer cancel()
query := "tm.event = 'Tx' AND tx.height = 3"
txs, err := client.Subscribe(ctx, "test-client", query)
if err != nil {
  // handle error
}

go func() {
 for e := range txs {
   fmt.Println("got ", e.Data.(types.EventDataTx))
   }
}()

NOTE: if you're not reading events fast enough, Tendermint might terminate the subscription.

Parameters

querystringrequiredquery

query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r\()"'=>< are not allowed). operation can be "=", "<", "<=", ">", ">=", "CONTAINS". operand can be a string (escaped with single quotes), number, date or time.

Response

200OK

empty answer

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Unsubscribe from event on Websocket

GET
https://lunc.nownodes.io/unsubscribe
Copied!
client, err := rpchttp.New("tcp://0.0.0.0:26657", "/websocket")
if err != nil {
  // handle error
}

err := client.Start()
if err != nil {
  // handle error
}
defer client.Stop()
query := "tm.event = 'Tx' AND tx.height = 3"
err = client.Unsubscribe(context.Background(), "test-client", query)
if err != nil {
  // handle error
}

Parameters

querystringrequiredquery

query is a string, which has a form: "condition AND condition ..." (no OR at the moment). condition has a form: "key operation operand". key is a string with a restricted set of possible symbols ( \t\n\r\()"'=>< are not allowed). operation can be "=", "<", "<=", ">", ">=", "CONTAINS". operand can be a string (escaped with single quotes), number, date or time.

Response

200OK

Answer

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Unsubscribe from all events via WebSocket

GET
https://lunc.nownodes.io/unsubscribe_all

Unsubscribe from all events via WebSocket

Response

200OK

empty answer

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Node heartbeat

GET
https://lunc.nownodes.io/health

Get node health. Returns empty result (200 OK) on success, no response - in case of an error.

Response

200OK

Gets Node Health

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Node Status

GET
https://lunc.nownodes.io/status

Get Tendermint status including node info, pubkey, latest block hash, app hash, block height, current max peer height, and time.

Response

200OK

Status of the node

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Network information

GET
https://lunc.nownodes.io/net_info

Get network info.

Response

200OK

empty answer

500Internal Server Error

empty error

Authorization

api-keyAuthapiKey in header

Get block headers (max: 20) for minHeight <= height <= maxHeight.

GET
https://lunc.nownodes.io/blockchain

Get block headers for minHeight <= height maxHeight.

If maxHeight does not yet exist, blocks up to the current height will be returned. If minHeight does not exist (due to pruning), earliest existing height will be used.

At most 20 items will be returned. Block headers are returned in descending order (highest first).

Parameters

minHeightintegerquery

Minimum block height to return

maxHeightintegerquery

Maximum block height to return

Response

200OK

Block headers, returned in descending order (highest first).

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get the header at a specified height

GET
https://lunc.nownodes.io/header

Retrieve the block header corresponding to a specified height.

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch the latest height.

Response

200OK

Header information.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get header by hash

GET
https://lunc.nownodes.io/header_by_hash

Retrieve the block header corresponding to a block hash.

Parameters

hashstringrequiredquery

header hash

Response

200OK

Header information.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get block at a specified height

GET
https://lunc.nownodes.io/block

Get Block.

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch the latest block.

Response

200OK

Block information.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get block by hash

GET
https://lunc.nownodes.io/block_by_hash

Get Block By Hash.

Parameters

hashstringrequiredquery

block hash

Response

200OK

Block information.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get block results at a specified height

GET
https://lunc.nownodes.io/block_results

Get block_results.

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch information regarding the latest block.

Response

200OK

Block results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get commit results at a specified height

GET
https://lunc.nownodes.io/commit

Get Commit.

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch commit information regarding the latest block.

Response

200OK

Commit results.

canonical switches from false to true for block H once block H+1 has been committed. Until then it's subjective and only reflects what this node has seen so far.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get validator set at a specified height

GET
https://lunc.nownodes.io/validators

Get Validators. Validators are sorted first by voting power (descending), then by address (ascending).

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch validator set which corresponds to the latest block.

pageinteger1query

Page number (1-based)

per_pageinteger30query

Number of entries per page (max: 100)

Response

200OK

Commit results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get Genesis

GET
https://lunc.nownodes.io/genesis

Get the genesis document.

Response

200OK

Genesis results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get Genesis in paginated chunks

GET
https://lunc.nownodes.io/genesis_chunked

Get genesis document in a paginated/chunked format to make it easier to iterate through larger genesis structures.

Parameters

chunkIDinteger0query

Sequence number of the chunk to download.

Response

200OK

Genesis results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get consensus state

GET
https://lunc.nownodes.io/dump_consensus_state

Get consensus state.

Not safe to call from inside the ABCI application during a block execution.

Response

200OK

Complete consensus state.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get consensus state

GET
https://lunc.nownodes.io/consensus_state

Get consensus state.

Not safe to call from inside the ABCI application during a block execution.

Response

200OK

consensus state results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get consensus parameters

GET
https://lunc.nownodes.io/consensus_params

Get consensus parameters.

Parameters

heightinteger0query

height to return. If no height is provided, it will fetch commit information regarding the latest block.

Response

200OK

consensus parameters results.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get the list of unconfirmed transactions

GET
https://lunc.nownodes.io/unconfirmed_txs

Get list of unconfirmed transactions

Parameters

pageinteger1query

Page number (1-based)

per_pageinteger30query

Number of entries per page (max: 100)

Response

200OK

List of unconfirmed transactions

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get data about unconfirmed transactions

GET
https://lunc.nownodes.io/num_unconfirmed_txs

Get data about unconfirmed transactions

Response

200OK

status about unconfirmed transactions

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Search for transactions

GET
https://lunc.nownodes.io/tx_search

Search for transactions w/ their results.

See /subscribe for the query syntax.

Parameters

querystringrequiredquery

Query

provebooleanfalsequery

Include proofs of the transactions inclusion in the block

pageinteger1query

Page number (1-based)

per_pageinteger30query

Number of entries per page (max: 100)

order_bystringdescquery

Order in which transactions are sorted ("asc" or "desc"), by height & index. If empty, default sorting will be still applied.

Response

200OK

List of transactions

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Search for blocks by BeginBlock and EndBlock events

GET
https://lunc.nownodes.io/block_search

Search for blocks by BeginBlock and EndBlock events.

See /subscribe for the query syntax.

Parameters

querystringrequiredquery

Query

pageinteger1query

Page number (1-based)

per_pageinteger30query

Number of entries per page (max: 100)

order_bystringdescquery

Order in which blocks are sorted ("asc" or "desc"), by height. If empty, default sorting will be still applied.

Response

200OK

List of paginated blocks matching the search criteria.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get transactions by hash

GET
https://lunc.nownodes.io/tx

Get a transaction

Parameters

hashstringrequiredquery

transaction Hash to retrive

provebooleanfalsequery

Include proofs of the transactions inclusion in the block

Response

200OK

Get a transaction

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Get some info about the application.

GET
https://lunc.nownodes.io/abci_info

Get some info about the application.

Response

200OK

Get some info about the application.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Query the application for some information.

GET
https://lunc.nownodes.io/abci_query

Query the application for some information.

Parameters

pathstringrequiredquery

Path to the data ("/a/b/c")

datastringrequiredquery

Data

heightinteger0query

Height (0 means latest)

provebooleanfalsequery

Include proofs of the transactions inclusion in the block

Response

200OK

Response of the submitted query

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header

Broadcast evidence of the misbehavior.

GET
https://lunc.nownodes.io/broadcast_evidence

Broadcast evidence of the misbehavior.

Parameters

evidencestringrequiredquery

JSON evidence

Response

200OK

Broadcast evidence of the misbehavior.

500Internal Server Error

Error

Authorization

api-keyAuthapiKey in header