Denom Metadata & Holders
Assetmanager Denom Metadata (v1.0.0)
Download OpenAPI specification:Download
API Documentation for Assetmanager Denom Metadata
DenomOwners
DenomOwners queries for all account addresses that own a particular token denomination.
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
Authorizations:
path Parameters
| denom required | string (denom) denom defines the coin denomination to query all account holders for. |
query Parameters
| pagination.key | string <byte> (key) 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.offset | integer or string <int64> (offset) 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.limit | integer or string <int64> (limit) 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.countTotal | boolean (count_total) 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.reverse | boolean (reverse) reverse is set to true if results are to be returned in the descending order. Since: cosmos-sdk 0.43 |
Responses
Response samples
- 200
{- "denomOwners": [
- {
- "address": "string",
- "balance": {
- "denom": "string",
- "amount": "string"
}
}
], - "pagination": {
- "nextKey": "string",
- "total": 0
}
}DenomsMetadata
DenomsMetadata queries the client metadata for all registered coin denominations.
Authorizations:
query Parameters
| pagination.key | string <byte> (key) 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.offset | integer or string <int64> (offset) 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.limit | integer or string <int64> (limit) 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.countTotal | boolean (count_total) 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.reverse | boolean (reverse) reverse is set to true if results are to be returned in the descending order. Since: cosmos-sdk 0.43 |
Responses
Response samples
- 200
{- "metadatas": [
- {
- "description": "string",
- "denomUnits": [
- {
- "denom": "string",
- "exponent": 0,
- "aliases": [
- "string"
]
}
], - "base": "string",
- "display": "string",
- "name": "string",
- "symbol": "string",
- "uri": "string",
- "uriHash": "string"
}
], - "pagination": {
- "nextKey": "string",
- "total": 0
}
}DenomMetadata
DenomMetadata queries the client metadata of a given coin denomination.
Authorizations:
path Parameters
| denom required | string (denom) denom is the coin denom to query the metadata for. |
Responses
Response samples
- 200
{- "metadata": {
- "description": "string",
- "denomUnits": [
- {
- "denom": "string",
- "exponent": 0,
- "aliases": [
- "string"
]
}
], - "base": "string",
- "display": "string",
- "name": "string",
- "symbol": "string",
- "uri": "string",
- "uriHash": "string"
}
}