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

# Supply breakdown

`GET /api/supply/{mintAddress}`

## Request

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

Total and circulating supply plus the launchpad allocation breakdown. `result` is the TOTAL supply; circulating supply is in `data.circulatingSupply`.

## Path parameters

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

## Response `200`

Supply breakdown.

- SupplyResponse
  - `result` string, required: TOTAL supply (same as data.totalSupply). Decimal string in human units.
  - `data` TokenSupplyInfo, required
    - `mint` string, required: Solana public key (base58).
    - `totalSupply` string, required: Total supply. Decimal string in human units.
    - `circulatingSupply` string, required: Circulating supply. Decimal string in human units.
    - `decimals` integer, required
    - `rawTotalSupply` string, required: Total supply in base units (integer string).
    - `allocation` SupplyAllocation: Non-circulating / liquidity breakdown for launchpad tokens. Amounts are decimal strings in human units; zero-amount entries are omitted.
      - `teamPerformancePackage` object
        - `amount` string, required
        - `address` string: Solana public key (base58).
      - `futarchyAmmLiquidity` object
        - `amount` string, required
        - `vaultAddress` string: Solana public key (base58).
      - `meteoraLpLiquidity` object
        - `amount` string, required
        - `poolAddress` string: Solana public key (base58).
        - `vaultAddress` 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)