Gets information about Token instance
| Field | Type | Description |
|---|---|---|
header |
QueryHeader | Standard info sent from client to node, including the signed payment, and what kind of response is requested (cost, state proof, both, or neither) |
token |
TokenID | The token for which information is requested. If invalid token is provided, INVALID_TOKEN_ID response is returned. |
Response when the client sends the node TokenGetInfoQuery
| Field | Type | Description |
|---|---|---|
header |
ResponseHeader | Standard response from node to client, including the requested fields: cost, or state proof, or both, or neither |
tokenInfo |
TokenInfo | The information requested about this token instance |
The metadata about a Token instance
| Field | Type | Description |
|---|---|---|
tokenId |
TokenID | ID of the token instance |
name |
string | The name of the token. It is a string of ASCII only characters |
symbol |
string | The symbol of the token. It is a UTF-8 capitalized alphabetical string |
decimals |
uint32 | The number of decimal places a token is divisible by |
totalSupply |
uint64 | The total supply of tokens that are currently in circulation |
treasury |
AccountID | The ID of the account which is set as Treasury |
adminKey |
Key | The key which can perform update/delete operations on the token. If empty, the token can be perceived as immutable (not being able to be updated/deleted) |
kycKey |
Key | The key which can grant or revoke KYC of an account for the token's transactions. If empty, KYC is not required, and KYC grant or revoke operations are not possible. |
freezeKey |
Key | The key which can freeze or unfreeze an account for token transactions. If empty, freezing is not possible |
wipeKey |
Key | The key which can wipe token balance of an account. If empty, wipe is not possible |
supplyKey |
Key | The key which can change the supply of a token. The key is used to sign Token Mint/Burn operations |
defaultFreezeStatus |
TokenFreezeStatus | The default Freeze status (not applicable, frozen or unfrozen) of Hedera accounts relative to this token. FreezeNotApplicable is returned if Token Freeze Key is empty. Frozen is returned if Token Freeze Key is set and defaultFreeze is set to true. Unfrozen is returned if Token Freeze Key is set and defaultFreeze is set to false |
defaultKycStatus |
TokenKycStatus | The default KYC status (KycNotApplicable or Revoked) of Hedera accounts relative to this token. KycNotApplicable is returned if KYC key is not set, otherwise Revoked |
isDeleted |
bool | Specifies whether the token was deleted or not |
autoRenewAccount |
AccountID | An account which will be automatically charged to renew the token's expiration, at autoRenewPeriod interval |
autoRenewPeriod |
uint64 | The interval at which the auto-renew account will be charged to extend the token's expiry |
expiry |
uint64 | The epoch second at which the token will expire; if an auto-renew account and period are specified, this is coerced to the current epoch second plus the autoRenewPeriod |
memo |
string | The memo associated with the token |
tokenType |
TokenType | The token type |
supplyType |
TokenSupplyType | The token supply type |
maxSupply |
int64 | For tokens of type FUNGIBLE_COMMON - The Maximum number of fungible tokens that can be in circulation. For tokens of type NON_FUNGIBLE_UNIQUE - the maximum number of NFTs (serial numbers) that can be in circulation |
fee_schedule_key |
Key | The key which can change the custom fee schedule of the token; if not set, the fee schedule is immutable |
custom_fees |
repeated CustomFee | The custom fees to be assessed during a CryptoTransfer that transfers units of this token |
pause_key |
Key | The Key which can pause and unpause the Token |
pause_status |
TokenPauseStatus | Specifies whether the token is paused or not. PauseNotApplicable is returned if pauseKey is not set. |
ledger_id |
bytes | The ledger ID the response was returned from; please see HIP-198 for the network-specific IDs. |