Mainly

Get a token

Metadata, supply, and price for any token mint.

GET /tokens/{mint}

Parameters

ParameterInTypeRequiredDescription
mintpathstringYesThe token's mint address.

Example

curl https://api.sarg.am/v1/solana/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  -H "Authorization: Bearer $MAINLY_API_KEY"
{
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "name": "USD Coin",
  "symbol": "USDC",
  "logo": "https://cdn.mainly.dev/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.png",
  "decimals": 6,
  "tokenProgram": "spl-token",
  "supply": {
    "raw": "8942337421000000",
    "ui": 8942337421.0,
    "uiString": "8942337421"
  },
  "price": {
    "usdPerToken": 1.0,
    "updatedAt": "2026-08-04T09:35:00Z"
  },
  "authorities": {
    "mint": "2wmVCSfPxGPjrnMMn7rchp4uaeoTqN39mXFC2zhPdri9",
    "freeze": "3sNBr7kMccME5D55xNgsmYpZnzPgP2g12CixAajXypn6"
  }
}

Response fields

FieldTypeDescription
name / symbol / logostring | nullMetadata. null when unpublished.
decimalsnumberDecimal places — needed to interpret any raw amount of this token.
tokenProgramstringspl-token or token-2022.
supplyobjectCurrent total supply.
priceobject | nullUSD price with its freshness timestamp. null without verified market data.
authoritiesobjectmint and freeze authority addresses, or null when revoked. Both null is a good sign — nobody can inflate the supply or freeze holders.

Errors

codeWhen
invalid_addressThe path parameter isn't valid base58.
not_foundThe address exists but isn't a token mint.

Under the hood

Replaces getTokenSupply, a metadata lookup, mint-account decoding for the authorities, and a price feed.

On this page