Token Operations
resource: token — Hedera Token Service (HTS) metadata and balances
What is HTS? The Hedera Token Service is Hedera's native fungible/non-fungible token
framework — tokens created via HTS don't need a smart contract, and are queryable the same way as
native HBAR accounts through the Mirror Node.
getInfo
Returns metadata for a single token.
| Field | Type | Required | Description |
|---|---|---|---|
tokenId | text | ✓ Yes | HTS token ID, e.g. 0.0.12345 |
network | select | No | See Networks. |
{
"tokenId": "0.0.12345",
"name": "Example Token",
"symbol": "EXT",
"decimals": 2,
"totalSupply": 100000000,
"type": "FUNGIBLE_COMMON",
"treasuryAccountId": "0.0.98",
"deleted": false
}
| Response Field | Meaning |
|---|---|
type | FUNGIBLE_COMMON or NON_FUNGIBLE_UNIQUE |
treasuryAccountId | The account that holds newly minted supply and receives any un-set royalties. |
totalSupply | Raw integer supply — divide by 10^decimals for the display amount. |
getBalances
Returns an account's holdings across all tokens (or filtered), paginated.
| Field | Type | Required | Description |
|---|---|---|---|
accountId | text | ✓ Yes | Account whose token holdings to list |
limit | number | No | 1–100, default 25 |
network | select | No | See Networks. |
{
"accountId": "0.0.98",
"tokens": [
{ "tokenId": "0.0.12345", "balance": 50000, "decimals": 2 },
{ "tokenId": "0.0.67890", "balance": 1, "decimals": 0 }
]
}
Tip: This is the same data returned inline by
account.getBalance
(Account Operations), but as a dedicated, paginated call —
use token.getBalances when an account might hold more tokens than fit in one page.