Skip to main content
Retrieve the locked supply of a token: the sum of tokens allocated under an active vesting/unlock schedule that have not yet released, computed as SUM(amount - releasable) across active allocations. Cancelled and completed allocations are excluded. This is a cap-table view, not on-chain. To approximate circulating supply (e.g. for CoinMarketCap), subtract this value from the on-chain total supply. The endpoint returns a plain-text number. Route: GET /api/external/v1/tokens/{id}/locked-supply
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 — see Authentication.

​
Headers

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-magna-api-tokenYesYour Magna API token

​
Path parameters

ParameterTypeDescription
idstring (uuid)The token ID

​
Request example

curl -X GET 'https://app.magna.so/api/external/v1/tokens/{token_id}/locked-supply?id={token_id}' \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_STATS_API_KEY'

​
Response example

550000000