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

account_info

Account info provided by the account owner

centralized_account_info

Account information available for known accounts provided by CSPR.cloud team

cspr_name

string

Primary CSPR.name of the account

rank

uint64

Rank of the account based on its total balance on the network

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": 8744504704680363000,
      "deployment_threshold": 1,
      "genesis_balance": 9999995600000000000,
      "key_management_threshold": 1,
      "main_purse_uref": "uref-b06a1ab0cfb52b5d4f9a08b68a5dbe78e999de0b0484c03e64f5c03897cf637b-007",
      "public_key": "018afa98ca4be12d613617f7339a2d576950a2f9a92102ca4d6508ee31b54d2c02"
    },
    {
      "account_hash": "681a66e75cdeacd4c00ec94b1508b75f2e4dbb4b04ca732be688a006317f47d6",
      "balance": 57000019000000000,
      "deployment_threshold": 1,
      "genesis_balance": null,
      "key_management_threshold": 1,
      "main_purse_uref": "uref-b1376e532a6af911a692cec42b3468c90e6d84f6edeea4b20c824062affa7c4e-007",
      "public_key": "0202036ef47003f6f2dbb7d2d9f00d191146e4890ed289e31b7fab02035c1ddd8ca3"
    },
    ...
    {
      "account_hash": "9081ded33b9d55aab6801da9c2fa5ce0750aee6eac158ae4989ee733def542f3",
      "balance": 2122653718133811,
      "deployment_threshold": 1,
      "genesis_balance": null,
      "key_management_threshold": 1,
      "main_purse_uref": "uref-ee882b37ed505a6fb240b2cc843c82c5a8107fafc2a234c5838ac9013b98046e-007",
      "public_key": "015ac0d71b2142f35c974471589876bc7684bf4e495354a885ebd0ac2b1ffbcc01"
    }
  ],
  "item_count": 101225,
  "page_count": 10123
}

Last updated