1 of 1

Get Accounts by ID

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.

Get Accounts by ID

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.

Get account by alias, id, or evm address

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.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/accounts/{idOrAliasOrEvmAddress}

Path parameters

idOrAliasOrEvmAddress*string

Account alias or account id or evm address

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$

Query parameters

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

transactiontypeTransactionTypes (enum)

Example: "cryptotransfer"

CONSENSUSCREATETOPICCONSENSUSDELETETOPICCONSENSUSSUBMITMESSAGECONSENSUSUPDATETOPICCONTRACTCALLCONTRACTCREATEINSTANCECONTRACTDELETEINSTANCECONTRACTUPDATEINSTANCECRYPTOADDLIVEHASHCRYPTOAPPROVEALLOWANCECRYPTOCREATEACCOUNTCRYPTODELETECRYPTODELETEALLOWANCECRYPTODELETELIVEHASHCRYPTOTRANSFERCRYPTOUPDATEACCOUNTETHEREUMTRANSACTIONFILEAPPENDFILECREATEFILEDELETEFILEUPDATEFREEZENODESTAKEUPDATESCHEDULECREATESCHEDULEDELETESCHEDULESIGNSYSTEMDELETESYSTEMUNDELETETOKENASSOCIATETOKENBURNTOKENCREATIONTOKENDELETIONTOKENDISSOCIATETOKENFEESCHEDULEUPDATETOKENFREEZETOKENGRANTKYCTOKENMINTTOKENPAUSETOKENREVOKEKYCTOKENUNFREEZETOKENUNPAUSETOKENUPDATETOKENWIPEUNCHECKEDSUBMITUNKNOWNUTILPRNG

transactionsboolean

If provided and set to false transactions will not be included in the response

Example: true

Response

Body

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

alias*nullable Alias (string)

RFC4648 no-padding base32 encoded account alias

Example: "HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"

Pattern: ^(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8})$

auto_renew_period*nullable integer (int64)

balance*nullable Balance (object)

timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

balance*nullable integer (int64)

tokens*array of object

token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

balanceinteger (int64)

created_timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

decline_reward*boolean

Whether the account declines receiving a staking reward

deleted*nullable boolean

ethereum_nonce*nullable integer (int64)

evm_address*nullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0x0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

expiry_timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

key*nullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

max_automatic_token_associations*nullable integer (int32)

memo*nullable string

pending_rewardinteger (int64)

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.

receiver_sig_required*nullable boolean

staked_account_id*all of

nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

any

The account to which this account is staking

staked_node_id*nullable integer (int64)

The id of the node to which this account is staking

stake_period_start*all of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

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

transactions*Transactions (array of Transaction (object))

bytesnullable string (byte)

charged_tx_feeinteger (int64)

consensus_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

entity_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

max_feestring

memo_base64nullable string (byte)

nameTransactionTypes (enum)

nft_transfersarray of object

is_approval*boolean

receiver_account_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

sender_account_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

serial_number*integer (int64)

Example: 1

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

nodenullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

nonceinteger

parent_consensus_timestampnullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

resultstring

scheduledboolean

staking_reward_transfersStakingRewardTransfers (array of StakingRewardTransfer (object))

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

The number of tinybars awarded

Example: 10

token_transfersarray of object

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

is_approvalboolean

transaction_hashstring (byte)

transaction_idstring

transfersarray of object

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

is_approvalboolean

valid_duration_secondsstring

valid_start_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

links*Links (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

Get account by alias, id, or evm address

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/accounts/{idOrAliasOrEvmAddress}

Path parameters

idOrAliasOrEvmAddress*string

Account alias or account id or evm address

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$

Query parameters

limitinteger (int32)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "asc"

ascdesc

timestamparray of string

The consensus timestamp in seconds.nanoseconds format with an optional comparison operator

itemsstring

Pattern: ^((eq|gt|gte|lt|lte|ne):)?\d{1,10}(.\d{1,9})?$

transactiontypeTransactionTypes (enum)

Example: "cryptotransfer"

transactionsboolean

If provided and set to false transactions will not be included in the response

Example: true

Response

Body

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

alias*nullable Alias (string)

RFC4648 no-padding base32 encoded account alias

Example: "HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"

Pattern: ^(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8})$

auto_renew_period*nullable integer (int64)

balance*nullable Balance (object)

timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

balance*nullable integer (int64)

tokens*array of object

token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

balanceinteger (int64)

created_timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

decline_reward*boolean

Whether the account declines receiving a staking reward

deleted*nullable boolean

ethereum_nonce*nullable integer (int64)

evm_address*nullable EvmAddressNullable (string (binary))

A network entity encoded as an EVM address in hex.

Example: "0x0000000000000000000000000000000000001f41"

Pattern: ^(0x)?[A-Fa-f0-9]{40}$

expiry_timestamp*nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

key*nullable Key (object)

_typeenum

Example: "ProtobufEncoded"

ECDSA_SECP256K1ED25519ProtobufEncoded

keystring

Example: 10101

max_automatic_token_associations*nullable integer (int32)

memo*nullable string

pending_rewardinteger (int64)

receiver_sig_required*nullable boolean

staked_account_id*all of

nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

any

The account to which this account is staking

staked_node_id*nullable integer (int64)

The id of the node to which this account is staking

stake_period_start*all of

nullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

transactions*Transactions (array of Transaction (object))

bytesnullable string (byte)

charged_tx_feeinteger (int64)

consensus_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

entity_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

max_feestring

memo_base64nullable string (byte)

nameTransactionTypes (enum)

nft_transfersarray of object

is_approval*boolean

receiver_account_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

sender_account_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

serial_number*integer (int64)

Example: 1

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

nodenullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

nonceinteger

parent_consensus_timestampnullable TimestampNullable (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

resultstring

scheduledboolean

staking_reward_transfersStakingRewardTransfers (array of StakingRewardTransfer (object))

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

The number of tinybars awarded

Example: 10

token_transfersarray of object

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

is_approvalboolean

transaction_hashstring (byte)

transaction_idstring

transfersarray of object

account*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

amount*integer (int64)

is_approvalboolean

valid_duration_secondsstring

valid_start_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

links*Links (object)

nextnullable string

Example: "/api/v1/transactions?timestamp=lt:1657598275.517984411"

Request

Response

{
  "account": "0.0.8",
  "alias": "HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA",
  "auto_renew_period": null,
  "balance": {
    "timestamp": "0.000002345",
    "balance": 80,
    "tokens": [
      {
        "token_id": "0.0.200001",
        "balance": 8
      }
    ]
  },
  "created_timestamp": "1562591528.000123456",
  "decline_reward": false,
  "deleted": false,
  "ethereum_nonce": 10,
  "evm_address": "0xac384c53f03855fa1b3616052f8ba32c6c2a2fec",
  "expiry_timestamp": null,
  "key": null,
  "max_automatic_token_associations": 200,
  "memo": "entity memo",
  "pending_reward": 100,
  "receiver_sig_required": false,
  "staked_account_id": null,
  "staked_node_id": 3,
  "stake_period_start": "172800000.000000000",
  "transactions": [
    {
      "bytes": null,
      "charged_tx_fee": 7,
      "consensus_timestamp": "1234567890.000000007",
      "entity_id": "0.0.2281979",
      "max_fee": 33,
      "memo_base64": null,
      "name": "CRYPTOTRANSFER",
      "nft_transfers": [
        {
          "is_approval": true,
          "receiver_account_id": "0.0.121",
          "sender_account_id": "0.0.122",
          "serial_number": 1,
          "token_id": "0.0.123"
        },
        {
          "is_approval": true,
          "receiver_account_id": "0.0.321",
          "sender_account_id": "0.0.422",
          "serial_number": 2,
          "token_id": "0.0.123"
        }
      ],
      "node": "0.0.3",
      "nonce": 0,
      "parent_consensus_timestamp": "1234567890.000000007",
      "result": "SUCCESS",
      "scheduled": false,
      "staking_reward_transfers": [
        {
          "account": 3,
          "amount": 150
        },
        {
          "account": 9,
          "amount": 200
        }
      ],
      "transaction_hash": "vigzKe2J7fv4ktHBbNTSzQmKq7Lzdq1/lJMmHT+a2KgvdhAuadlvS4eKeqKjIRmW",
      "transaction_id": "0.0.8-1234567890-000000006",
      "token_transfers": [
        {
          "token_id": "0.0.90000",
          "account": "0.0.9",
          "amount": 1200,
          "is_approval": false
        },
        {
          "token_id": "0.0.90000",
          "account": "0.0.8",
          "amount": -1200,
          "is_approval": false
        }
      ],
      "transfers": [
        {
          "account": "0.0.3",
          "amount": 2,
          "is_approval": false
        },
        {
          "account": "0.0.8",
          "amount": -3,
          "is_approval": false
        },
        {
          "account": "0.0.98",
          "amount": 1,
          "is_approval": false
        },
        {
          "account": "0.0.800",
          "amount": 150,
          "is_approval": false
        },
        {
          "account": "0.0.800",
          "amount": 200,
          "is_approval": false
        }
      ],
      "valid_duration_seconds": 11,
      "valid_start_timestamp": "1234567890.000000006"
    }
  ],
  "links": {
    "next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
  }
}