Returns the current token distribution.

GET 
http://127.0.0.1:8000/api/explorer/v2/ledger/token-distribution

Returns the distribution of IOTA tokens at the ledger state specified by the provided index.

Request

Query Parameters

ledgerIndex integer
The milestone index to be used to determine the ledger state. Defaults to the application's current ledger index.
Example: 200000

Responses

200

Successful operation.

application/json

Schema

Schema

distribution object[]required
The distribution of IOTA tokens.
Array [
range objectrequired
The range of balances.
start numberrequired
end numberrequired
addressCount stringrequired
The number of addresses in this range.
totalBalance stringrequired
The total balance within this range.
]

Example (from schema)

{
  "distribution": [
    {
      "range": {
        "start": 0,
        "end": 0
      },
      "addressCount": "string",
      "totalBalance": "string"
    }
  ]
}

default

{
  "distribution": [
    {
      "range": [
        {
          "start": 100000,
          "end": 1000000
        }
      ],
      "addressCount": "39",
      "totalBalance": "14612000"
    },
    {
      "range": [
        {
          "start": 1000000,
          "end": 10000000
        }
      ],
      "addressCount": "22",
      "totalBalance": "41274500"
    },
    {
      "range": [
        {
          "start": 100000000,
          "end": 1000000000
        }
      ],
      "addressCount": "27",
      "totalBalance": "25486528000"
    }
  ],
  "ledgerIndex": 1005429
}

400

Unsuccessful operation: indicates that the provided parameters are invalid.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 400,
    "message": "invalid data provided"
  }
}

404

Unsuccessful operation: indicates that the requested data was not found.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 404,
    "message": "could not find data"
  }
}

500

Unsuccessful operation: indicates that an unexpected, internal server error happened which prevented the node from fulfilling the request.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 500,
    "message": "internal server error"
  }
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET 'http://127.0.0.1:8000/api/explorer/v2/ledger/token-distribution' \
-H 'Accept: application/json'

Request Collapse all

Base URL

http://127.0.0.1:8000

Parameters

ledgerIndex — query

ResponseClear

Click the Send API Request button above and see the response here!