> ## 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.

# Locked Supply

> Retrieve the locked supply of a token — allocated tokens under an active schedule that have not yet released.

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`

<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** — see [Authentication](/apis/admin/authentication#api-key-types).
</Note>

## Headers

| Header              | Required | Description                |
| ------------------- | -------- | -------------------------- |
| `Content-Type`      | Yes      | Must be `application/json` |
| `x-magna-api-token` | Yes      | Your Magna API token       |

## Path parameters

| Parameter | Type          | Description  |
| --------- | ------------- | ------------ |
| `id`      | string (uuid) | The token ID |

## Request example

```sh theme={null}
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
```