> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magna.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Total Supply

Users can retrieve the total supply of a token from the Magna platform. This endpoint returns the self-reported total supply from the cap table (the minted supply that the project reports), not the smart contract max supply.\
\
This endpoint is designed for token data provider compatibility (ex. Coinmarketcap) and returns a plain text number for easy integration with external systems.

<Note>
  **Access:** Use a **Statistics API Key (Read-Only)** (`EXTERNAL_STATS_READ` scope) or a **Full Access API Token**. Generate a Statistics key under **Settings → API keys** to let third-party integrations read stats without full project access. See [Authentication](/apis/admin/authentication#api-key-types).
</Note>

Example request:

```sh theme={null}
curl -X GET https://app.magna.so/api/external/v1/tokens/{your_token_id}/total-supply?id={your_token_id} \
  -H 'Content-Type: application/json' \
  -H 'x-magna-api-token: magna_project_api_token'
```

* `magna_project_api_token` (required) - replace with your actual Magna API token
* `your_token_id` (required) - with your token id

Response example:

```json theme={null}
1000000000
```