Skip to main content
GET
/
api
/
supply
/
:mintAddress
GET /api/supply
curl --request GET \
  --url https://api.example.com/api/supply/:mintAddress
{
  "result": "<string>",
  "data": {
    "mint": "<string>",
    "totalSupply": "<string>",
    "circulatingSupply": "<string>",
    "teamPerformancePackage": "<string>",
    "futarchyAmmLiquidity": "<string>",
    "meteoraLpLiquidity": "<string>",
    "decimals": 123,
    "rawTotalSupply": "<string>"
  }
}

​
Overview

The supply endpoints provide complete supply breakdown for launchpad tokens, including detailed allocation information for circulating supply, team performance packages, and liquidity positions.
For launchpad tokens, circulating supply excludes the team performance package but includes all liquidity (both FutarchyAMM and Meteora DAMM).

​
Supply Breakdown

For launchpad tokens, supply is broken down into the following categories:
CategoryDescriptionCirculating?
Circulating SupplyTotal supply minus team performance package✅ Yes
Team Performance PackageLocked tokens allocated to the team (price-based unlock)❌ No
FutarchyAMM LiquidityTokens in the internal FutarchyAMM for spot trading✅ Yes
Meteora LP LiquidityTokens in the external Meteora DAMM pool (POL)✅ Yes
Liquidity tokens (both FutarchyAMM and Meteora) are counted as circulating supply since they can be traded.

​
Endpoints

EndpointDescription
GET /api/supply/:mintAddressReturns complete supply breakdown with allocation details
GET /api/supply/:mintAddress/totalReturns total supply only
GET /api/supply/:mintAddress/circulatingReturns circulating supply (excludes team performance package)

​
Full Supply Information

Endpoint: GET /api/supply/:mintAddress Returns complete supply information for a token.

​
Path Parameters

​
mintAddress
string
required
The SPL token mint address (Solana PublicKey)Example: METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta

​
Response

​
result
string
required
The formatted total supply as a string
​
data
object
required
Complete supply data object with allocation breakdown

​
Example Request

curl https://market-api.metadao.fi/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta

​
Example Response

{
  "result": "1000000.0",
  "data": {
    "mint": "METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta",
    "totalSupply": "1000000.0",
    "circulatingSupply": "850000.0",
    "teamPerformancePackage": "150000.0",
    "futarchyAmmLiquidity": "200000.0",
    "meteoraLpLiquidity": "100000.0",
    "decimals": 9,
    "rawTotalSupply": "1000000000000000"
  }
}

​
Total Supply Only

Endpoint: GET /api/supply/:mintAddress/total Returns just the total supply value as a plain string. Useful for integrations that only need the total supply number.

​
Example Request

curl https://market-api.metadao.fi/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta/total

​
Example Response

1000000.0
This endpoint returns a plain text response, not JSON, for easy integration with tools expecting a simple number.

​
Circulating Supply Only

Endpoint: GET /api/supply/:mintAddress/circulating Returns just the circulating supply value as a plain string. This value excludes the team performance package but includes all liquidity positions.
Circulating = Total Supply - Team Performance PackageBoth FutarchyAMM liquidity and Meteora LP liquidity are included in circulating supply since these tokens are actively tradeable.

​
Example Request

curl https://market-api.metadao.fi/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta/circulating

​
Example Response

850000.0
This endpoint returns a plain text response, not JSON, for easy integration with price aggregators like CoinGecko and CoinMarketCap.

​
Use Cases

Price Aggregators

CoinGecko and CoinMarketCap require supply endpoints for market cap calculations

Token Dashboards

Display real-time supply metrics on token information pages

Analytics

Track supply changes over time for tokenomics analysis

DeFi Integrations

Calculate fully diluted valuations and token metrics

​
Error Handling

​
Invalid Mint Address

{
  "error": "Invalid mint address"
}

​
Mint Not Found

{
  "error": "Token mint not found"
}

Tickers API

Get pricing and volume data for all DAOs

Volume Aggregate

Get aggregate volume with daily breakdown

API Overview

Learn about the API architecture

Error Handling

Handle API errors properly