getSupply

POSTStaking & InflationBlade Runner+

Returns total and circulating SOL supply, plus the list of non-circulating accounts.

Try itSends a real request from your browser to the selected region.
POST
/

getSupply returns total token supply split into circulating and non-circulating lamports, plus, by default, the full list of accounts classified as non-circulating (such as unvested foundation or team allocations).

Building the non-circulating account list walks a sizeable set of known accounts on every call, so constant-k rate-limits this endpoint more tightly than similar calls like getBalance.

Plans & rate limitsBlade Runner and above
FreeNot included
OperatorNot included
Blade Runner2/s
Nexus5/s

Parameters

params is a JSON array, with values in this order: config.

1configobject

Optional configuration.

Show propertiesProperties
commitmentstringdefault: "finalized"

Bank state to compute supply from.

Allowed values:finalizedconfirmedprocessed
excludeNonCirculatingAccountsListbooleandefault: false

When true, omits the nonCirculatingAccounts array from the response, the bulk of the response payload when included; the totals are still returned either way.

Result

resultobject

Supply totals wrapped with context.

Show propertiesProperties
contextobjectrequired
Show propertiesProperties
slotinteger
apiVersionstring
valueobjectrequired
Show propertiesProperties
totalintegerrequired

Total SOL supply, in lamports.

circulatingintegerrequired

Circulating SOL supply, in lamports.

nonCirculatingintegerrequired

Non-circulating SOL supply, in lamports.

nonCirculatingAccountsstring[]required

Base-58 addresses classified as non-circulating. Omitted/empty when excludeNonCirculatingAccountsList is true.

Notes

  • excludeNonCirculatingAccountsList: true omits the expensive address list from the response without changing the totals.
  • Available on Blade Runner and Nexus only.