Returns a total supply figure. As with issued_supply, the public reference only requires the x-cache-id header.
Endpoint
POST https://mempool.lineage.to/total_supply
Headers
| Header | Type | Description |
|---|---|---|
x-cache-id | string | Idempotency / cache key. Must match the documented pattern (32 lowercase hex characters, e.g. ^[a-z0-9]{32}$). The response id matches this value. |
Request body
None (empty body).
Example
curl -sS -X POST "https://mempool.lineage.to/total_supply" \ -H "Content-Type: application/json" \ -H "x-cache-id: 0123456789abcdef0123456789abcdef" \ -d ''
Responses
200 on success, with a numeric (or string-encoded numeric) content in the common envelope. Exact semantics of “total” are defined by the node version.
Example success payload
{
"id": "0123456789abcdef0123456789abcdef",
"status": "Success",
"reason": "Supply returned",
"route": "total_supply",
"content": 0
}Example error envelope (typical 400)
{
"id": null,
"status": "Error",
"reason": "Bad Request",
"route": null,
"content": null
}