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.

Access Control:

This endpoint requires the EXTERNAL_STATS_READ scope, which is more restrictive than full access API keys. You can generate a scoped API key with EXTERNAL_STATS_READ permissions from your project settings at /settings/api-keys (called "Statistics API Key"). This allows third-party integrations to access token statistics without full project access.

Example request:

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:

1000000000