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>",
    "decimals": 123,
    "rawTotalSupply": "<string>"
  }
}

​
Overview

The supply endpoints provide complete supply information for any SPL token on Solana. This includes total supply, circulating supply, decimals, and raw values.

​
Endpoints

EndpointDescription
GET /api/supply/:mintAddressReturns complete supply info (total, circulating, decimals, raw)
GET /api/supply/:mintAddress/totalReturns just the total supply
GET /api/supply/:mintAddress/circulatingReturns just the circulating supply

​
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

​
Example Request

curl https://your-api-domain.com/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta

​
Example Response

{
  "result": "1000000.0",
  "data": {
    "mint": "METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta",
    "totalSupply": "1000000.0",
    "circulatingSupply": "1000000.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://your-api-domain.com/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. Useful for CoinGecko and CoinMarketCap integrations.

​
Example Request

curl https://your-api-domain.com/api/supply/METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta/circulating

​
Example Response

1000000.0
This endpoint returns a plain text response, not JSON, for easy integration with price aggregators.

​
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

API Overview

Learn about the API architecture

Error Handling

Handle API errors properly