Get TRC20 Token Circulating Supply
1. Overview & Typical Use
Returns the current circulating supply of a specified TRC20 token, already converted to a human-readable value at the token’s precision. The response format is plain text (not JSON).
- Typical use: token circulating supply display, supply monitoring.
- When not to use: to query detailed token information use “Get TRC20/TRC721/TRC1155 Token Details”.
addressis a required parameter; an invalid contract address returns an empty string or0.
2. Endpoint & Authentication
GET /api/token_trc20/totalSupply
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | TRC20 contract address |
4. Response
Fields
The Content-Type of this endpoint is application/json;charset=utf-8, but the response body is a bare numeric string (not a JSON object). Parse it by reading the raw text content directly.
| Content | Type | Description |
|---|---|---|
| Response body | string (plain text) | Circulating supply value, already converted at the token’s decimal precision |
5. Errors
For HTTP status codes, see Common Errors. Notes for this endpoint:
addressis required: omitting it returns a missing-parameter error.- Invalid contract: passing an invalid contract address returns an empty string or
0.
Last updated on: