Get accounts

Get the paginated list of accounts

GET /accounts

Query params

Query param
Description

account_hash

Comma-separated list of account hashes

Sorting

Property
Description

balance

Sort accounts by the main purse balance

total_balance

Sort accounts by the total account balance, including the delegated funds

Default sorting is total_balance DESC

Optional properties

Property
Type
Description

auction_status

string

Account auction status: inactive_bidder, active_bidder, active_validator, pending_validator

delegated_balance

uint64

Total funds delegated across all validators

staked_balance

uint64

Total funds staked as validator

undelegating_balance

uint64

Total undelegated funds that will be returned to the account main purse after the 7 era lockdown period

Response

PaginatedResponse<Account>

Example

curl -X 'GET' \
  'https://api.testnet.cspr.cloud/accounts' \
  -H 'accept: application/json' \
  -H 'authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'
{
  "data": [
    {
      "account_hash": "b383c7cc23d18bc1b42406a1b2d29fc8dba86425197b6f553d7fd61375b5e446",
      "balance": 9521556398257160000,
      "main_purse_uref": "uref-b06a1ab0cfb52b5d4f9a08b68a5dbe78e999de0b0484c03e64f5c03897cf637b-007",
      "public_key": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02"
    },
    {
      "account_hash": "5e718fa0918ae95e58b9a320f412b935af6544b04b6b89fb2ca9982cab0dd261",
      "balance": 2390125170301261,
      "main_purse_uref": "uref-f99169b612ce584e69dd69e3437fea137b61aff8dcadf71fc83c3b85ab30aa64-007",
      "public_key": "02022732f61c794d7974d9473554b46b32e8d47903ada3ca3604ce313d66343e0d2f"
    },
    ...
    {
      "account_hash": "7894d8458c82388f6d276c07c1c52033ac37b175fa722b9cc40e7a0157ce17fc",
      "balance": 252400825961483,
      "main_purse_uref": "uref-c4afe0fb020ebcdc940289d759499ff5fb87e999567e4d61d836d70bfad20a55-007",
      "public_key": "0145fb72c75e1b459839555d70356a5e6172e706efa204d86c86050e2f7878960f"
    }
  ],
  "item_count": 63177,
  "page_count": 6318
}

Last updated