getSupply

The getSupply method returns information about the current supply of SOL. This includes total supply, circulating supply, and the distribution of non-circulating supply across various categories such as staking rewards, foundation holdings, and other allocations.

Understanding token supply is fundamental for economic analysis, market calculations, and tracking the monetary policy of the Solana network. Total supply represents all SOL that exists, while circulating supply excludes tokens that are locked, vested, or otherwise not freely tradable. The difference between these values reveals how much SOL is restricted from circulation, which impacts market dynamics and price calculations.

This method is essential for market data providers, economic dashboards, DeFi protocols that need accurate supply metrics, and analytics platforms tracking Solana's tokenomics. The data helps calculate accurate market capitalization, understand inflation effects, and analyze token distribution patterns. The method also provides detailed breakdowns of non-circulating supply by category.

Parameters

parameter	type	description
config	object	Optional configuration object
config.commitment	string	Level of commitment: 'processed', 'confirmed', or 'finalized' (default: 'finalized')
config.excludeNonCirculatingAccountsList	boolean	Optional. If true, excludes the list of non-circulating account addresses (default: false)

Return Object

field	type	description
context	object	RPC response context with slot information
context.slot	number	The slot at which this supply data was retrieved
value	object	Supply information object
value.total	number	Total supply in lamports
value.circulating	number	Circulating supply in lamports (total - non-circulating)
value.nonCirculating	number	Non-circulating supply in lamports
value.nonCirculatingAccounts	array	Array of account addresses holding non-circulating supply (base-58 encoded). Omitted if excludeNonCirculatingAccountsList is true

Request Example

Request

Response Example

Response

Tip: Values are in lamports (divide by 1,000,000,000 for SOL). Circulating supply is used for market cap calculations. Non-circulating includes foundation holdings, vesting schedules, and burn addresses. Set excludeNonCirculatingAccountsList to true for faster responses if you don't need the account list.