Returns the top richest addresses.
GET/api/explorer/v2/ledger/richest-addresses
Returns the top richest addresses at the ledger state specified by the provided index.
Request
Query Parameters
The milestone index to be used to determine the ledger state. Defaults to the application's current ledger index.
The number of richest addresses to return.
Responses
- 200
- 400
- 404
- 500
Successful operation.
- application/json
- Schema
- Example (from schema)
- default
Schema
- Array [
- Ed25519Address
- AliasAddress
- NFTAddress
- ]
top object[]required
The top wealthiest addresses.
address objectrequired
Set to value 0 to denote an Ed25519 Address.
The hex-encoded, 0x prefixed BLAKE2b-256 hash of the Ed25519 public key
Set to value 8 to denote an Alias Address.
The hex-encoded, 0x prefixed BLAKE2b-256 hash of the outputId that created the alias.
Set to value 16 to denote an NFT Address.
The hex-encoded, 0x prefixed BLAKE2b-256 hash of the outputId that created the NFT.
The total balance within this range.
{
"top": [
{
"balance": "string"
}
]
}
{
"top": [
{
"address": [
{
"type": 0,
"pubKeyHash": "0x3845105b59429361a75b3203a6e24e16d19540aad6bd1936449b62f1c4bbe5da"
}
],
"balance": "2779164783277761"
},
{
"address": [
{
"type": 0,
"pubKeyHash": "0xd0d361341fa3bb2f6855039a82ee9ea470c3336eaf34d22767fdfa901ba63e31"
}
],
"balance": "7398600000"
}
],
"ledgerIndex": 1005429
}
Unsuccessful operation: indicates that the provided parameters are invalid.
- application/json
- Schema
- Example (from schema)
Schema
error objectrequired
The application error code.
The error reason.
{
"error": {
"code": 400,
"message": "invalid data provided"
}
}
Unsuccessful operation: indicates that the requested data was not found.
- application/json
- Schema
- Example (from schema)
Schema
error objectrequired
The application error code.
The error reason.
{
"error": {
"code": 404,
"message": "could not find data"
}
}
Unsuccessful operation: indicates that an unexpected, internal server error happened which prevented the node from fulfilling the request.
- application/json
- Schema
- Example (from schema)
Schema
error objectrequired
The application error code.
The error reason.
{
"error": {
"code": 500,
"message": "internal server error"
}
}