---
title: "Circulating supply"
method: GET
path: "/api/supply/{mintAddress}/circulating"
tags: ["Supply"]
---

# Circulating supply

`GET /api/supply/{mintAddress}/circulating`

## Request

- Base URL: `https://market-api.metadao.fi/v1`
- URL: `https://market-api.metadao.fi/v1/api/supply/{mintAddress}/circulating`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/metadao/apis/futarchy-external-api/docs/api/supply/:mintAddress/circulating/get.ts> (a function with typed inputs; its response is checked against the schema)

Circulating supply = total supply minus the team performance package, unclaimed additional token allocation and DAO treasury tokens. AMM and Meteora liquidity IS circulating. `allocation` is present only for launchpad tokens with a non-trivial breakdown.

## Path parameters

- `mintAddress` string, required: Solana public key (base58).

## Response `200`

Circulating supply.

- CirculatingSupplyResponse
  - `result` string, required: Circulating supply. Decimal string in human units.
  - `allocation` object: Present only for launchpad tokens with allocation details.
    - `teamPerformancePackageAddress` string: Solana public key (base58).
    - `futarchyAmmVaultAddress` string: Solana public key (base58).
    - `meteoraPoolAddress` string: Solana public key (base58).
    - `meteoraVaultAddress` string: Solana public key (base58).
    - `additionalTokenAllocation` AdditionalTokenAllocation: v0.7+ additional token recipient allocation.
      - `amount` string, required
      - `recipient` string, required: Solana public key (base58).
      - `claimed` boolean, required
      - `tokenAccountAddress` string: Solana public key (base58).
    - `initialTokenAllocation` InitialTokenAllocation: Claimed initial allocation that IS circulating (special cases).
      - `amount` string, required
      - `claimed` boolean, required
    - `daoTreasuryTokens` DaoTreasuryTokens: Base tokens held in the DAO treasury vault (not circulating).
      - `amount` string, required
      - `vaultAddress` string: Solana public key (base58).
    - `daoAddress` string: Solana public key (base58).
    - `launchAddress` string: Solana public key (base58).
    - `version` string

## Other responses

- `400`: Invalid request: `INVALID_MINT_ADDRESS` for a bad path address, `INVALID_QUERY_PARAMETER` for a missing, malformed or repeated query parameter. `field` names the parameter.
- `401`: Unknown `X-API-Key` (`INVALID_API_KEY`), or missing/invalid metrics bearer token on `/metrics`.
- `429`: Rate limit exceeded (`RATE_LIMITED`).
- `500`: Unexpected server or upstream (RPC/DB) failure. Retry later.
- `503`: A dependency is unavailable or its data is stale (e.g. `SERVED_DB_UNAVAILABLE`, `SERVED_DATA_STALE`) or the request timed out (`REQUEST_TIMEOUT`). Retry later.

---

[API](https://skmtc.dev/metadao/apis/futarchy-external-api.md) - [All operations](https://skmtc.dev/metadao/apis/futarchy-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metadao/apis/futarchy-external-api/revisions/27b09f0a2750?raw)