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
| Action | What it does |
|---|---|
| Find tokens | Find tokens and NFT collections by name, or list the newest ones created, with their ids, symbols and decimals. |
| 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). |
| 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. |
| Get HBAR supply | Get how much HBAR exists and how much has been released into circulation, now or at a past moment. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| List account NFTs | List the NFTs an account owns, newest collection first, each with its collection's name, serial number and metadata link. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| List staking rewards | List the staking rewards paid to an account, newest first, with the total, optionally between two dates. |
| 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. |
| 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. |
| 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. |
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
- Name
nametext - All or part of the token's name, at least 3 characters. Leave empty to list the newest tokens.
- Kind
token_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. - Order
ordertext - 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 results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Account
accounttextRequired - The account's id, e.g. 0.0.98, its EVM address (0x...) or its key alias. A HashScan link works too.
- Network
networktext - 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 of
atdate and time - Read it as it was at this moment. Leave empty for now.
- Network
networktext - 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 of
atdate and time - Read it as it was at this moment. Leave empty for now.
- Network
networktext - 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
- Collection
tokentextRequired - The NFT collection's token id, e.g. 0.0.1350444.
- Serial number
serial_numbernumberRequired - The NFT's serial number within its collection, e.g. 1.At least 1.
- Network
networktext - 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 contract
contracttextRequired - The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
- Network
networktext - 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
- Token
tokentextRequired - The token's id, e.g. 0.0.456858 for USDC.
- Network
networktext - 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
- Topic
topictextRequired - The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
- Message number
sequence_numbernumberRequired - The message's number in the topic: 1 for the first.At least 1.
- Network
networktext - 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 id
transaction_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.
- Network
networktext - 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
- Account
accounttextRequired - The account's id, e.g. 0.0.98, or its EVM address.
- Collection
tokentext - Only NFTs of this collection. Leave empty for every NFT.
- Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Account
accounttextRequired - The account's id, e.g. 0.0.98, or its EVM address.
- Only tokens held
held_onlytrue/false - Leave out tokens the account has associated but holds none of.Default:
true. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Account
accounttextRequired - The account that granted them, e.g. 0.0.98.
- Allowances for
allowance_typetext - Which kind of allowance to list. Defaults to HBAR.One of:
hbar,tokens,nfts. Default:hbar. - Spender
spendertext - Only allowances to this account. Leave empty for every spender.
- Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Network
networktext - 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
- Collection
tokentextRequired - The NFT collection's token id, e.g. 0.0.1350444.
- Serial number
serial_numbernumberRequired - The NFT's serial number within its collection, e.g. 1.At least 1.
- Order
ordertext - Newest or oldest first. Defaults to newest.One of:
desc(Newest first),asc(Oldest first). Default:desc. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Collection
tokentextRequired - The NFT collection's token id, e.g. 0.0.1350444.
- Owner
ownertext - Only NFTs this account owns. Leave empty for every NFT.
- Order
ordertext - Newest or oldest NFTs first. Defaults to newest.One of:
desc(Newest first),asc(Oldest first). Default:desc. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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 contract
contracttextRequired - The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
- Caller
callertext - Only calls from this account id or EVM address. Leave empty for every caller.
- From
from_timedate and time - Only include records from this moment on.
- Until
until_timedate and time - Only include records up to this moment.
- Order
ordertext - Newest or oldest calls first. Defaults to newest.One of:
desc(Newest first),asc(Oldest first). Default:desc. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Account
accounttextRequired - The account that was paid, e.g. 0.0.98.
- From
from_timedate and time - Only include records from this moment on.
- Until
until_timedate and time - Only include records up to this moment.
- Order
ordertext - Newest or oldest payouts first. Defaults to newest.One of:
desc(Newest first),asc(Oldest first). Default:desc. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Token
tokentextRequired - The token's id, e.g. 0.0.456858 for USDC.
- Holding at least
min_balancenumber - Only accounts holding at least this many whole tokens, e.g. 1000. Leave empty for every holder.At least 0.
- Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Topic
topictextRequired - The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
- After message number
after_sequence_numbernumber - Only messages after this one, e.g. the last number a previous run saw.At least 0.
- From
from_timedate and time - Only include records from this moment on.
- Until
until_timedate and time - Only include records up to this moment.
- Order
ordertext - 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 results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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
- Account
accounttext - Only transactions this account took part in, e.g. 0.0.98, or its EVM address. Leave empty for the whole network.
- Kind
transaction_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. - Outcome
resulttext - Only transactions that succeeded, or that failed.One of:
success(Succeeded),fail(Failed). - Direction
directiontext - 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)). - From
from_timedate and time - Only include records from this moment on.
- Until
until_timedate and time - Only include records up to this moment.
- Order
ordertext - Newest or oldest first. Defaults to newest.One of:
desc(Newest first),asc(Oldest first). Default:desc. - Number of results
limitnumber - How many to return, 1 to 100. Defaults to 25.From 1 to 100.
- Network
networktext - 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)"
}
]
}