Hedera

App · 20 actions

Read the Hedera network through its public mirror node: account balances, tokens, NFTs, allowances and staking rewards, transactions, token details and holders, NFT ownership and history, Consensus Service topic messages, smart contracts and their calls, the HBAR exchange rate and supply, and the network's nodes, on Mainnet or Testnet. Start a workflow when an account has a new transaction or a topic gets a new message. No account or API key required.

Actions

ActionWhat it does
Find tokensFind tokens and NFT collections by name, or list the newest ones created, with their ids, symbols and decimals.
Get accountGet a Hedera account: its HBAR balance, EVM address, memo, key, when it was created and expires, and its staking (the node it stakes to and rewards waiting to be paid).
Get HBAR exchange rateGet the HBAR to US dollar rate the Hedera network uses to set its fees, now or at a past moment, with the next hour's rate.
Get HBAR supplyGet how much HBAR exists and how much has been released into circulation, now or at a past moment.
Get NFTGet one NFT: who owns it, its metadata link, when it was minted and last moved, and whether someone is approved to move it.
Get smart contractGet a smart contract on Hedera: its EVM address, HBAR balance, memo, when it was deployed, whether it has an admin key and the size of its code.
Get tokenGet a token or NFT collection: its name, symbol, decimals, total and maximum supply, treasury account, the powers its keys give (mint, freeze, pause...) and the fees or royalties charged on transfers.
Get topic messageGet one message of a Hedera Consensus Service topic by its number, decoded to text, with who sent it and when it reached consensus.
Get transactionGet one Hedera transaction by its id: whether it succeeded, who paid, the fee, the memo, and every HBAR, token and NFT movement in it, with the transactions it triggered.
List account NFTsList the NFTs an account owns, newest collection first, each with its collection's name, serial number and metadata link.
List account tokensList the tokens and NFT collections an account holds, each with its name, symbol and balance in whole tokens, plus whether it is frozen or KYC granted for the account.
List allowancesList the allowances an account has granted: who may spend its HBAR or tokens, how much is left of what was granted, or which NFT collections someone may move for it.
List network nodesList Hedera's consensus nodes: who runs each and where, the HBAR staked to it, its reward rate and roughly what staking to it earns a year.
List NFT transfersList an NFT's history, newest first: when it was minted, each time it changed hands (who sent it, who received it) and whether it was burned.
List NFTs in a collectionList the NFTs of a collection, newest first, with each one's owner and metadata link, optionally only those one account owns.
List smart contract callsList the calls made to a smart contract, newest first: who called, the function, HBAR sent, gas used and, for a call that failed, the contract's own reason.
List staking rewardsList the staking rewards paid to an account, newest first, with the total, optionally between two dates.
List token holdersList the accounts holding a token, with each one's balance in whole tokens, optionally only those holding at least an amount.
List topic messagesList the messages sent to a Hedera Consensus Service topic, decoded to text: the newest first, or those after a message number you already have, oldest first.
List transactionsList Hedera transactions, newest first: of one account or the whole network, optionally only one kind, only successes or failures, only money in or out, or between two dates.

Find tokens

Find tokens and NFT collections by name, or list the newest ones created, with their ids, symbols and decimals. Anyone can create a token with any name, so check the id before trusting one.

Inputs

Namenametext
All or part of the token's name, at least 3 characters. Leave empty to list the newest tokens.
Kindtoken_typetext
Tokens, NFT collections or both. Defaults to both.One of: ALL (Tokens and NFT collections), FUNGIBLE_COMMON (Tokens only), NON_FUNGIBLE_UNIQUE (NFT collections only). Default: ALL.
Orderordertext
Defaults to oldest first when searching by name, so the original comes before later copies, and newest first otherwise.One of: desc (Newest first), asc (Oldest first).
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
tokenslist
The tokens found.
Example output
{
  "count": 2,
  "has_more": false,
  "network": "mainnet",
  "tokens": [
    {
      "decimals": 6,
      "hashscan_url": "https://hashscan.io/mainnet/token/0.0.456858",
      "name": "USD Coin",
      "symbol": "USDC",
      "token_id": "0.0.456858",
      "type": "FUNGIBLE_COMMON"
    },
    {
      "decimals": 8,
      "hashscan_url": "https://hashscan.io/mainnet/token/0.0.989029",
      "name": "USD Coin",
      "symbol": "USDC",
      "token_id": "0.0.989029",
      "type": "FUNGIBLE_COMMON"
    }
  ]
}

Get account

Get a Hedera account: its HBAR balance, EVM address, memo, key, when it was created and expires, and its staking (the node it stakes to and rewards waiting to be paid).

Inputs

AccountaccounttextRequired
The account's id, e.g. 0.0.98, its EVM address (0x...) or its key alias. A HashScan link works too.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account's id, e.g. 0.0.98.
aliastext
The account's public key alias, when it was created from one.
auto_renew_period_daysnumber
How often the account renews, in days.
balance_as_oftext
When the balance was read, ISO 8601 in UTC.
balance_hbarnumber
The account's HBAR balance.
balance_tinybarsnumber
The same balance in tinybars (100,000,000 to an HBAR).
created_attext
When the account was created, ISO 8601 in UTC.
declines_rewardstrue/false
True when the account turns staking rewards down.
deletedtrue/false
True when the account has been deleted.
ethereum_noncenumber
The account's Ethereum nonce.
evm_addresstext
The account's EVM address (0x...), for EVM wallets.
expires_attext
When the account is due to expire, ISO 8601 in UTC.
hashscan_urltext
The account's page on HashScan, Hedera's explorer.
keytext
The account's public key, in hex.
key_typetext
The kind of key that controls the account: ED25519, ECDSA_SECP256K1, or ProtobufEncoded for a key list or threshold key.
max_automatic_token_associationsnumber
How many tokens it can receive without associating them first (-1 for unlimited).
memotext
The account's memo, if it has one.
networktext
The network that was read: mainnet or testnet.
pending_reward_hbarnumber
Staking rewards earned but not yet paid out, in HBAR.
receiver_signature_requiredtrue/false
True when the account must sign to receive HBAR.
staked_account_idtext
The account it stakes to, if it stakes to one.
staked_node_idnumber
The node the account stakes to, or empty when it stakes to none.
staking_sincetext
When the account's current staking period began, ISO 8601 in UTC.
Example output
{
  "account_id": "0.0.3974944",
  "alias": null,
  "auto_renew_period_days": 90.0,
  "balance_as_of": "2026-10-20T07:32:44Z",
  "balance_hbar": 68129.68980992,
  "balance_tinybars": 6812968980992,
  "created_at": "2023-11-22T20:02:16Z",
  "declines_rewards": false,
  "deleted": false,
  "ethereum_nonce": 0,
  "evm_address": "0x00000000000000000000000000000000003ca720",
  "expires_at": "2024-02-20T20:02:16Z",
  "hashscan_url": "https://hashscan.io/mainnet/account/0.0.3974944",
  "key": "bc675b61e580589c200513c817560aa8887a702d1137283e6a425643c7792a07",
  "key_type": "ED25519",
  "max_automatic_token_associations": 10,
  "memo": null,
  "network": "mainnet",
  "pending_reward_hbar": 0.0,
  "receiver_signature_required": false,
  "staked_account_id": null,
  "staked_node_id": 35,
  "staking_since": "2026-10-19T00:00:00Z"
}

Get HBAR exchange rate

Get the HBAR to US dollar rate the Hedera network uses to set its fees, now or at a past moment, with the next hour's rate. It follows the market price, updated hourly.

Inputs

As ofatdate and time
Read it as it was at this moment. Leave empty for now.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

as_oftext
When the network last set the rates, ISO 8601.
cents_per_hbarnumber
US cents per HBAR.
hbar_per_usdnumber
HBAR per US dollar.
networktext
The network that was read: mainnet or testnet.
next_usd_per_hbarnumber
The rate that takes over next, in US dollars.
next_valid_untiltext
When the next rate is replaced, ISO 8601.
usd_per_hbarnumber
US dollars per HBAR.
valid_untiltext
When this rate is replaced, ISO 8601.
Example output
{
  "as_of": "2026-10-20T07:00:58Z",
  "cents_per_hbar": 8.327833,
  "hbar_per_usd": 12.007926,
  "network": "mainnet",
  "next_usd_per_hbar": 0.08364033,
  "next_valid_until": "2026-10-20T09:00:00Z",
  "usd_per_hbar": 0.08327833,
  "valid_until": "2026-10-20T08:00:00Z"
}

Get HBAR supply

Get how much HBAR exists and how much has been released into circulation, now or at a past moment.

Inputs

As ofatdate and time
Read it as it was at this moment. Leave empty for now.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

as_oftext
When the supply was read, ISO 8601.
networktext
The network that was read: mainnet or testnet.
released_percentnumber
The share released, in percent.
released_supply_hbarnumber
HBAR released into circulation.
total_supply_hbarnumber
All the HBAR that will ever exist.
unreleased_supply_hbarnumber
HBAR not yet released.
Example output
{
  "as_of": "2026-10-20T07:01:11Z",
  "network": "mainnet",
  "released_percent": 88.0543,
  "released_supply_hbar": 44027157628.47959,
  "total_supply_hbar": 50000000000.0,
  "unreleased_supply_hbar": 5972842371.520406
}

Get NFT

Get one NFT: who owns it, its metadata link, when it was minted and last moved, and whether someone is approved to move it. Useful for checking ownership before granting access.

Inputs

CollectiontokentextRequired
The NFT collection's token id, e.g. 0.0.1350444.
Serial numberserial_numbernumberRequired
The NFT's serial number within its collection, e.g. 1.At least 1.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

created_attext
When the NFT was minted, ISO 8601 in UTC.
delegating_spender_account_idtext
The account that delegated that approval, if any.
deletedtrue/false
True when the NFT has been burned.
hashscan_urltext
The NFT's page on HashScan.
metadatatext
The NFT's metadata as text, usually a link such as ipfs://... to its details and image. Empty when it is not text.
metadata_base64text
The metadata exactly as stored, base64 encoded.
modified_attext
When it last changed hands or changed, ISO 8601 in UTC.
networktext
The network that was read: mainnet or testnet.
owner_account_idtext
The account that owns the NFT now.
serial_numbernumber
The NFT's serial number within its collection.
spender_account_idtext
An account approved to transfer it, if any.
token_idtext
The NFT collection's token id.
token_nametext
The collection's name.
token_symboltext
The collection's symbol.
Example output
{
  "created_at": "2022-10-14T23:17:42Z",
  "delegating_spender_account_id": null,
  "deleted": false,
  "hashscan_url": "https://hashscan.io/mainnet/token/0.0.1350444/1",
  "metadata": "ipfs://QmceDZr2ackHxLyFnnXf7ZEmUh6CrYJX1mm5pjWDEV2PAf/1.json",
  "metadata_base64": "aXBmczovL1FtY2VEWnIyYWNrSHhMeUZublhmN1pFbVVoNkNyWUpYMW1tNXBqV0RFVjJQQWYvMS5qc29u",
  "modified_at": "2025-02-02T22:09:34Z",
  "network": "mainnet",
  "owner_account_id": "0.0.1736377",
  "serial_number": 1,
  "spender_account_id": null,
  "token_id": "0.0.1350444",
  "token_name": "HANGRY BARBOONS",
  "token_symbol": "HGRY BOONS"
}

Get smart contract

Get a smart contract on Hedera: its EVM address, HBAR balance, memo, when it was deployed, whether it has an admin key and the size of its code.

Inputs

Smart contractcontracttextRequired
The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

admin_key_typetext
The kind of admin key, or empty when it has none.
auto_renew_account_idtext
The account that pays to renew it.
auto_renew_period_daysnumber
How often it renews, in days.
balance_hbarnumber
The HBAR the contract holds.
bytecode_size_bytesnumber
The size of its deployed code, in bytes.
contract_idtext
The contract's id.
created_attext
When it was deployed, ISO 8601 in UTC.
deletedtrue/false
True when the contract has been deleted.
evm_addresstext
The contract's EVM address.
expires_attext
When it is due to expire, ISO 8601 in UTC.
file_idtext
The file its bytecode was deployed from, if any.
hashscan_urltext
The contract's page on HashScan.
max_automatic_token_associationsnumber
How many tokens it can receive without associating them first.
memotext
The contract's memo.
networktext
The network that was read: mainnet or testnet.
noncenumber
The contract's nonce.
Example output
{
  "admin_key_type": "ProtobufEncoded",
  "auto_renew_account_id": "0.0.1058134",
  "auto_renew_period_days": 90.0,
  "balance_hbar": 3198.84272729,
  "bytecode_size_bytes": 20117,
  "contract_id": "0.0.3045981",
  "created_at": "2023-06-27T02:38:32Z",
  "deleted": false,
  "evm_address": "0x00000000000000000000000000000000002e7a5d",
  "expires_at": "2023-09-25T02:38:32Z",
  "file_id": "0.0.3045977",
  "hashscan_url": "https://hashscan.io/mainnet/contract/0.0.3045981",
  "max_automatic_token_associations": 0,
  "memo": null,
  "network": "mainnet",
  "nonce": null
}

Get token

Get a token or NFT collection: its name, symbol, decimals, total and maximum supply, treasury account, the powers its keys give (mint, freeze, pause...) and the fees or royalties charged on transfers.

Inputs

TokentokentextRequired
The token's id, e.g. 0.0.456858 for USDC.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

auto_renew_account_idtext
The account that pays to renew it.
created_attext
When it was created, ISO 8601 in UTC.
custom_feeslist
Fees charged when the token is transferred.
decimalsnumber
How many decimal places it has.
deletedtrue/false
True when the token has been deleted.
expires_attext
When it is due to expire, ISO 8601 in UTC.
freeze_defaulttrue/false
True when new holders start frozen.
hashscan_urltext
The token's page on HashScan.
initial_supplynumber
How much was created with the token, in whole tokens.
keyslist
The powers someone holds over the token, e.g. admin, supply (mint and burn), freeze, kyc, wipe, pause, fee_schedule, metadata.
max_supplynumber
The most that can ever exist, in whole tokens. Empty when there is no limit.
memotext
The token's memo.
metadatatext
The token's metadata as text, if any.
modified_attext
When it last changed, ISO 8601 in UTC.
nametext
The token's name.
networktext
The network that was read: mainnet or testnet.
pause_statustext
PAUSED, UNPAUSED or NOT_APPLICABLE.
supply_typetext
FINITE or INFINITE.
symboltext
The token's symbol.
token_idtext
The token's id, e.g. 0.0.456858.
total_supplynumber
How much exists now, in whole tokens (NFTs: how many).
total_supply_rawnumber
The total supply in the smallest unit.
treasury_account_idtext
The account that holds newly minted supply.
typetext
FUNGIBLE_COMMON or NON_FUNGIBLE_UNIQUE (an NFT collection).
Example output
{
  "auto_renew_account_id": "0.0.869444",
  "created_at": "2022-10-14T22:34:05Z",
  "custom_fees": [
    {
      "amount": null,
      "collector_account_id": "0.0.1332229",
      "fee_type": "royalty",
      "percent": 6.0,
      "summary": "6% royalty fee to 0.0.1332229",
      "token_id": null
    },
    {
      "amount": null,
      "collector_account_id": "0.0.999404",
      "fee_type": "royalty",
      "percent": 1.0,
      "summary": "1% royalty fee to 0.0.999404",
      "token_id": null
    }
  ],
  "decimals": 0,
  "deleted": false,
  "expires_at": "2023-01-12T22:34:05Z",
  "freeze_default": false,
  "hashscan_url": "https://hashscan.io/mainnet/token/0.0.1350444",
  "initial_supply": 0.0,
  "keys": [
    "supply"
  ],
  "max_supply": 4444.0,
  "memo": null,
  "metadata": null,
  "modified_at": "2022-10-14T23:51:23Z",
  "name": "HANGRY BARBOONS",
  "network": "mainnet",
  "pause_status": "NOT_APPLICABLE",
  "supply_type": "FINITE",
  "symbol": "HGRY BOONS",
  "token_id": "0.0.1350444",
  "total_supply": 4444.0,
  "total_supply_raw": 4444,
  "treasury_account_id": "0.0.869444",
  "type": "NON_FUNGIBLE_UNIQUE"
}

Get topic message

Get one message of a Hedera Consensus Service topic by its number, decoded to text, with who sent it and when it reached consensus.

Inputs

TopictopictextRequired
The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
Message numbersequence_numbernumberRequired
The message's number in the topic: 1 for the first.At least 1.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

chunk_numbernumber
For a message sent in parts: which part this is.
chunk_totalnumber
For a message sent in parts: how many parts.
consensus_attext
The same moment, ISO 8601 in UTC.
consensus_timestamptext
When it reached consensus, seconds.nanoseconds.
hashscan_urltext
The message's transaction on HashScan.
messagetext
The message as text. Empty when it is not text, such as an encrypted or binary message.
message_base64text
The message exactly as sent, base64 encoded.
networktext
The network that was read: mainnet or testnet.
payer_account_idtext
The account that paid to send it.
running_hashtext
The topic's running hash after this message.
sequence_numbernumber
The message's number in its topic: 1 for the first.
topic_idtext
The topic the message was sent to.
Example output
{
  "chunk_number": 1,
  "chunk_total": 1,
  "consensus_at": "2022-10-21T14:38:39Z",
  "consensus_timestamp": "1666363119.634770003",
  "hashscan_url": "https://hashscan.io/mainnet/transaction/1666363119.634770003",
  "message": "Collect",
  "message_base64": "Q29sbGVjdA==",
  "network": "mainnet",
  "payer_account_id": "0.0.589629",
  "running_hash": "rvKi2s2XC3k8Apl212g0aSARWIawqRhT+AxOVYDxW2ZSGqi/oKrjSADrR3ENPUA7",
  "sequence_number": 1,
  "topic_id": "0.0.1368138"
}

Get transaction

Get one Hedera transaction by its id: whether it succeeded, who paid, the fee, the memo, and every HBAR, token and NFT movement in it, with the transactions it triggered.

Inputs

Transaction idtransaction_idtextRequired
The id as a wallet or HashScan shows it, e.g. 0.0.1234@1700000000.123456789, or as the mirror node writes it, e.g. 0.0.1234-1700000000-123456789.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

consensus_attext
The same moment, ISO 8601 in UTC.
consensus_timestamptext
When the network agreed on it, in the mirror node's seconds.nanoseconds form. Unique to this transaction.
entity_idtext
The account, token, topic, contract or file it created or acted on, if any.
fee_hbarnumber
The fee charged, in HBAR.
hashscan_urltext
The transaction's page on HashScan.
hbar_changenumber
When an account was given: that account's net HBAR change in the transaction, fees included. Empty otherwise.
hbar_transferslist
Every HBAR movement, fees included.
memotext
The transaction's memo, if it has one.
networktext
The network that was read: mainnet or testnet.
nft_transferslist
Every NFT moved, minted or burned.
nodetext
The node that submitted it.
noncenumber
0 for a transaction someone submitted, higher for one it triggered.
payer_account_idtext
The account that paid for it.
related_transactionslist
Other transactions under the same id: those this one triggered (nonce above 0) and, for a schedule, the scheduled transaction itself.
resulttext
The outcome, e.g. SUCCESS or INSUFFICIENT_PAYER_BALANCE.
scheduledtrue/false
True when it ran from a schedule.
staking_reward_transferslist
Staking rewards paid out with this transaction.
succeededtrue/false
True when it succeeded.
token_transferslist
Every movement of fungible tokens.
transaction_hashtext
The transaction's hash, base64 encoded.
transaction_idtext
The transaction's id, e.g. 0.0.10641751-1792481584-879725814 (wallets write it 0.0.10641751@1792481584.879725814).
typetext
The kind of transaction, e.g. CRYPTOTRANSFER or TOKENMINT.
type_labeltext
The kind in words, e.g. 'Transfer' or 'Mint token'.
Example output
{
  "consensus_at": "2026-10-20T07:07:03Z",
  "consensus_timestamp": "1792480023.217654104",
  "entity_id": null,
  "fee_hbar": 0.01200791,
  "hashscan_url": "https://hashscan.io/mainnet/transaction/1792480023.217654104",
  "hbar_change": null,
  "hbar_transfers": [
    {
      "account_id": "0.0.802",
      "amount_hbar": 0.01200791,
      "amount_tinybars": 1200791,
      "is_approval": false
    },
    {
      "account_id": "0.0.439415",
      "amount_hbar": -0.01200791,
      "amount_tinybars": -1200791,
      "is_approval": false
    }
  ],
  "memo": "internal",
  "network": "mainnet",
  "nft_transfers": [],
  "node": "0.0.18",
  "nonce": 0,
  "payer_account_id": "0.0.439415",
  "related_transactions": [],
  "result": "SUCCESS",
  "scheduled": false,
  "staking_reward_transfers": [],
  "succeeded": true,
  "token_transfers": [
    {
      "account_id": "0.0.439415",
      "amount": -1163332.7,
      "amount_raw": -1163332700000,
      "is_approval": false,
      "token_id": "0.0.456858",
      "token_symbol": "USDC"
    },
    {
      "account_id": "0.0.439717",
      "amount": 1163332.7,
      "amount_raw": 1163332700000,
      "is_approval": false,
      "token_id": "0.0.456858",
      "token_symbol": "USDC"
    }
  ],
  "transaction_hash": "nkxQl7XTjLMujIvYg5uRUNdHvoytyWrQMlxUz5aXaBjfyC5zXFXs8dmlZetw5G4t",
  "transaction_id": "0.0.439415-1792480017-368443006",
  "type": "CRYPTOTRANSFER",
  "type_label": "Transfer (HBAR, tokens or NFTs)"
}

List account NFTs

List the NFTs an account owns, newest collection first, each with its collection's name, serial number and metadata link. Narrow it to one collection to check whether the account owns one of its NFTs.

Inputs

AccountaccounttextRequired
The account's id, e.g. 0.0.98, or its EVM address.
Collectiontokentext
Only NFTs of this collection. Leave empty for every NFT.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account read.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
nftslist
The NFTs.
Example output
{
  "account_id": "0.0.1736377",
  "count": 1,
  "has_more": true,
  "network": "mainnet",
  "nfts": [
    {
      "created_at": "2025-02-20T12:55:28Z",
      "delegating_spender_account_id": null,
      "deleted": false,
      "hashscan_url": "https://hashscan.io/mainnet/token/0.0.7933967/16",
      "metadata": "ipfs://QmZW1t2md7eHtHML9LfhpkbK364rt3JWLPxzNLKFLpqYuW",
      "metadata_base64": "aXBmczovL1FtWlcxdDJtZDdlSHRITUw5TGZocGtiSzM2NHJ0M0pXTFB4ek5MS0ZMcHFZdVc=",
      "modified_at": "2025-02-20T12:57:50Z",
      "owner_account_id": "0.0.1736377",
      "serial_number": 16,
      "spender_account_id": null,
      "token_id": "0.0.7933967",
      "token_name": "WDS#3",
      "token_symbol": "wds3"
    }
  ]
}

List account tokens

List the tokens and NFT collections an account holds, each with its name, symbol and balance in whole tokens, plus whether it is frozen or KYC granted for the account.

Inputs

AccountaccounttextRequired
The account's id, e.g. 0.0.98, or its EVM address.
Only tokens heldheld_onlytrue/false
Leave out tokens the account has associated but holds none of.Default: true.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account read.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
tokenslist
The tokens, in order of token id.
Example output
{
  "account_id": "0.0.1736377",
  "count": 2,
  "has_more": true,
  "network": "mainnet",
  "tokens": [
    {
      "associated_at": "2024-04-05T19:01:39Z",
      "automatic_association": false,
      "balance": 2.0,
      "balance_raw": 2,
      "decimals": 0,
      "freeze_status": "NOT_APPLICABLE",
      "kyc_status": "NOT_APPLICABLE",
      "name": "HGraph Punks",
      "symbol": "HGP",
      "token_id": "0.0.817591",
      "type": "NON_FUNGIBLE_UNIQUE"
    },
    {
      "associated_at": "2023-01-24T06:11:49Z",
      "automatic_association": false,
      "balance": 19.0,
      "balance_raw": 19,
      "decimals": 0,
      "freeze_status": "NOT_APPLICABLE",
      "kyc_status": "NOT_APPLICABLE",
      "name": "Golden Banana Coin",
      "symbol": "GBC",
      "token_id": "0.0.1124044",
      "type": "NON_FUNGIBLE_UNIQUE"
    }
  ]
}

List allowances

List the allowances an account has granted: who may spend its HBAR or tokens, how much is left of what was granted, or which NFT collections someone may move for it. Handy for checking what apps can still spend from a wallet.

Inputs

AccountaccounttextRequired
The account that granted them, e.g. 0.0.98.
Allowances forallowance_typetext
Which kind of allowance to list. Defaults to HBAR.One of: hbar, tokens, nfts. Default: hbar.
Spenderspendertext
Only allowances to this account. Leave empty for every spender.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account read.
allowance_typetext
Which allowances were listed: hbar, tokens or nfts.
allowanceslist
The allowances.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
Example output
{
  "account_id": "0.0.2031766",
  "allowance_type": "tokens",
  "allowances": [
    {
      "allowance_type": "tokens",
      "amount": 25.0,
      "amount_granted": 275.0,
      "amount_granted_raw": 275000000,
      "amount_raw": 25000000,
      "approved_for_all": null,
      "granted_at": "2026-06-06T16:02:50Z",
      "owner_account_id": "0.0.2031766",
      "spender_account_id": "0.0.3045981",
      "token_id": "0.0.4794920",
      "token_symbol": "PACK"
    }
  ],
  "count": 1,
  "has_more": true,
  "network": "mainnet"
}

List network nodes

List Hedera's consensus nodes: who runs each and where, the HBAR staked to it, its reward rate and roughly what staking to it earns a year. Use a node's id to stake to it from a wallet.

Inputs

Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
nodeslist
The nodes, by node id.
total_stake_hbarnumber
The stake of the nodes listed, added up, in HBAR.
Example output
{
  "count": 1,
  "has_more": false,
  "network": "mainnet",
  "nodes": [
    {
      "annual_reward_rate_percent": 1.8604,
      "declines_rewards": false,
      "description": "Hosted by LG | Singapore",
      "max_stake_hbar": 450000000.0,
      "min_stake_hbar": 0.0,
      "node_account_id": "0.0.3",
      "node_id": 0,
      "reward_rate_tinybars_per_hbar": 5097,
      "service_endpoints": [
        "34.64.136.190:50211",
        "34.64.136.190:50212",
        "43.202.249.148:50211",
        "43.202.249.148:50212"
      ],
      "stake_hbar": 436136654.0,
      "stake_not_rewarded_hbar": 1090786.0,
      "stake_rewarded_hbar": 435045868.0,
      "staking_period_end": "2026-10-21T00:00:00Z",
      "staking_period_start": "2026-10-20T00:00:00Z"
    }
  ],
  "total_stake_hbar": 436136654.0
}

List NFT transfers

List an NFT's history, newest first: when it was minted, each time it changed hands (who sent it, who received it) and whether it was burned.

Inputs

CollectiontokentextRequired
The NFT collection's token id, e.g. 0.0.1350444.
Serial numberserial_numbernumberRequired
The NFT's serial number within its collection, e.g. 1.At least 1.
Orderordertext
Newest or oldest first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
serial_numbernumber
The NFT's serial number.
token_idtext
The token read.
transferslist
The NFT's transactions.
Example output
{
  "count": 2,
  "has_more": true,
  "network": "mainnet",
  "serial_number": 1,
  "token_id": "0.0.1350444",
  "transfers": [
    {
      "consensus_at": "2025-02-02T22:09:34Z",
      "consensus_timestamp": "1738534174.774406000",
      "hashscan_url": "https://hashscan.io/mainnet/transaction/1738534174.774406000",
      "is_approval": false,
      "receiver_account_id": "0.0.1736377",
      "sender_account_id": "0.0.1503696",
      "transaction_id": "0.0.1503696-1738534162-140701986",
      "type": "CRYPTOTRANSFER",
      "type_label": "Transfer (HBAR, tokens or NFTs)"
    },
    {
      "consensus_at": "2025-02-02T04:50:04Z",
      "consensus_timestamp": "1738471804.645228000",
      "hashscan_url": "https://hashscan.io/mainnet/transaction/1738471804.645228000",
      "is_approval": false,
      "receiver_account_id": "0.0.1503696",
      "sender_account_id": "0.0.4446245",
      "transaction_id": "0.0.4446245-1738471796-692405952",
      "type": "CRYPTOTRANSFER",
      "type_label": "Transfer (HBAR, tokens or NFTs)"
    }
  ]
}

List NFTs in a collection

List the NFTs of a collection, newest first, with each one's owner and metadata link, optionally only those one account owns.

Inputs

CollectiontokentextRequired
The NFT collection's token id, e.g. 0.0.1350444.
Ownerownertext
Only NFTs this account owns. Leave empty for every NFT.
Orderordertext
Newest or oldest NFTs first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
nftslist
The NFTs.
token_idtext
The token read.
token_nametext
The collection's name.
token_symboltext
The collection's symbol.
Example output
{
  "count": 1,
  "has_more": true,
  "network": "mainnet",
  "nfts": [
    {
      "created_at": "2022-10-14T23:51:23Z",
      "delegating_spender_account_id": null,
      "deleted": false,
      "hashscan_url": "https://hashscan.io/mainnet/token/0.0.1350444/4444",
      "metadata": "ipfs://QmceDZr2ackHxLyFnnXf7ZEmUh6CrYJX1mm5pjWDEV2PAf/4444.json",
      "metadata_base64": "aXBmczovL1FtY2VEWnIyYWNrSHhMeUZublhmN1pFbVVoNkNyWUpYMW1tNXBqV0RFVjJQQWYvNDQ0NC5qc29u",
      "modified_at": "2025-07-12T08:52:04Z",
      "owner_account_id": "0.0.9361441",
      "serial_number": 4444,
      "spender_account_id": null,
      "token_id": "0.0.1350444",
      "token_name": "HANGRY BARBOONS",
      "token_symbol": "HGRY BOONS"
    }
  ],
  "token_id": "0.0.1350444",
  "token_name": "HANGRY BARBOONS",
  "token_symbol": "HGRY BOONS"
}

List smart contract calls

List the calls made to a smart contract, newest first: who called, the function, HBAR sent, gas used and, for a call that failed, the contract's own reason. Optionally only one caller's calls, or between two dates.

Inputs

Smart contractcontracttextRequired
The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
Callercallertext
Only calls from this account id or EVM address. Leave empty for every caller.
Fromfrom_timedate and time
Only include records from this moment on.
Untiluntil_timedate and time
Only include records up to this moment.
Orderordertext
Newest or oldest calls first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

callslist
The calls.
contract_idtext
The contract read.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
Example output
{
  "calls": [
    {
      "amount_hbar": 1.0,
      "called_at": "2026-10-20T07:04:23Z",
      "error": null,
      "from_account_id": "0.0.1682289",
      "from_address": "0x000000000000000000000000000000000019ab71",
      "function_selector": "0x7ff36ab5",
      "gas_limit": 1120000,
      "gas_used": 143079,
      "hashscan_url": "https://hashscan.io/mainnet/transaction/1792479863.473901104",
      "succeeded": true,
      "timestamp": "1792479863.473901104",
      "to_address": "0x00000000000000000000000000000000002e7a5d",
      "transaction_hash": "0x341216952ef134125caaf72c9fa223febf22255352574b20238ac486ab2da40e"
    }
  ],
  "contract_id": "0.0.3045981",
  "count": 1,
  "has_more": true,
  "network": "mainnet"
}

List staking rewards

List the staking rewards paid to an account, newest first, with the total, optionally between two dates. Useful for tracking staking income or tax records.

Inputs

AccountaccounttextRequired
The account that was paid, e.g. 0.0.98.
Fromfrom_timedate and time
Only include records from this moment on.
Untiluntil_timedate and time
Only include records up to this moment.
Orderordertext
Newest or oldest payouts first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account read.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
rewardslist
The payouts.
total_hbarnumber
The payouts listed, added up, in HBAR.
Example output
{
  "account_id": "0.0.3974944",
  "count": 2,
  "has_more": true,
  "network": "mainnet",
  "rewards": [
    {
      "amount_hbar": 3.47217834,
      "amount_tinybars": 347217834,
      "paid_at": "2026-10-20T07:32:44Z",
      "timestamp": "1792481564.694311104"
    },
    {
      "amount_hbar": 3.47066305,
      "amount_tinybars": 347066305,
      "paid_at": "2026-10-19T06:42:35Z",
      "timestamp": "1792392155.579917104"
    }
  ],
  "total_hbar": 6.94284139
}

List token holders

List the accounts holding a token, with each one's balance in whole tokens, optionally only those holding at least an amount. Accounts holding none are left out.

Inputs

TokentokentextRequired
The token's id, e.g. 0.0.456858 for USDC.
Holding at leastmin_balancenumber
Only accounts holding at least this many whole tokens, e.g. 1000. Leave empty for every holder.At least 0.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

as_oftext
When the balances were read, ISO 8601 in UTC.
countnumber
How many records came back.
decimalsnumber
The token's decimal places.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
holderslist
The holders, newest accounts first.
nametext
The token's name.
networktext
The network that was read: mainnet or testnet.
symboltext
The token's symbol.
token_idtext
The token read.
Example output
{
  "as_of": "2026-10-20T07:47:45Z",
  "count": 2,
  "decimals": 6,
  "has_more": true,
  "holders": [
    {
      "account_id": "0.0.10478184",
      "balance": 2602356.044328,
      "balance_raw": 2602356044328
    },
    {
      "account_id": "0.0.3964804",
      "balance": 1181497.247564,
      "balance_raw": 1181497247564
    }
  ],
  "name": "USD Coin",
  "network": "mainnet",
  "symbol": "USDC",
  "token_id": "0.0.456858"
}

List topic messages

List the messages sent to a Hedera Consensus Service topic, decoded to text: the newest first, or those after a message number you already have, oldest first. Optionally only those between two dates.

Inputs

TopictopictextRequired
The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
After message numberafter_sequence_numbernumber
Only messages after this one, e.g. the last number a previous run saw.At least 0.
Fromfrom_timedate and time
Only include records from this moment on.
Untiluntil_timedate and time
Only include records up to this moment.
Orderordertext
Defaults to oldest first after a message number, so none in between are skipped, and newest first otherwise.One of: desc (Newest first), asc (Oldest first).
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
messageslist
The messages.
networktext
The network that was read: mainnet or testnet.
topic_idtext
The topic read.
Example output
{
  "count": 1,
  "has_more": true,
  "messages": [
    {
      "chunk_number": 1,
      "chunk_total": 1,
      "consensus_at": "2026-10-20T07:47:24Z",
      "consensus_timestamp": "1792482444.994045043",
      "hashscan_url": "https://hashscan.io/mainnet/transaction/1792482444.994045043",
      "message": "Collect",
      "message_base64": "Q29sbGVjdA==",
      "payer_account_id": "0.0.10053473",
      "running_hash": "oERjB6laLK76YAowbveAnRqBDlLYrPGwKsQ0KynvRhDzqms5RdXE+jzz2YcrODS9",
      "sequence_number": 2827027,
      "topic_id": "0.0.1368138"
    }
  ],
  "network": "mainnet",
  "topic_id": "0.0.1368138"
}

List transactions

List Hedera transactions, newest first: of one account or the whole network, optionally only one kind, only successes or failures, only money in or out, or between two dates. Each comes with every HBAR, token and NFT movement in it, the fee and the memo.

Inputs

Accountaccounttext
Only transactions this account took part in, e.g. 0.0.98, or its EVM address. Leave empty for the whole network.
Kindtransaction_typetext
Only this kind of transaction. Leave empty for all.One of: CRYPTOTRANSFER (Transfer (HBAR, tokens or NFTs)), CRYPTOCREATEACCOUNT (Create account), CRYPTOUPDATEACCOUNT (Update account), CRYPTODELETE (Delete account), CRYPTOAPPROVEALLOWANCE (Approve allowance), CRYPTODELETEALLOWANCE (Delete allowance), CONSENSUSSUBMITMESSAGE (Submit topic message), CONSENSUSCREATETOPIC (Create topic), CONSENSUSUPDATETOPIC (Update topic), CONSENSUSDELETETOPIC (Delete topic), and 34 more.
Outcomeresulttext
Only transactions that succeeded, or that failed.One of: success (Succeeded), fail (Failed).
Directiondirectiontext
With an account: only transactions in which HBAR, tokens or NFTs came in to it, or went out of it. Paying a fee alone counts as neither.One of: received (Received (HBAR, tokens or NFTs came in)), sent (Sent (HBAR, tokens or NFTs went out)).
Fromfrom_timedate and time
Only include records from this moment on.
Untiluntil_timedate and time
Only include records up to this moment.
Orderordertext
Newest or oldest first. Defaults to newest.One of: desc (Newest first), asc (Oldest first). Default: desc.
Number of resultslimitnumber
How many to return, 1 to 100. Defaults to 25.From 1 to 100.
Networknetworktext
Which Hedera network to read. Defaults to Mainnet.One of: mainnet, testnet. Default: mainnet.

Outputs

account_idtext
The account the list was narrowed to, if any.
countnumber
How many records came back.
has_moretrue/false
True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
networktext
The network that was read: mainnet or testnet.
transactionslist
The transactions.
Example output
{
  "account_id": "0.0.439717",
  "count": 1,
  "has_more": true,
  "network": "mainnet",
  "transactions": [
    {
      "consensus_at": "2026-10-20T07:07:03Z",
      "consensus_timestamp": "1792480023.217654104",
      "entity_id": null,
      "fee_hbar": 0.01200791,
      "hashscan_url": "https://hashscan.io/mainnet/transaction/1792480023.217654104",
      "hbar_change": 0.0,
      "hbar_transfers": [
        {
          "account_id": "0.0.802",
          "amount_hbar": 0.01200791,
          "amount_tinybars": 1200791,
          "is_approval": false
        },
        {
          "account_id": "0.0.439415",
          "amount_hbar": -0.01200791,
          "amount_tinybars": -1200791,
          "is_approval": false
        }
      ],
      "memo": "internal",
      "nft_transfers": [],
      "node": "0.0.18",
      "nonce": 0,
      "payer_account_id": "0.0.439415",
      "result": "SUCCESS",
      "scheduled": false,
      "staking_reward_transfers": [],
      "succeeded": true,
      "token_transfers": [
        {
          "account_id": "0.0.439415",
          "amount": -1163332.7,
          "amount_raw": -1163332700000,
          "is_approval": false,
          "token_id": "0.0.456858",
          "token_symbol": "USDC"
        },
        {
          "account_id": "0.0.439717",
          "amount": 1163332.7,
          "amount_raw": 1163332700000,
          "is_approval": false,
          "token_id": "0.0.456858",
          "token_symbol": "USDC"
        }
      ],
      "transaction_hash": "nkxQl7XTjLMujIvYg5uRUNdHvoytyWrQMlxUz5aXaBjfyC5zXFXs8dmlZetw5G4t",
      "transaction_id": "0.0.439415-1792480017-368443006",
      "type": "CRYPTOTRANSFER",
      "type_label": "Transfer (HBAR, tokens or NFTs)"
    }
  ]
}

On this page