Bank
When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.
address is the address to query balances for.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
resolve_denom is the flag to resolve the denom into a human-readable form from the metadata.
Since: cosmos-sdk 0.50
GET /cosmos/bank/v1beta1/balances/{address} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"balances": [
{
"denom": "text",
"amount": "text"
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}address is the address to query balances for.
denom is the coin denom to query balances for.
GET /cosmos/bank/v1beta1/balances/{address}/by_denom HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"balance": {
"denom": "text",
"amount": "text"
}
}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
denom defines the coin denomination to query all account holders for.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/denom_owners/{denom} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"denom_owners": [
{
"address": "text",
"balance": {
"denom": "text",
"amount": "text"
}
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}Since: cosmos-sdk 0.50.3
denom defines the coin denomination to query all account holders for.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/denom_owners_by_query HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"denom_owners": [
{
"address": "text",
"balance": {
"denom": "text",
"amount": "text"
}
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/denoms_metadata HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"metadatas": [
{
"description": "text",
"denom_units": [
{
"denom": "text",
"exponent": 1,
"aliases": [
"text"
]
}
],
"base": "text",
"display": "text",
"name": "text",
"symbol": "text",
"uri": "text",
"uri_hash": "text"
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}denom is the coin denom to query the metadata for.
GET /cosmos/bank/v1beta1/denoms_metadata/{denom} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"metadata": {
"description": "text",
"denom_units": [
{
"denom": "text",
"exponent": 1,
"aliases": [
"text"
]
}
],
"base": "text",
"display": "text",
"name": "text",
"symbol": "text",
"uri": "text",
"uri_hash": "text"
}
}denom is the coin denom to query the metadata for.
GET /cosmos/bank/v1beta1/denoms_metadata_by_query_string HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"metadata": {
"description": "text",
"denom_units": [
{
"denom": "text",
"exponent": 1,
"aliases": [
"text"
]
}
],
"base": "text",
"display": "text",
"name": "text",
"symbol": "text",
"uri": "text",
"uri_hash": "text"
}
}GET /cosmos/bank/v1beta1/params HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"params": {
"send_enabled": [
{
"denom": "text",
"enabled": true
}
],
"default_send_enabled": true
}
}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
denoms is the specific denoms you want look up. Leave empty to get all entries.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/send_enabled HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"send_enabled": [
{
"denom": "text",
"enabled": true
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}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
address is the address to query spendable balances for.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/spendable_balances/{address} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"balances": [
{
"denom": "text",
"amount": "text"
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}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
address is the address to query balances for.
denom is the coin denom to query balances for.
GET /cosmos/bank/v1beta1/spendable_balances/{address}/by_denom HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"balance": {
"denom": "text",
"amount": "text"
}
}When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.
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.
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.
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.
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.
reverse is set to true if results are to be returned in the descending order.
Since: cosmos-sdk 0.43
GET /cosmos/bank/v1beta1/supply HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"supply": [
{
"denom": "text",
"amount": "text"
}
],
"pagination": {
"next_key": "Ynl0ZXM=",
"total": "text"
}
}When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.
denom is the coin denom to query balances for.
GET /cosmos/bank/v1beta1/supply/by_denom HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
"amount": {
"denom": "text",
"amount": "text"
}
}Last updated
Was this helpful?