Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The tokens object represents the information associated with a token entity and returns a list of token information.
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The Mirror Node REST API offers the ability to query cryptocurrency transactions and account information from a Hedera mirror node.
Return the account transactions and balance information given an account alias, an account id, or an evm address.
Returns a list of all account entity items on the network.
Returns information for fungible token allowances for an account.
Returns information for all past staking reward payouts for an account.
Returns information for all token relationships for an account.
Returns a list of blocks on the network.
Returns information for all non-fungible tokens for an account.
List account balances
Returns the block information by given hash or number.
The contracts objects represents the information associated with contract entities.
Returns a list of contract entities on the network.
Return the contract information given an id
Returns a list of all ContractResults for a contract's function executions.
List contract logs from a contract on the network.
The Contract state from a contract on the network
Invoke a smart contract
Returns a single ContractResult for a contract's function executions at a specific timestamp.
List contract results from all contracts on the network
Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash
List contracts logs across many contracts on the network
Get the network fees
Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash
Returns the network's current stake information
Get the network address book nodes.
List schedules entities
List Tokens
Get the network supply
Returns schedule information based on the given schedule id
List token balances
Get Token By ID
List NFTs.
Get NFT information
Get an NFT's transaction history
The transaction object represents the transactions processed on the Hedera network.
Get a topic message by consensusTimestamp
Get a topic's message information by ID and sequence number
List transactions
Get Transaction information by ID
The balance object represents the balance of accounts on the Hedera network.
Get the network exchange rate to estimate costs
Get stateproof information
List topic messages by ID
Returns information for all crypto allowances for an account.
Returns information for all past staking reward payouts for an account.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.
OK
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
A Unix timestamp in seconds.nanoseconds format
Returns information for all non-fungible tokens for an account.
When considering NFTs, their order is governed by a combination of their numerical token.Id and serialnumber values, with token.id being the parent column. A serialnumbers value governs its order within the given token.id
In that regard, if a user acquired a set of NFTs in the order (2-2, 2-4 1-5, 1-1, 1-3, 3-3, 3-4), the following layouts illustrate the ordering expectations for ownership listing
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the NFT ownership endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
token.id | eq | Y | Single occurrence only. | ?token.id=X |
ne | N | |||
lt(e) | Y | Single occurrence only. | ?token.id=lte:X | |
gt(e) | Y | Single occurrence only. | ?token.id=gte:X | |
serialnumber | eq | Y | Single occurrence only. Requires the presence of a token.id query | ?serialnumber=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of an lte or eq token.id query | ?token.id=lte:X&serialnumber=lt:Y | |
gt(e) | Y | Single occurrence only. Requires the presence of an gte or eq token.id query | ?token.id=gte:X&serialnumber=gt:Y | |
spender.id | eq | Y | ?spender.id=Z | |
ne | N | |||
lt(e) | Y | ?spender.id=lt:Z | ||
gt(e) | Y | ?spender.id=gt:Z |
Note: When searching across a range for individual NFTs a serialnumber with an additional token.id query filter must be provided. Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The nft serial number (64 bit type). Requires a tokenId value also be populated.
The ID of the spender to return information for
The ID of the token to return information for
OK
Network entity ID in the format of shard.realm.num
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
whether the nft or the token it belongs to has been deleted
Arbitrary binary data associated with this NFT encoded in base64.
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of all account entity items on the network.
The optional balance value to compare against
The ID of the account to return information for
The account's public key to compare against
Whether to include balance information or not. If included, token balances are limited to at most 50 per account as outlined in HIP-367.
The maximum number of items to return
The order in which items are listed
OK
Network entity ID in the format of shard.realm.num
RFC4648 no-padding base32 encoded account alias
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
A Unix timestamp in seconds.nanoseconds format
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
A Unix timestamp in seconds.nanoseconds format
The pending reward in tinybars the account will receive in the next reward payout. Note the value is updated at the end of each staking period and there may be delay to reflect the changes in the past staking period.
Network entity ID in the format of shard.realm.num
The account to which this account is staking
The id of the node to which this account is staking
A Unix timestamp in seconds.nanoseconds format
The staking period during which either the staking settings for this account changed (such as starting staking or changing stakedNode) or the most recent reward was earned, whichever is later. If this account is not currently staked to a node, then the value is null
Return the account transactions and balance information given an account alias, an account id, or an evm address. The information will be limited to at most 1000 token balances for the account as outlined in HIP-367. When the timestamp parameter is supplied, we will return transactions and account state for the relevant timestamp query. Balance information will be accurate to within 15 minutes of the provided timestamp query. Historical ethereum nonce information is currently not available and may not be the exact value at a provided timestamp.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.
If provided and set to false transactions will not be included in the response
OK
Network entity ID in the format of shard.realm.num
RFC4648 no-padding base32 encoded account alias
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
A Unix timestamp in seconds.nanoseconds format
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
A Unix timestamp in seconds.nanoseconds format
The pending reward in tinybars the account will receive in the next reward payout. Note the value is updated at the end of each staking period and there may be delay to reflect the changes in the past staking period.
Network entity ID in the format of shard.realm.num
The account to which this account is staking
The id of the node to which this account is staking
A Unix timestamp in seconds.nanoseconds format
The staking period during which either the staking settings for this account changed (such as starting staking or changing stakedNode) or the most recent reward was earned, whichever is later. If this account is not currently staked to a node, then the value is null
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A Unix timestamp in seconds.nanoseconds format
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A Unix timestamp in seconds.nanoseconds format
Search the logs across many contracts with multiple contract calls. Chained logs are not
included but can be found by calling /api/v1/contracts/{contractId}/results/{timestamp}
or /api/v1/contracts/results/{transactionId}
. When searching by topic a timestamp parameter must be supplied
and span a time range of at most seven days.
The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
index | eq | Y | Single occurrence only. Requires the presence of timestamp | ?index=X |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=lte:X | |
gt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=gte:X | |
timestamp | eq | Y | Single occurrence only. | ?timestamp=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Optional second timestamp gt(e) | ?timestamp=lte:Y | |
gt(e) | Y | Single occurrence only. Optional second timestamp lt(e) | ?timestamp=gte:Y |
Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Contract log index
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The first topic associated with a contract log. Requires a timestamp range also be populated.
The second topic associated with a contract log. Requires a timestamp range also be populated.
The third topic associated with a contract log. Requires a timestamp range also be populated.
The fourth topic associated with a contract log. Requires a timestamp range also be populated.
OK
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
Network entity ID in the format of shard.realm.num
The executed contract that created this contract log
A hex encoded transaction hash
The position of the transaction in the block
Returns a list of non-fungible tokens
Network entity ID in the format of shard.realm.num
The ID of the account to return information for
The maximum number of items to return
The order in which items are listed
The nft serial number (64 bit type). Requires a tokenId value also be populated.
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of all ContractResults for all contract's function executions.
Account ID or EVM address executing the contract
The block's hash
The block's number
Whether to include child transactions or not
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Search the logs across many contracts with multiple contract calls. Chained logs are not
included but can be found by calling /api/v1/contracts/{contractId}/results/{timestamp}
or /api/v1/contracts/results/{transactionId}
. When searching by topic a timestamp parameter must be supplied
and span a time range of at most seven days.
The order is governed by the combination of timestamp and index values. If the index param is omitted, the order is determined by the timestamp only.
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
index | eq | Y | Single occurrence only. Requires the presence of timestamp | ?index=X |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=lte:X | |
gt(e) | Y | Single occurrence only. Requires the presence of timestamp | ?index=gte:X | |
timestamp | eq | Y | Single occurrence only. | ?timestamp=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Optional second timestamp gt(e) | ?timestamp=lte:Y | |
gt(e) | Y | Single occurrence only. Optional second timestamp lt(e) | ?timestamp=gte:Y |
Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Contract log index
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The first topic associated with a contract log. Requires a timestamp range also be populated.
The second topic associated with a contract log. Requires a timestamp range also be populated.
The third topic associated with a contract log. Requires a timestamp range also be populated.
The fourth topic associated with a contract log. Requires a timestamp range also be populated.
OK
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
Network entity ID in the format of shard.realm.num
The executed contract that created this contract log
A hex encoded transaction hash
The position of the transaction in the block
Returns a list of token balances given the id. This represents the Token supply distribution across the network
Network entity ID in the format of shard.realm.num
The optional balance value to compare against
The ID of the account to return information for
The account's public key to compare against
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Returns information for a non-fungible token
Network entity ID in the format of shard.realm.num
The nft serial number
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns the list of topic messages for the given topic id.
Network entity ID in the format of shard.realm.num
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of tokens on the network.
The ID of the account to return information for
The maximum number of items to return
The order in which items are listed
The public key to compare against
The ID of the token to return information for
OK
Network entity ID in the format of shard.realm.num
Returns the network's released supply of hbars
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
The network's released supply of hbars in tinybars
The consensus timestamp at which the released supply was valid
The network's total supply of hbars in tinybars
Returns a single topic message the given topic id and sequence number.
Network entity ID in the format of shard.realm.num
Topic message sequence number
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a topic message the given the consensusTimestamp.
The timestamp at which the associated transaction reached consensus
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns information for all non-fungible tokens for an account.
When considering NFTs, their order is governed by a combination of their numerical token.Id and serialnumber values, with token.id being the parent column. A serialnumbers value governs its order within the given token.id
In that regard, if a user acquired a set of NFTs in the order (2-2, 2-4 1-5, 1-1, 1-3, 3-3, 3-4), the following layouts illustrate the ordering expectations for ownership listing
Note: The default order for this API is currently DESC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the NFT ownership endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
token.id | eq | Y | Single occurrence only. | ?token.id=X |
ne | N | |||
lt(e) | Y | Single occurrence only. | ?token.id=lte:X | |
gt(e) | Y | Single occurrence only. | ?token.id=gte:X | |
serialnumber | eq | Y | Single occurrence only. Requires the presence of a token.id query | ?serialnumber=Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of an lte or eq token.id query | ?token.id=lte:X&serialnumber=lt:Y | |
gt(e) | Y | Single occurrence only. Requires the presence of an gte or eq token.id query | ?token.id=gte:X&serialnumber=gt:Y | |
spender.id | eq | Y | ?spender.id=Z | |
ne | N | |||
lt(e) | Y | ?spender.id=lt:Z | ||
gt(e) | Y | ?spender.id=gt:Z |
Note: When searching across a range for individual NFTs a serialnumber with an additional token.id query filter must be provided. Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The nft serial number (64 bit type). Requires a tokenId value also be populated.
The ID of the spender to return information for
The ID of the token to return information for
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns the block information by given hash or number.
Accepts both eth and hedera hash format or block number
OK
A hex encoded 256-byte array with 0x prefix
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Returns information for all past staking reward payouts for an account.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
Lists schedules on the network that govern the execution logic of scheduled transactions. This includes executed and non executed schedules.
The ID of the account to return information for
The maximum number of items to return
The order in which items are listed
The ID of the schedule to return information for
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns information for all crypto allowances for an account.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The ID of the spender to return information for
OK
The granted amount of the spender's allowance.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
The granted amount of the spender's allowance in tinybars.
Returns information for fungible token allowances for an account.
The order is governed by a combination of the spender id and the token id values, with spender id being the parent column. The token id value governs its order within the given spender id.
Note: The default order for this API is currently ASC
When filtering there are some restrictions enforced to ensure correctness and scalability.
The table below defines the restrictions and support for the endpoint
Query Param | Comparison Operator | Support | Description | Example |
---|---|---|---|---|
spender.id | eq | Y | Single occurrence only. | ?spender.id=X |
ne | N | |||
lt(e) | Y | Single occurrence only. | ?spender.id=lte:X | |
gt(e) | Y | Single occurrence only. | ?spender.id=gte:X | |
token.id | eq | Y | Single occurrence only. Requires the presence of a spender.id query | ?token.id=lt:Y |
ne | N | |||
lt(e) | Y | Single occurrence only. Requires the presence of an lte or eq spender.id query | ?spender.id=lte:X&token.id=lt:Y | |
gt(e) | Y | Single occurrence only. Requires the presence of an gte or eq spender.id query | ?spender.id=gte:X&token.id=gt:Y |
Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The ID of the spender to return information for
The ID of the token to return information for
OK
The granted amount of the spender's allowance.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Network entity ID in the format of shard.realm.num
Returns a list of all contract's slots. If no timestamp is provided, returns the current state.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The maximum number of items to return
The order in which items are listed
The slot's number
The timestamp at which the contract state is
OK
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot.
The hex encoded value to the slot. 0x
implies no value written.
Returns schedule information based on the given schedule id
Network entity ID in the format of shard.realm.num
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of blocks on the network.
The block's number
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
A hex encoded 256-byte array with 0x prefix
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Returns the estimated gas in tinybars per each transaction type. Default order is ASC. Currently only ContractCall
, ContractCreate
and EthereumTransaction
transaction types are supported.
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
gas cost in tinybars
type of the transaction
Returns the network's current stake information.
OK
The maximum reward rate, in tinybars per whole hbar, that any account can receive in a day
The fraction between zero and one of the network and service fees paid to the node reward account 0.0.801
The total amount staked to the network in tinybars the start of the current staking period
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
The timestamp range of the staking period
The number of minutes in a staking period
The number of staking periods for which the reward is stored for each node
The fraction between zero and one of the network and service fees paid to the staking reward account 0.0.800
The total number of tinybars to be distributed as staking rewards each period
The minimum balance of staking reward account 0.0.800 required to active rewards
Returns a timestamped list of account balances on the network, limited to at most 50 token balances per account as outlined in HIP-367. This includes both HBAR and token balances for accounts.
Account id or account alias with no shard realm or evm address with no shard realm
The optional balance value to compare against
The account's public key to compare against
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Return the contract information given an id
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
The contract bytecode in hex during deployment
The contract bytecode in hex after deployment
Returns the network's exchange rate, current and next.
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Returns a list of transactions for a given non-fungible token
Network entity ID in the format of shard.realm.num
The nft serial number
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of all contract entity items on the network.
The ID of the smart contract
The maximum number of items to return
The order in which items are listed
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Returns information for all token relationships for an account.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The ID of the token to return information for
OK
Specifies if the relationship is implicitly/explicitly associated.
For FUNGIBLE_COMMON, the balance that the account holds in the smallest denomination. For NON_FUNGIBLE_UNIQUE, the number of NFTs held by the account.
The Freeze status of the account.
The KYC status of the account.
Network entity ID in the format of shard.realm.num
Returns the contents of the address book file, signature files, and record file that can be used to validate the transaction occurred on the Hedera network given transaction id.
Transaction id
Filter the query result by the nonce of the transaction. A zero nonce represents user submitted transactions while a non-zero nonce is generated by main nodes. The filter honors the last value. Default is 0 when not specified.
Filter transactions by the scheduled flag. If true, return information for the scheduled transaction. If false, return information for the non-scheduled transaction.
OK
The network address book valid at the time of the transaction
The record file the transaction belongs to, in compact format
The record file head
The start running hash object
THe end running hash object
The hashes of the transactions before the transaction in query, in consensus timestamp ascending order
The hashes of the transactions after the transaction in query, in consensus timestamp ascending order
The record stream object of the transaction in query
The block number, in base64 encoding. Only present if version is 6
The nodes' signature files for the record file
The record file format version, either 5 or 6
Returns a result from EVM execution such as cost-free execution of read-only smart contract queries, gas estimation, and transient simulation of read-write operations. If estimate
field is set to true gas estimation is executed. Currently we support only latest
block.
The table below defines the restrictions and support for the endpoint
Estimate | Operation Type | Mirror Node Version |
---|---|---|
false | static contract state reads for non precompile functions | 0.78+ |
static contract state reads for precompile functions except allowance/isApprovedForAll | 0.78+ | |
static contract state reads for precompile functions with allowance | 0.79+ | |
static contract state reads for precompile functions with isApprovedForAll | 0.81+ | |
non-static contract state reads for non precompile functions | 0.83+ | |
non-static contract state reads for precompile read only functions | 0.83+ | |
true | non-static contract state reads and modifications for non precompile functions except lazy account creation | 0.83+ |
non-static contract state reads and modifications for associate precompile functions | 0.83+ | |
non-static contract state reads and modifications for non precompile functions with lazy account creation | 0.84+ | |
non-static contract state reads and modifications for precompile functions except associate | Not supported |
The operations types which are not currently supported should return 501 error status.
Hexadecimal block number or the string "latest", "pending", "earliest". Defaults to "latest".
Hexadecimal method signature and encoded parameters.
Whether gas estimation is called. Defaults to false.
The 20-byte hexadecimal EVM address the transaction is sent from.
Gas provided for the transaction execution. Defaults to 120000000.
Gas price used for each paid gas.
The 20-byte hexadecimal EVM address the transaction is directed to.
Value sent with this transaction. Defaults to 0.
OK
Result in hexadecimal from executed contract call.
Returns a single ContractResult for a contract's function executions for a given transactionId or ethereum transaction hash.
Transaction Id or a 32 byte hash with optional 0x prefix
Filter the query result by the nonce of the transaction. A zero nonce represents user submitted transactions while a non-zero nonce is generated by main nodes. The filter honors the last value. Default is 0 when not specified.
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded chain_id of the wrapped ethereum transaction
The hex encoded initcode of a failed contract create transaction
The hex encoded gas_price of the wrapped ethereum transaction
The hex encoded transaction hash
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The hex encoded signature_s of the wrapped ethereum transaction
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot changed.
The hex encoded value read from the storage slot.
The hex encoded value written to the slot. null
implies no value written.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Returns a list of ContractActions for a contract's function executions for a given transactionId or ethereum transaction hash.
Transaction Id or a 32 byte hash with optional 0x prefix
The index of a contract action
The maximum number of items to return
The order in which items are listed
OK
The nesting depth of the call
The type of the call operation
The type of the call
Network entity ID in the format of shard.realm.num
The entity type of the caller
The EVM address of the caller
Gas cost in tinybars
Gas used in tinybars
The position of the action within the ordered list of actions
The hex encoded input data
Network entity ID in the format of shard.realm.num
The entity type of the recipient
The hex encoded result data
The type of the result data
A network entity encoded as an EVM address in hex.
The value of the transaction in tinybars
Return the account transactions and balance information given an account alias, an account id, or an evm address. The information will be limited to at most 1000 token balances for the account as outlined in HIP-367. When the timestamp parameter is supplied, we will return transactions and account state for the relevant timestamp query. Balance information will be accurate to within 15 minutes of the provided timestamp query. Historical stake and reward information is not currently available so these fields contain current data. Historical ethereum nonce information is also currently not available and may not be the exact value at a provided timestamp.
Account alias or account id or evm address
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
If provided and set to false transactions will not be included in the response
OK
Network entity ID in the format of shard.realm.num
RFC4648 no-padding base32 encoded account alias
Network entity ID in the format of shard.realm.num
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
The pending reward in tinybars the account will receive in the next reward payout. Note the value is updated at the end of each staking period and there may be delay to reflect the changes in the past staking period.
Network entity ID in the format of shard.realm.num
The account to which this account is staking
The id of the node to which this account is staking
The staking period during which either the staking settings for this account changed (such as starting staking or changing stakedNode) or the most recent reward was earned, whichever is later. If this account is not currently staked to a node, then the value is null
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns a list of all account entity items on the network.
The optional balance value to compare against
The ID of the account to return information for
The account's public key to compare against
Whether to include balance information or not. If included, token balances are limited to at most 50 per account as outlined in HIP-367.
The maximum number of items to return
The order in which items are listed
OK
Network entity ID in the format of shard.realm.num
RFC4648 no-padding base32 encoded account alias
Network entity ID in the format of shard.realm.num
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
The pending reward in tinybars the account will receive in the next reward payout. Note the value is updated at the end of each staking period and there may be delay to reflect the changes in the past staking period.
Network entity ID in the format of shard.realm.num
The account to which this account is staking
The id of the node to which this account is staking
The staking period during which either the staking settings for this account changed (such as starting staking or changing stakedNode) or the most recent reward was earned, whichever is later. If this account is not currently staked to a node, then the value is null
Lists transactions on the network. This includes successful and unsuccessful transactions.
The ID of the account to return information for
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction success type.
The transaction account balance modification type.
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns the network's list of nodes used in consensus
The ID of the file entity
The maximum number of items to return
The ID of the node
The order in which items are listed
OK
a memo associated with the address book
Network entity ID in the format of shard.realm.num
The maximum stake (rewarded or not rewarded) this node can have as consensus weight
memo
The minimum stake (rewarded or not rewarded) this node must reach before having non-zero consensus weight
Network entity ID in the format of shard.realm.num
An identifier for the node
hex encoded hash of the node's TLS certificate
hex encoded X509 RSA public key used to verify stream file signature
The total tinybars earned by this node per whole hbar in the last staking period
The node consensus weight at the beginning of the staking period
The sum (balance + stakedToMe) for all accounts staked to this node with declineReward=true at the beginning of the staking period
The sum (balance + staked) for all accounts staked to the node that are not declining rewards at the beginning of the staking period
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
The timestamp range of the staking period
A timestamp range an entity is valid for
The inclusive from timestamp in seconds
The exclusive to timestamp in seconds
Returns a list of all ContractResults for a contract's function executions.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The block's hash
The block's number
Account ID or EVM address executing the contract
Whether to include child transactions or not
The maximum number of items to return
The order in which items are listed
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Returns a single ContractResult for a contract's function executions at a specific timestamp.
The ID or hex encoded EVM address (with or without 0x prefix) associated with this contract.
The timestamp at which the associated transaction reached consensus
OK
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The number of tinybars sent to the function
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
The hex encoded chain_id of the wrapped ethereum transaction
Network entity ID in the format of shard.realm.num
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
The message when an error occurs during smart contract execution
The hex encoded initcode of a failed contract create transaction
A network entity encoded as an EVM address in hex.
The hex encoded parameters passed to the function
The maximum units of gas allowed for contract execution
The hex encoded gas_price of the wrapped ethereum transaction
The units of gas used to execute contract
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The result of the transaction
The hex encoded signature_s of the wrapped ethereum transaction
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
A network entity encoded as an EVM address in hex.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
The hex encoded access_list of the wrapped ethereum transaction
The hex encoded evm address of contract
The total amount of gas used in the block
The hex encoded block (record file chain) hash
The block height calculated as the number of record files starting from zero since network start.
The hex encoded chain_id of the wrapped ethereum transaction
The hex encoded initcode of a failed contract create transaction
The hex encoded gas_price of the wrapped ethereum transaction
The hex encoded transaction hash
The hex encoded EVM address of the contract
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
The hex encoded data of the contract log
The index of the contract log in the chain of logs for an execution
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
The nonce of the wrapped ethereum transaction
The hex encoded signature_r of the wrapped ethereum transaction
The hex encoded signature_s of the wrapped ethereum transaction
A network entity encoded as an EVM address in hex.
Network entity ID in the format of shard.realm.num
The hex encoded storage slot changed.
The hex encoded value read from the storage slot.
The hex encoded value written to the slot. null
implies no value written.
The position of the transaction in the block
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
The recovery_id of the wrapped ethereum transaction
Returns transaction information based on the given transaction id
Transaction id
Filter the query result by the nonce of the transaction. A zero nonce represents user submitted transactions while a non-zero nonce is generated by main nodes. The filter honors the last value. If not specified, all transactions with specified payer account ID and valid start timestamp match.
Filter transactions by the scheduled flag. If true, return information for the scheduled transaction. If false, return information for the non-scheduled transaction. If not present, return information for all transactions matching transactionId.
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
The number of tinybars awarded
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Returns token entity information given the id
Network entity ID in the format of shard.realm.num
OK
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num
Network entity ID in the format of shard.realm.num