GET /api/supply

Retrieve complete token supply breakdown with allocation details

GET /api/supply/:mintAddress

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:

Category Description Circulating?
Circulating Supply Total supply minus team performance package ✅ Yes
Team Performance Package Locked tokens allocated to the team (price-based unlock) ❌ No
FutarchyAMM Liquidity Tokens in the internal FutarchyAMM for spot trading ✅ Yes
Meteora LP Liquidity Tokens 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

Endpoint Description
GET/api/supply/:mintAddress Returns complete supply breakdown with allocation details
GET/api/supply/:mintAddress/total Returns total supply only
GET/api/supply/:mintAddress/circulating Returns circulating supply (excludes team performance package)

Full Supply Information

Endpoint: GET/api/supply/:mintAddress

Returns complete supply information for a token.

Path Parameters

mintAddressstringrequired

The SPL token mint address (Solana PublicKey)

Example: METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta

Response

resultstringrequired

The formatted total supply as a string

dataobjectrequired

Complete supply data object with allocation breakdown

data properties
mintstring

The token mint address

totalSupplystring

Total token supply (formatted with decimals)

circulatingSupplystring

Circulating token supply - excludes team performance package (formatted with decimals)

teamPerformancePackagestring

Locked tokens allocated to the team with price-based unlock - NOT circulating

futarchyAmmLiquiditystring

Tokens in the internal FutarchyAMM for spot trading - IS circulating

meteoraLpLiquiditystring

Tokens in the external Meteora DAMM pool (POL) - IS circulating

decimalsnumber

Token decimal places

rawTotalSupplystring

Raw total supply without decimal formatting

Example Request

cURL
curl https://market-api.metadao.fi/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta
JavaScript
const mintAddress = 'METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta';
const response = await fetch(`https://market-api.metadao.fi/api/supply/${mintAddress}`);
const data = await response.json();
console.log(data);
Python
import requests

mint_address = 'METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta'
response = requests.get(f'https://market-api.metadao.fi/api/supply/{mint_address}')
data = response.json()
print(data)

Example Response

json
{
  "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

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

Example Response

Code
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 Package

Both FutarchyAMM liquidity and Meteora LP liquidity are included in circulating supply since these tokens are actively tradeable.

Example Request

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

Example Response

Code
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

json
{
  "error": "Invalid mint address"
}

Mint Not Found

json
{
  "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

Was this page helpful?