# Hedera

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/hedera

## Actions

### 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 (`name`, text): All or part of the token's name, at least 3 characters. Leave empty to list the newest tokens.
- Kind (`token_type`, text): 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 (`order`, text): 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 (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `tokens` (list): The tokens found.

**Example output**

```json
{
  "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 (`account`, text, required): The account's id, e.g. 0.0.98, its EVM address (0x...) or its key alias. A HashScan link works too.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account's id, e.g. 0.0.98.
- `alias` (text): The account's public key alias, when it was created from one.
- `auto_renew_period_days` (number): How often the account renews, in days.
- `balance_as_of` (text): When the balance was read, ISO 8601 in UTC.
- `balance_hbar` (number): The account's HBAR balance.
- `balance_tinybars` (number): The same balance in tinybars (100,000,000 to an HBAR).
- `created_at` (text): When the account was created, ISO 8601 in UTC.
- `declines_rewards` (true/false): True when the account turns staking rewards down.
- `deleted` (true/false): True when the account has been deleted.
- `ethereum_nonce` (number): The account's Ethereum nonce.
- `evm_address` (text): The account's EVM address (0x...), for EVM wallets.
- `expires_at` (text): When the account is due to expire, ISO 8601 in UTC.
- `hashscan_url` (text): The account's page on HashScan, Hedera's explorer.
- `key` (text): The account's public key, in hex.
- `key_type` (text): The kind of key that controls the account: ED25519, ECDSA_SECP256K1, or ProtobufEncoded for a key list or threshold key.
- `max_automatic_token_associations` (number): How many tokens it can receive without associating them first (-1 for unlimited).
- `memo` (text): The account's memo, if it has one.
- `network` (text): The network that was read: mainnet or testnet.
- `pending_reward_hbar` (number): Staking rewards earned but not yet paid out, in HBAR.
- `receiver_signature_required` (true/false): True when the account must sign to receive HBAR.
- `staked_account_id` (text): The account it stakes to, if it stakes to one.
- `staked_node_id` (number): The node the account stakes to, or empty when it stakes to none.
- `staking_since` (text): When the account's current staking period began, ISO 8601 in UTC.

**Example output**

```json
{
  "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 (`at`, date and time): Read it as it was at this moment. Leave empty for now.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `as_of` (text): When the network last set the rates, ISO 8601.
- `cents_per_hbar` (number): US cents per HBAR.
- `hbar_per_usd` (number): HBAR per US dollar.
- `network` (text): The network that was read: mainnet or testnet.
- `next_usd_per_hbar` (number): The rate that takes over next, in US dollars.
- `next_valid_until` (text): When the next rate is replaced, ISO 8601.
- `usd_per_hbar` (number): US dollars per HBAR.
- `valid_until` (text): When this rate is replaced, ISO 8601.

**Example output**

```json
{
  "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 (`at`, date and time): Read it as it was at this moment. Leave empty for now.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `as_of` (text): When the supply was read, ISO 8601.
- `network` (text): The network that was read: mainnet or testnet.
- `released_percent` (number): The share released, in percent.
- `released_supply_hbar` (number): HBAR released into circulation.
- `total_supply_hbar` (number): All the HBAR that will ever exist.
- `unreleased_supply_hbar` (number): HBAR not yet released.

**Example output**

```json
{
  "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 (`token`, text, required): The NFT collection's token id, e.g. 0.0.1350444.
- Serial number (`serial_number`, number, required): The NFT's serial number within its collection, e.g. 1. At least 1.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `created_at` (text): When the NFT was minted, ISO 8601 in UTC.
- `delegating_spender_account_id` (text): The account that delegated that approval, if any.
- `deleted` (true/false): True when the NFT has been burned.
- `hashscan_url` (text): The NFT's page on HashScan.
- `metadata` (text): The NFT's metadata as text, usually a link such as ipfs://... to its details and image. Empty when it is not text.
- `metadata_base64` (text): The metadata exactly as stored, base64 encoded.
- `modified_at` (text): When it last changed hands or changed, ISO 8601 in UTC.
- `network` (text): The network that was read: mainnet or testnet.
- `owner_account_id` (text): The account that owns the NFT now.
- `serial_number` (number): The NFT's serial number within its collection.
- `spender_account_id` (text): An account approved to transfer it, if any.
- `token_id` (text): The NFT collection's token id.
- `token_name` (text): The collection's name.
- `token_symbol` (text): The collection's symbol.

**Example output**

```json
{
  "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 (`contract`, text, required): The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `admin_key_type` (text): The kind of admin key, or empty when it has none.
- `auto_renew_account_id` (text): The account that pays to renew it.
- `auto_renew_period_days` (number): How often it renews, in days.
- `balance_hbar` (number): The HBAR the contract holds.
- `bytecode_size_bytes` (number): The size of its deployed code, in bytes.
- `contract_id` (text): The contract's id.
- `created_at` (text): When it was deployed, ISO 8601 in UTC.
- `deleted` (true/false): True when the contract has been deleted.
- `evm_address` (text): The contract's EVM address.
- `expires_at` (text): When it is due to expire, ISO 8601 in UTC.
- `file_id` (text): The file its bytecode was deployed from, if any.
- `hashscan_url` (text): The contract's page on HashScan.
- `max_automatic_token_associations` (number): How many tokens it can receive without associating them first.
- `memo` (text): The contract's memo.
- `network` (text): The network that was read: mainnet or testnet.
- `nonce` (number): The contract's nonce.

**Example output**

```json
{
  "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 (`token`, text, required): The token's id, e.g. 0.0.456858 for USDC.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `auto_renew_account_id` (text): The account that pays to renew it.
- `created_at` (text): When it was created, ISO 8601 in UTC.
- `custom_fees` (list): Fees charged when the token is transferred.
- `decimals` (number): How many decimal places it has.
- `deleted` (true/false): True when the token has been deleted.
- `expires_at` (text): When it is due to expire, ISO 8601 in UTC.
- `freeze_default` (true/false): True when new holders start frozen.
- `hashscan_url` (text): The token's page on HashScan.
- `initial_supply` (number): How much was created with the token, in whole tokens.
- `keys` (list): The powers someone holds over the token, e.g. admin, supply (mint and burn), freeze, kyc, wipe, pause, fee_schedule, metadata.
- `max_supply` (number): The most that can ever exist, in whole tokens. Empty when there is no limit.
- `memo` (text): The token's memo.
- `metadata` (text): The token's metadata as text, if any.
- `modified_at` (text): When it last changed, ISO 8601 in UTC.
- `name` (text): The token's name.
- `network` (text): The network that was read: mainnet or testnet.
- `pause_status` (text): PAUSED, UNPAUSED or NOT_APPLICABLE.
- `supply_type` (text): FINITE or INFINITE.
- `symbol` (text): The token's symbol.
- `token_id` (text): The token's id, e.g. 0.0.456858.
- `total_supply` (number): How much exists now, in whole tokens (NFTs: how many).
- `total_supply_raw` (number): The total supply in the smallest unit.
- `treasury_account_id` (text): The account that holds newly minted supply.
- `type` (text): FUNGIBLE_COMMON or NON_FUNGIBLE_UNIQUE (an NFT collection).

**Example output**

```json
{
  "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 (`topic`, text, required): The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
- Message number (`sequence_number`, number, required): The message's number in the topic: 1 for the first. At least 1.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `chunk_number` (number): For a message sent in parts: which part this is.
- `chunk_total` (number): For a message sent in parts: how many parts.
- `consensus_at` (text): The same moment, ISO 8601 in UTC.
- `consensus_timestamp` (text): When it reached consensus, seconds.nanoseconds.
- `hashscan_url` (text): The message's transaction on HashScan.
- `message` (text): The message as text. Empty when it is not text, such as an encrypted or binary message.
- `message_base64` (text): The message exactly as sent, base64 encoded.
- `network` (text): The network that was read: mainnet or testnet.
- `payer_account_id` (text): The account that paid to send it.
- `running_hash` (text): The topic's running hash after this message.
- `sequence_number` (number): The message's number in its topic: 1 for the first.
- `topic_id` (text): The topic the message was sent to.

**Example output**

```json
{
  "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_id`, text, required): 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 (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `consensus_at` (text): The same moment, ISO 8601 in UTC.
- `consensus_timestamp` (text): When the network agreed on it, in the mirror node's seconds.nanoseconds form. Unique to this transaction.
- `entity_id` (text): The account, token, topic, contract or file it created or acted on, if any.
- `fee_hbar` (number): The fee charged, in HBAR.
- `hashscan_url` (text): The transaction's page on HashScan.
- `hbar_change` (number): When an account was given: that account's net HBAR change in the transaction, fees included. Empty otherwise.
- `hbar_transfers` (list): Every HBAR movement, fees included.
- `memo` (text): The transaction's memo, if it has one.
- `network` (text): The network that was read: mainnet or testnet.
- `nft_transfers` (list): Every NFT moved, minted or burned.
- `node` (text): The node that submitted it.
- `nonce` (number): 0 for a transaction someone submitted, higher for one it triggered.
- `payer_account_id` (text): The account that paid for it.
- `related_transactions` (list): Other transactions under the same id: those this one triggered (nonce above 0) and, for a schedule, the scheduled transaction itself.
- `result` (text): The outcome, e.g. SUCCESS or INSUFFICIENT_PAYER_BALANCE.
- `scheduled` (true/false): True when it ran from a schedule.
- `staking_reward_transfers` (list): Staking rewards paid out with this transaction.
- `succeeded` (true/false): True when it succeeded.
- `token_transfers` (list): Every movement of fungible tokens.
- `transaction_hash` (text): The transaction's hash, base64 encoded.
- `transaction_id` (text): The transaction's id, e.g. 0.0.10641751-1792481584-879725814 (wallets write it 0.0.10641751@1792481584.879725814).
- `type` (text): The kind of transaction, e.g. CRYPTOTRANSFER or TOKENMINT.
- `type_label` (text): The kind in words, e.g. 'Transfer' or 'Mint token'.

**Example output**

```json
{
  "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 (`account`, text, required): The account's id, e.g. 0.0.98, or its EVM address.
- Collection (`token`, text): Only NFTs of this collection. Leave empty for every NFT.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account read.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `nfts` (list): The NFTs.

**Example output**

```json
{
  "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 (`account`, text, required): The account's id, e.g. 0.0.98, or its EVM address.
- Only tokens held (`held_only`, true/false): Leave out tokens the account has associated but holds none of. Default: `true`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account read.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `tokens` (list): The tokens, in order of token id.

**Example output**

```json
{
  "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 (`account`, text, required): The account that granted them, e.g. 0.0.98.
- Allowances for (`allowance_type`, text): Which kind of allowance to list. Defaults to HBAR. One of: `hbar`, `tokens`, `nfts`. Default: `hbar`.
- Spender (`spender`, text): Only allowances to this account. Leave empty for every spender.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account read.
- `allowance_type` (text): Which allowances were listed: hbar, tokens or nfts.
- `allowances` (list): The allowances.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.

**Example output**

```json
{
  "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 (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `nodes` (list): The nodes, by node id.
- `total_stake_hbar` (number): The stake of the nodes listed, added up, in HBAR.

**Example output**

```json
{
  "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 (`token`, text, required): The NFT collection's token id, e.g. 0.0.1350444.
- Serial number (`serial_number`, number, required): The NFT's serial number within its collection, e.g. 1. At least 1.
- Order (`order`, text): Newest or oldest first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `serial_number` (number): The NFT's serial number.
- `token_id` (text): The token read.
- `transfers` (list): The NFT's transactions.

**Example output**

```json
{
  "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 (`token`, text, required): The NFT collection's token id, e.g. 0.0.1350444.
- Owner (`owner`, text): Only NFTs this account owns. Leave empty for every NFT.
- Order (`order`, text): Newest or oldest NFTs first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `nfts` (list): The NFTs.
- `token_id` (text): The token read.
- `token_name` (text): The collection's name.
- `token_symbol` (text): The collection's symbol.

**Example output**

```json
{
  "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 (`contract`, text, required): The contract's id, e.g. 0.0.3045981, or its EVM address (0x...).
- Caller (`caller`, text): Only calls from this account id or EVM address. Leave empty for every caller.
- From (`from_time`, date and time): Only include records from this moment on.
- Until (`until_time`, date and time): Only include records up to this moment.
- Order (`order`, text): Newest or oldest calls first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `calls` (list): The calls.
- `contract_id` (text): The contract read.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.

**Example output**

```json
{
  "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 (`account`, text, required): The account that was paid, e.g. 0.0.98.
- From (`from_time`, date and time): Only include records from this moment on.
- Until (`until_time`, date and time): Only include records up to this moment.
- Order (`order`, text): Newest or oldest payouts first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account read.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `rewards` (list): The payouts.
- `total_hbar` (number): The payouts listed, added up, in HBAR.

**Example output**

```json
{
  "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 (`token`, text, required): The token's id, e.g. 0.0.456858 for USDC.
- Holding at least (`min_balance`, number): Only accounts holding at least this many whole tokens, e.g. 1000. Leave empty for every holder. At least 0.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `as_of` (text): When the balances were read, ISO 8601 in UTC.
- `count` (number): How many records came back.
- `decimals` (number): The token's decimal places.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `holders` (list): The holders, newest accounts first.
- `name` (text): The token's name.
- `network` (text): The network that was read: mainnet or testnet.
- `symbol` (text): The token's symbol.
- `token_id` (text): The token read.

**Example output**

```json
{
  "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 (`topic`, text, required): The Consensus Service topic's id, e.g. 0.0.1368138. A HashScan link works too.
- After message number (`after_sequence_number`, number): Only messages after this one, e.g. the last number a previous run saw. At least 0.
- From (`from_time`, date and time): Only include records from this moment on.
- Until (`until_time`, date and time): Only include records up to this moment.
- Order (`order`, text): 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 (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `messages` (list): The messages.
- `network` (text): The network that was read: mainnet or testnet.
- `topic_id` (text): The topic read.

**Example output**

```json
{
  "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 (`account`, text): Only transactions this account took part in, e.g. 0.0.98, or its EVM address. Leave empty for the whole network.
- Kind (`transaction_type`, text): 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 (`result`, text): Only transactions that succeeded, or that failed. One of: `success` (Succeeded), `fail` (Failed).
- Direction (`direction`, text): 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_time`, date and time): Only include records from this moment on.
- Until (`until_time`, date and time): Only include records up to this moment.
- Order (`order`, text): Newest or oldest first. Defaults to newest. One of: `desc` (Newest first), `asc` (Oldest first). Default: `desc`.
- Number of results (`limit`, number): How many to return, 1 to 100. Defaults to 25. From 1 to 100.
- Network (`network`, text): Which Hedera network to read. Defaults to Mainnet. One of: `mainnet`, `testnet`. Default: `mainnet`.

**Outputs**

- `account_id` (text): The account the list was narrowed to, if any.
- `count` (number): How many records came back.
- `has_more` (true/false): True when the mirror node has more records past these. Narrow the time range, or raise the number of results, to see them.
- `network` (text): The network that was read: mainnet or testnet.
- `transactions` (list): The transactions.

**Example output**

```json
{
  "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)"
    }
  ]
}
```
