---
title: "Token total supply, formatted ($0.003)"
method: GET
path: "/v1/chain/supply"
---

# Token total supply, formatted ($0.003)

`GET /v1/chain/supply`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/chain/supply`
- Auth: none declared

Token total supply, formatted, read live from Base mainnet. Charged only if the read succeeds. Unsigned; the attested version of chain reads is /v1/oracle/onchain.

## Query parameters

- `token` string, required

## Response `200`

Result.

- object

## Other responses

- `400`: Bad parameters. Nothing charged.
- `402`: Payment required.
- `502`: The chain could not be read. Nothing charged.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)