---
title: "Get historical total supply for a token"
method: GET
path: "/tokenization/tokens/{id}/total_supply"
tags: ["Tokenization"]
---

# Get historical total supply for a token

`GET /tokenization/tokens/{id}/total_supply`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/tokenization/tokens/{id}/total_supply`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/tokenization/tokens/:id/total_supply/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns paginated total supply history for the token contract with optional time-range filtering and binning.

## Path parameters

- `id` string, required

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `interval` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH'
- `pageCursor` string
- `pageSize` integer
- `sortBy` 'blockTimestamp'
- `order` 'ASC' | 'DESC'

## Response `200`

Successfully retrieved the token total supply history

- TotalSupplyPagedResponse
  - `data` TotalSupplyItemDto[], required: Array of total supply data points
    - `timestamp` string, date-time, required: Timestamp of the data point
    - `totalSupply` string, required: Total supply at the given timestamp
  - `next` string: Cursor for next page
  - `prev` string: Cursor for previous page
  - `total` number: Total count of items

## Other responses

- `404`: Token not found
- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)