REST API
For our whitelisted partners, you may use the following root endpoints: https://testnet.mirrornode.hedera.com https://mainnet.mirrornode.hedera.com For all other users, you may check out DragonGlass and Kabuto as alternatives.
The accounts object represents the information associated with an account and returns a list of account information.
Account IDs take the following format: 0.0.<account number>.
Example: 0.0.1000
Account IDs can also take the account number as an input value. For example, for account ID 0.0.1000, the number 1000 can be specified in the request.
getaccounts
{"accounts": [{"balance": {"timestamp": "1568420100.066845000","balance": 628318531},"account": "0.0.1","expiry_timestamp": null,"auto_renew_period": null,"key": null,"deleted": null,"entity_type": "account"}],"links": {"next": "/api/v1/accounts?limit=1&account.id=gt:0.0.1"}}
Response Item | Description |
accounts | The list of information returned for all accounts |
balance | The timestamp and account balance of the account |
account | The ID of the account |
expiry timestamp | The expiry date for the entity as set by a create or update transaction |
auto renew period | The period in which the account autorenews |
key | The key associated with the account |
deleted | Whether the account was deleted or not (Boolean) |
entity type | The type of Hedera service: account, file, or contract |
links.next | Hyperlink to the next page of results |
Operator | Example | Description |
|
| Returns account IDs less then 1000 |
|
| Returns account IDs less than or equal to 1000 |
|
| Returns account IDs greater than 1000 |
|
| Returns account IDs greater than or equal to 1000 |
|
| Returns account information in ascending order Returns account information in descending order |
Example Requests | Description |
| Returns the account information of account 1001 |
| Returns all account information that have a balance greater than 1000 tinybars |
| Returns all account information for 2b60955bcbf0cf5e9ea880b52e5b63f664b08edf6ed15e301049517438d61864 public key |
The balance object represents the balance of accounts on the Hedera network. You can retrieve this to view the most recent balance of all the accounts on the network at that given time. The balances object returns the account ID and the balance in hbars. Balances are checked on a periodic basis and thus return the most recent snapshot of time captured prior to the request.
getbalances
{"timestamp": "1568420100.066845000","balances": [{"account": "0.0.16316","balance": 500005000},{"account": "0.0.16315","balance": 500005000},{"account": "0.0.16314","balance": 500005000},{"account": "0.0.16313","balance": 500005000},{"account": "0.0.16312","balance": 500005000}],"links": {"next": "/api/v1/balances?limit=5&account.id=lt:0.0.16312"}}
Response Item | Description |
timestamp | The seconds.nanoseconds of the timestamp at which the list of balances for each account are returned |
balances | List of balances for each account |
account | The ID of the account |
balance | The balance of the account |
links.next | Hyperlink to the next page of results |
Operator | Example | Description |
|
| Returns the balances of account IDs less than 1,000 |
|
| Returns the balances account IDs less than or equal to 1,000 |
|
| Returns the balances of account IDs greater than to 1,000 |
|
| Returns the balances of account IDs greater than or equal to 1,000 |
|
| Lists balances in ascending order Lists balances in descending order |
Example Requests | Description |
| Returns balance for account ID 1,000 |
| Returns all account IDs that have a balance greater than 1000 tinybars |
| Returns all account balances referencing the latest snapshot that occured prior to 1566562500 seconds and 040961001 nanoseconds |
| Returns balance information for 2b60955bcbf0cf5e9ea880b52e5b63f664b08edf6ed 15e301049517438d61864 public key |
The transaction object represents the transactions processed on the Hedera network. You can retrieve this to view the transaction metadata information including transaction id, timestamp, transaction fee, transfer list, etc. If a transaction was submitted to multiple nodes, the successful transaction and duplicate transaction(s) will be returned as separate entries in the response with the same transaction ID. Duplicate transactions will still be assessed network fees.
gettransactions
result=faill the query returns all failed cryptocurrency transactions
If the result=success the query returns all successful cryptocurrency transactionstype=credit the query returns all transactions that deposited into an account ID
If type=debit the query returns all transactions that withdrew from an account ID"transactions": [{"consensus_timestamp": "1592946499.489772000","transaction_hash": "Vqes7MbclJ6ygnr2crDtzLxuB3c1ikX67UUEq5s8zEx6ZQcSP4+Q/ROAeZ4/bSIP","valid_start_timestamp": "1592946489.339479000","charged_tx_fee": 238219,"memo_base64": "TmV0d29yayBwaW5n","result": "SUCCESS","name": "CRYPTOTRANSFER","max_fee": "100000000","valid_duration_seconds": "120","node": "0.0.3","transaction_id": "0.0.88-1592946489-339479000","transfers": [{"account": "0.0.3","amount": 14536},{"account": "0.0.88","amount": -238220},{"account": "0.0.98","amount": 223684}]}],"links": {"next": "/api/v1/transactions?limit=1×tamp=lt:1592946499.489772000"}}
Response Item | Description |
consensus timestamp | The consensus timestamp in seconds.nanoseconds |
transaction hash | The hash value of the transaction processed on the Hedera network |
valid start timestamp | The time the transaction is valid |
charged tx fee | The transaction fee that was charged for that transaction |
transaction id | The ID of the transaction |
memo base64 | The memo attached to the transaction encoded in Base64 format |
result | Whether the cryptocurrency transaction was successful or not |
name | The type of transaction |
max fee | The maximum transaction fee the client is willing to pay |
valid duration seconds | The seconds for which a submitted transaction is to be deemed valid beyond the start time. The transaction is invalid if consensusTimestamp is greater than transactionValidStart + valid_duration_seconds. |
node | The ID of the node that submitted the transaction to the network |
transfers | A list of the account IDs the crypto transfer occurred between and the amount that was transferred. A negative (-) sign indicates a debit to that account. The transfer list includes the transfers between the from account and to account, the transfer of the node fee, the transfer of the network fee, and the transfer of the service fee for that transaction. If the transaction was not processed, a network fee is still assessed. |
links.next | A hyperlink to the next page of responses |
Operator | Example | Description |
|
| Returns account.id transactions less than 1,000 |
|
| Returns account.id transactions less than or equal to 1,000 |
|
| Returns account.id transactions greater than 1,000 |
|
| Returns account.id transactions greater than or equal to 1,000 |
|
| Lists transactions in ascending order Lists transactions descending order |
Note: It is recommended that the account.id query should not select no more than 1000 accounts in a query. If the range specified in the query results in selecting more than 1000 accounts, the API will automatically only search for the first 1000 accounts that match the query in the database and return the transactions for those. For example, if you use ?account.id=gt:0.0.15000 or if you use?account.id=gt:0.0.15000&account.id=lt:0.0.30000, then the API will only return results or some 1000 accounts in this range that match the rest of the query filters.
A single transaction can also be returned by specifying the transaction ID in the request. If a transaction was submitted to multiple nodes, the response will return entries for the successful transaction along with separate entries for the duplicate transaction(s). The "result" key indicates "success" for the node that processed the transaction and "DUPLICATE_TRANSACTION" for each additional node submission. Duplicate entries are still charged network fees.
Parameter | Description |
| A specific transaction can be returned by specifying a transaction ID |
Example Request | Description |
| Returns transaction for account ID 1,000 |
| Returns transactions at 1565779209 seconds and 711927001 nanoseconds |
| Returns all transactions that have failed |
| Returns all transactions that deposited into an account ID 0.0.13622 Returns all transactions that withdrew from account ID 0.0.13622 |
gettopic messages
"responseJson": {"consensus_timestamp": "1234567890.000000002","topic_id": "0.0.7","message": "bWVzc2FnZQ==","running_hash": "cnVubmluZ19oYXNo","sequence_number": 2}
Response Item | Description |
consensus_timestamp | The consensus timestamp of the message in seconds.nanoseconds |
topic_id | The ID of the topic the message was submitted to |
message | The content of the message |
running_hash | The new running hash of the topic that received the message |
sequence_number | The sequence number of the message relative to all other messages for the same topic |