Get Total Blockchain Size
1. Overview & Typical Use
Returns cumulative blockchain data size (total on-chain data), sorted in ascending order by time.
- Typical use: monitor the growth trend of total blockchain data size, assess storage requirements.
- When not to use: for daily average block size use “Get Average Block Size Data”.
2. Endpoint & Authentication
GET /api/overview/totalblockchainsize
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
days | integer | No | 15 | Number of days to query |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
lastUpdateSeconds | integer | Required | Last update time | Unix timestamp in seconds (10-digit) |
code | integer | Required | Status code (e.g. 200) | — |
success | boolean | Required | Whether the request succeeded | — |
message | string | Required | Result message (e.g. "request ok") | — |
status | string | Required | Status indicator (e.g. "1" for normal) | — |
data | array | Required | Daily cumulative blockchain size array; see below | — |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | integer | Required | Statistics date | Millisecond timestamp |
dateDayStr | string | Required | Statistics date string, format yyyy-MM-dd | — |
blockchainSize | integer | Required | Cumulative blockchain data size | bytes |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: no data returns
200+data: []— this is a normal response.
Last updated on: