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.
This method will use 15
Compute Units.
Returns information for fungible token allowances for an account.
This method will use 15
Compute Units.
Returns information for all past staking reward payouts for an account.
This method will use 15
Compute Units.
Returns information for all token relationships for an account.
This method will use 15
Compute Units.
Returns a single ContractResult for a contract's function executions at a specific timestamp.
This method will use 15
Compute Units.
Returns a list of all ContractResults for a contract's function executions.
This method will use 15
Compute Units.
Get the contract actions from a contract on the network for a given transactionId or ethereum transaction hash.
This method will use 15
.
Get a topic message by consensusTimestamp.
This method will use 15
.
The balance object represents the balance of accounts on the Hedera network.
Returns information for all non-fungible tokens for an account.
This method will use 15
Compute Units.
The contracts objects represents the information associated with contract entities.
Get the contract result from a contract on the network for a given transactionId or ethereum transaction hash.
This method will use 15
Compute Units.
The transaction object represents the transactions processed on the Hedera network.
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
2
The order in which items are listed
"asc"
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
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded data of the contract log
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The index of the contract log in the chain of logs for an execution
0
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
"0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073"
The block height calculated as the number of record files starting from zero since network start.
10
Network entity ID in the format of shard.realm.num
"0.1.2"
The executed contract that created this contract log
"1586567700.453054000"
A hex encoded transaction hash
"0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9"
The position of the transaction in the block
1
Returns a list of non-fungible tokens
Network entity ID in the format of shard.realm.num
"0.1.2"
The ID of the account to return information for
The maximum number of items to return
2
The order in which items are listed
"asc"
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
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
"1586567700.453054000"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
true
The maximum number of items to return
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
1
OK
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The number of tinybars sent to the function
10
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
"0x2b048531b38d2882e86044bc972e940ee0a01938"
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
Network entity ID in the format of shard.realm.num
"0.1.2"
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
"0.1.2"
The message when an error occurs during smart contract execution
"Out of gas"
The hex encoded initcode of a failed contract create transaction
"0x856739"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
The hex encoded parameters passed to the function
"0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"
The maximum units of gas allowed for contract execution
100000
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The units of gas used to execute contract
1000
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
"0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The result of the transaction
"SUCCESS"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
1
"1586567700.453054000"
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
2
The order in which items are listed
"asc"
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
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded data of the contract log
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The index of the contract log in the chain of logs for an execution
0
A list of hex encoded topics associated with this log event
The hex encoded block (record file chain) hash
"0x553f9311833391c0a3b2f9ed64540a89f2190a511986cd94889f1c0cf7fa63e898b1c6730f14a61755d1fb4ca05fb073"
The block height calculated as the number of record files starting from zero since network start.
10
Network entity ID in the format of shard.realm.num
"0.1.2"
The executed contract that created this contract log
"1586567700.453054000"
A hex encoded transaction hash
"0x397022d1e5baeb89d0ab66e6bf602640610e6fb7e55d78638db861e2c6339aa9"
The position of the transaction in the block
1
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
"0.1.2"
The optional balance value to compare against
The ID of the account to return information for
The account's public key to compare against
"3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be"
The maximum number of items to return
2
The order in which items are listed
"desc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns a list of tokens on the network.
The ID of the account to return information for
The maximum number of items to return
2
The order in which items are listed
"desc"
The public key to compare against
"3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be"
The ID of the token to return information for
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
"ProtobufEncoded"
10101
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns the list of topic messages for the given topic id.
Network entity ID in the format of shard.realm.num
"0.1.2"
"base64"
The maximum number of items to return
2
The order in which items are listed
"asc"
2
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
0
false
"1586567700.453054000"
1
2
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns information for a non-fungible token
Network entity ID in the format of shard.realm.num
"0.1.2"
The nft serial number
1
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
"1586567700.453054000"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Returns a single topic message the given topic id and sequence number.
Network entity ID in the format of shard.realm.num
"0.1.2"
Topic message sequence number
2
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
0
false
"1586567700.453054000"
1
2
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"3999999999999999949"
"1586567700.453054000"
The consensus timestamp at which the released supply was valid
The network's total supply of hbars in tinybars
"5000000000000000000"
Returns a topic message the given the consensusTimestamp.
The timestamp at which the associated transaction reached consensus
1234567890.0000007
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
0
false
"1586567700.453054000"
1
2
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
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
2
The order in which items are listed
"asc"
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
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
whether the nft or the token it belongs to has been deleted
base64 encoded binary data
"1586567700.453054000"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
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
2
The order in which items are listed
"desc"
The ID of the schedule to return information for
OK
"ProtobufEncoded"
10101
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
false
"1586567700.453054000"
"1586567700.453054000"
"created on 02/10/2021"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
"AAEBAwuqAwzB"
"3q2+7wABAQMLqgMMwQ=="
"ED25519"
"Kd6tvu8="
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
2
The order in which items are listed
"desc"
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.
100
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns information for all crypto allowances for an account.
Account alias or account id or evm address
The maximum number of items to return
2
The order in which items are listed
"asc"
The ID of the spender to return information for
OK
The granted amount of the spender's allowance.
100
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
The granted amount of the spender's allowance in tinybars.
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
2
The order in which items are listed
"desc"
The slot's number
The timestamp at which the contract state is
1234567890.0000007
OK
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
The hex encoded storage slot.
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The hex encoded value to the slot. 0x
implies no value written.
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
The number of tinybars awarded
10
"1586567700.453054000"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns schedule information based on the given schedule id
Network entity ID in the format of shard.realm.num
"0.1.2"
OK
"ProtobufEncoded"
10101
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
false
"1586567700.453054000"
"1586567700.453054000"
"created on 02/10/2021"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
"AAEBAwuqAwzB"
"3q2+7wABAQMLqgMMwQ=="
"ED25519"
"Kd6tvu8="
Returns a list of blocks on the network.
The block's number
The maximum number of items to return
2
The order in which items are listed
"asc"
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
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns the network's exchange rate, current and next.
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
596987
1649689200
30000
596987
1649689200
30000
"1586567700.453054000"
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
"3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be"
The maximum number of items to return
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
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 list of all contract entity items on the network.
The ID of the smart contract
The maximum number of items to return
2
The order in which items are listed
"asc"
OK
"ProtobufEncoded"
10101
Network entity ID in the format of shard.realm.num
"0.1.2"
7776000
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
false
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"contract memo"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"desc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
gas cost in tinybars
type of the transaction
"1586567700.453054000"
Returns information for all token relationships for an account.
Account alias or account id or evm address
The maximum number of items to return
2
The order in which items are listed
"desc"
The ID of the token to return information for
OK
Specifies if the relationship is implicitly/explicitly associated.
true
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.
5
"1586567700.453054000"
The Freeze status of the account.
"UNFROZEN"
The KYC status of the account.
"GRANTED"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"ProtobufEncoded"
10101
Network entity ID in the format of shard.realm.num
"0.1.2"
7776000
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
false
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"contract memo"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
The contract bytecode in hex during deployment
"0x01021a1fdc9b"
The contract bytecode in hex after deployment
"0x0302fa1ad39c"
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
"0.0.10-1234567890-000000000"
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.
1
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".
"latest"
Hexadecimal method signature and encoded parameters.
"0x0198489200000000000000000000000000000000000000000000000000000000000003ee"
Whether gas estimation is called. Defaults to false.
true
The 20-byte hexadecimal EVM address the transaction is sent from.
"00000000000000000000000000000000000004e2"
Gas provided for the transaction execution. Defaults to 120000000.
120000000
Gas price used for each paid gas.
100000000
The 20-byte hexadecimal EVM address the transaction is directed to.
"0x00000000000000000000000000000000000003f4"
Value sent with this transaction. Defaults to 0.
0
OK
Result in hexadecimal from executed contract call.
"0x94c4d54535f6e616d6500"
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.
1
OK
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The number of tinybars sent to the function
10
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
"0x2b048531b38d2882e86044bc972e940ee0a01938"
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
Network entity ID in the format of shard.realm.num
"0.1.2"
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
"0.1.2"
The message when an error occurs during smart contract execution
"Out of gas"
The hex encoded initcode of a failed contract create transaction
"0x856739"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
The hex encoded parameters passed to the function
"0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"
The maximum units of gas allowed for contract execution
100000
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The units of gas used to execute contract
1000
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
"0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The result of the transaction
"SUCCESS"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
1
"1586567700.453054000"
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
The hex encoded initcode of a failed contract create transaction
"0x856739"
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The hex encoded transaction hash
"0x3531396130303866616264653464"
The hex encoded EVM address of the contract
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded data of the contract log
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The index of the contract log in the chain of logs for an execution
0
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded storage slot changed.
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The hex encoded value read from the storage slot.
"0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750"
The hex encoded value written to the slot. null
implies no value written.
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
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
2
The order in which items are listed
"desc"
OK
The nesting depth of the call
1
The type of the call operation
"CALL"
The type of the call
"CALL"
Network entity ID in the format of shard.realm.num
"0.1.2"
The entity type of the caller
"ACCOUNT"
The EVM address of the caller
"0x0000000000000000000000000000000000000065"
Gas cost in tinybars
50000
Gas used in tinybars
50000
The position of the action within the ordered list of actions
0
The hex encoded input data
"0x123456"
Network entity ID in the format of shard.realm.num
"0.1.2"
The entity type of the recipient
"ACCOUNT"
The hex encoded result data
"0x123456"
The type of the result data
"OUTPUT"
"1586567700.453054000"
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
The value of the transaction in tinybars
50000
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
"cryptotransfer"
The transaction success type.
The transaction account balance modification type.
OK
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
The number of tinybars awarded
10
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns the network's list of nodes used in consensus
The ID of the file entity
The maximum number of items to return
2
The ID of the node
The order in which items are listed
"desc"
OK
a memo associated with the address book
Network entity ID in the format of shard.realm.num
"0.1.2"
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
"0.1.2"
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
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
The timestamp range of the staking period
A timestamp range an entity is valid for
"1586567700.453054000"
The inclusive from timestamp in seconds
"1586567700.453054000"
The exclusive to timestamp in seconds
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
true
The maximum number of items to return
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
The transaction index in the block
1
OK
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The number of tinybars sent to the function
10
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
"0x2b048531b38d2882e86044bc972e940ee0a01938"
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
Network entity ID in the format of shard.realm.num
"0.1.2"
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
"0.1.2"
The message when an error occurs during smart contract execution
"Out of gas"
The hex encoded initcode of a failed contract create transaction
"0x856739"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
The hex encoded parameters passed to the function
"0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"
The maximum units of gas allowed for contract execution
100000
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The units of gas used to execute contract
1000
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
"0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The result of the transaction
"SUCCESS"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
1
"1586567700.453054000"
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
1234567890.0000007
OK
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The number of tinybars sent to the function
10
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract result
The hex encoded result returned by the function
"0x2b048531b38d2882e86044bc972e940ee0a01938"
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
Network entity ID in the format of shard.realm.num
"0.1.2"
The list of smart contracts that were created by the function call.
Network entity ID in the format of shard.realm.num
"0.1.2"
The message when an error occurs during smart contract execution
"Out of gas"
The hex encoded initcode of a failed contract create transaction
"0x856739"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
The hex encoded parameters passed to the function
"0xbb9f02dc6f0e3289f57a1f33b71c73aa8548ab8b"
The maximum units of gas allowed for contract execution
100000
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The units of gas used to execute contract
1000
A hex encoded 32 byte hash and it is only populated for Ethereum transaction case
"0xfebbaa29c513d124a6377246ea3506ad917d740c21a88f61a1c55ba338fc2bb1"
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The result of the transaction
"SUCCESS"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
The status of the transaction, 0x1 for a SUCCESS transaction and 0x0 for all else
1
"1586567700.453054000"
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
The hex encoded access_list of the wrapped ethereum transaction
"0xabcd"
The hex encoded evm address of contract
"0x25fe26adc577cc89172e6156c9e24f7b9751b762"
The total amount of gas used in the block
2000
The hex encoded block (record file chain) hash
"0x6ceecd8bb224da491"
The block height calculated as the number of record files starting from zero since network start.
10
The hex encoded chain_id of the wrapped ethereum transaction
"0x0127"
The hex encoded initcode of a failed contract create transaction
"0x856739"
The hex encoded gas_price of the wrapped ethereum transaction
"0x4a817c800"
The hex encoded transaction hash
"0x3531396130303866616264653464"
The hex encoded EVM address of the contract
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
"0x549358c4c2e573e02410ef7b5a5ffa5f36dd7398"
The hex encoded bloom filter of the contract log
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded data of the contract log
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The index of the contract log in the chain of logs for an execution
0
A list of hex encoded topics associated with this log event
The hex encoded max_fee_per_gas of the wrapped ethereum transaction
"0x5"
The hex encoded max_priority_fee_per_gas of the wrapped ethereum transaction
"0x100"
The nonce of the wrapped ethereum transaction
1
The hex encoded signature_r of the wrapped ethereum transaction
"0xd693b532a80fed6392b428604171fb32fdbf953728a3a7ecc7d4062b1652c043"
The hex encoded signature_s of the wrapped ethereum transaction
"0x24e9c602ac800b983b035700a14b23f78a253ab762deab5dc27e3555a750b355"
A network entity encoded as an EVM address in hex.
"0000000000000000000000000000000000001f41"
Network entity ID in the format of shard.realm.num
"0.1.2"
The hex encoded storage slot changed.
"0x00000000000000000000000000000000000000000000000000000000000000fa"
The hex encoded value read from the storage slot.
"0x97c1fc0a6ed5551bc831571325e9bdb365d06803100dc20648640ba24ce69750"
The hex encoded value written to the slot. null
implies no value written.
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925"
The position of the transaction in the block
1
The type of the wrapped ethereum transaction, 0 (Pre-Eip1559) or 2 (Post-Eip1559)
2
The recovery_id of the wrapped ethereum transaction
1
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
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
"cryptotransfer"
If provided and set to false transactions will not be included in the response
true
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
RFC4648 no-padding base32 encoded account alias
"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
"1586567700.453054000"
"ProtobufEncoded"
10101
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
"0.1.2"
The account to which this account is staking
The id of the node to which this account is staking
"1586567700.453054000"
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
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
The number of tinybars awarded
10
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
Returns transaction information based on the given transaction id
Transaction id
"0.0.10-1234567890-000000000"
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.
0
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
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
1
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
The number of tinybars awarded
10
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
Returns token entity information given the id
Network entity ID in the format of shard.realm.num
"0.1.2"
OK
"ProtobufEncoded"
10101
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
1000
true
1234567890100000
"ProtobufEncoded"
10101
false
"ProtobufEncoded"
10101
"1000000"
"ProtobufEncoded"
10101
"9223372036854775807"
"1586567700.453054000"
"Token name"
"token memo"
"ProtobufEncoded"
10101
"UNPAUSED"
"ProtobufEncoded"
10101
"INFINITE"
"ORIGINALRDKSE"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1000000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"FUNGIBLE_COMMON"
"ProtobufEncoded"
10101
"1586567700.453054000"
false
100
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
false
12
29
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
120
30
true
false
15
37
Network entity ID in the format of shard.realm.num
"0.1.2"
100
Network entity ID in the format of shard.realm.num
"0.1.2"
Get an NFT's transaction history.
This method will use 15
.
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
2
The order in which items are listed
"asc"
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
"0.0.2"
The number of tinybars awarded
10
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
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
2
The order in which items are listed
"asc"
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
"0.0.2"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.0.2"
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
"1586567700.453054000"
1
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
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
"3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be"
Whether to include balance information or not. If included, token balances are limited to at most 50 per account as outlined in HIP-367.
true
The maximum number of items to return
2
The order in which items are listed
"desc"
OK
Network entity ID in the format of shard.realm.num
"0.0.2"
RFC4648 no-padding base32 encoded account alias
"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.0.2"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
The public key which controls access to various network entities.
"ProtobufEncoded"
"421050820e1485acdd59726088e0e4a2130ebbbb70009f640ad95c78dd5a7b38"
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
"0.0.2"
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
"1586567700.453054000"
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
2
The order in which items are listed
"asc"
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.
"cryptotransfer"
If provided and set to false transactions will not be included in the response
true
OK
Network entity ID in the format of shard.realm.num
"0.0.2"
RFC4648 no-padding base32 encoded account alias
"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.0.2"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
The public key which controls access to various network entities.
"ProtobufEncoded"
"421050820e1485acdd59726088e0e4a2130ebbbb70009f640ad95c78dd5a7b38"
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
"0.0.2"
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
"1586567700.453054000"
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
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
1
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.0.2"
The number of tinybars awarded
10
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
Network entity ID in the format of shard.realm.num
"0.0.2"
A Unix timestamp in seconds.nanoseconds format
"1586567700.453054000"
Returns a list of transactions for a given non-fungible token
Network entity ID in the format of shard.realm.num
"0.1.2"
The nft serial number
1
The maximum number of items to return
2
The order in which items are listed
"asc"
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
OK
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
Network entity ID in the format of shard.realm.num
"0.1.2"
"/api/v1/transactions?timestamp=lt:1657598275.517984411"
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
"3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be"
Whether to include balance information or not. If included, token balances are limited to at most 50 per account as outlined in HIP-367.
true
The maximum number of items to return
2
The order in which items are listed
"desc"
OK
Network entity ID in the format of shard.realm.num
"0.1.2"
RFC4648 no-padding base32 encoded account alias
"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"
"1586567700.453054000"
Network entity ID in the format of shard.realm.num
"0.1.2"
"1586567700.453054000"
Whether the account declines receiving a staking reward
A network entity encoded as an EVM address in hex.
"0x0000000000000000000000000000000000001f41"
"1586567700.453054000"
"ProtobufEncoded"
10101
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
"0.1.2"
The account to which this account is staking
The id of the node to which this account is staking
"1586567700.453054000"
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
"/api/v1/transactions?timestamp=lt:1657598275.517984411"