How to Get Solana SPL Tokens: Complete API Guide

Overview

This guide covers reading fungible tokens on Solana: account balances, token accounts by owner or mint, total supply, largest holders, and the DAS fungible token extension. Helius exposes both standard Solana RPC token methods and DAS methods that add metadata and USD prices. For NFTs, compressed NFTs, editions, and proofs, see the Get Assets guide. This page focuses on fungible (SPL and Token-2022) tokens.

When to use this

Use the methods on this page when you are:

Reading the balance of a single token account
Listing every token account a wallet holds
Finding all accounts that hold a specific mint
Checking a token’s total supply or its largest holders
Fetching token metadata and USD price alongside balances

Token account balance

Get the balance for a specific token account using standard RPC:

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountBalance',
    params: [
      '3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa'
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenAccountBalance

Token accounts by owner

List all token accounts owned by a wallet:

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountsByOwner',
    params: [
      '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
      {
        programId: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'
      },
      {
        encoding: 'jsonParsed'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenAccountsByOwner

Token accounts by mint

List all accounts holding a specific token:

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenAccountsByOwner',
    params: [
      'CEXq1uy9y15PL2Wb4vDQwQfcJakBGjaAjeuR2nKLj8dk',
      {
        mint: "8wXtPeU6557ETkp9WHFY1n1EcU6NxDvbAggHGsMYiHsB"
      },
      {
        encoding: 'jsonParsed'
      }
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenAccountsByOwner

To find every account holding a mint across all owners (not just one owner), use the DAS getTokenAccounts method described below.

Token supply

Check the total supply of a token:

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenSupply',
    params: [
      'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenSupply

Largest token holders

Identify the largest accounts holding a token:

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getTokenLargestAccounts',
    params: [
      'he1iusmfkpAdwvxLNGV8Y1iSbj4rUy6yMhEA3fotn9A'
    ]
  })
});
const data = await response.json();
console.log(data);

API Reference

getTokenLargestAccounts

Returns up to the 20 largest accounts for the mint:

{
  "context": { "slot": 0 },
  "value": [
    { "address": "...", "amount": "1000000000000", "decimals": 9, "uiAmount": 1000.0, "uiAmountString": "1000" }
  ]
}

Token accounts with the DAS API

The DAS getTokenAccounts method returns token accounts by mint or owner, including balances, in a single paginated call. Unlike getTokenAccountsByOwner, you can query by mint alone to list every account holding a token across all owners.

const url = `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`;

const getTokenAccounts = async (params) => {
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: "my-request-id",
      method: "getTokenAccounts",
      params: params,
    }),
  });

  const { result } = await response.json();
  return result;
};

// Example: Get all accounts holding a specific token
getTokenAccounts({
  mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", // USDC
  page: 1,
  limit: 100
});

API Reference

getTokenAccounts

Paginated; each entry includes the account, mint, owner, and balance:

{
  "total": 100,
  "limit": 100,
  "page": 1,
  "token_accounts": [
    { "address": "...", "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "owner": "...", "amount": 12345678 }
  ]
}

Token metadata and price with the DAS API

For token metadata and USD price, call the DAS getAsset method with showFungible enabled. Prices for verified tokens are returned under token_info.price_info.

Price data from getAsset is cached for up to 600 seconds, so it can be up to 10 minutes old.

const response = await fetch("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY", {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: {
      id: 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263', // Bonk
      options: {
        showFungible: true
      }
    }
  })
});
const { result } = await response.json();
console.log(result.token_info.price_info);

API Reference

getAsset

The response returns supply, decimals, and price under token_info:

{
  "token_info": {
    "symbol": "Bonk",
    "supply": 8881594973561640000,
    "decimals": 5,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "price_info": {
      "price_per_token": 0.0000192271,
      "currency": "USDC"
    }
  }
}

Calculate market cap

Multiply the price by the decimal-adjusted supply:

const { price_per_token } = result.token_info.price_info;
const { supply, decimals } = result.token_info;
const marketCap = (supply / Math.pow(10, decimals)) * price_per_token;

To list every fungible token in a wallet (with balances and prices) in one call, use getAssetsByOwner or searchAssets with tokenType: "fungible". See the fungible token extension for how tokenType, balances, Token-2022 extensions, and price data appear in the response.

Best practices

Use pagination for methods that return large result sets. See the Pagination guide.
Prefer DAS methods (getAsset, getAssetsByOwner, getTokenAccounts) when you need metadata or USD prices; use standard RPC methods for raw on-chain balances and supply.
Handle errors gracefully with try/catch blocks and retries.
Cache responses when appropriate to reduce API calls.

Next steps

Fungible Token Extension

How DAS returns fungible tokens, Token-2022 extensions, and prices.

Get Assets (NFTs)

Retrieve NFTs, compressed NFTs, editions, and proofs.

DAS API reference

Full schemas for every DAS method.

Get Started

Data Streaming & Event Listening

Data APIs & RPCs

Trading

Sending Transactions

Wallet-as-a-Service

Guides

Resources

How to Get Solana SPL Tokens: Complete API Guide

Overview

When to use this

Token account balance

API Reference

Token accounts by owner

API Reference

Token accounts by mint

API Reference

Token supply

API Reference

Largest token holders

API Reference

Token accounts with the DAS API

API Reference

Token metadata and price with the DAS API

API Reference

Calculate market cap

Best practices

Next steps

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

​Overview

​When to use this

​Token account balance

API Reference

​Token accounts by owner

API Reference

​Token accounts by mint

API Reference

​Token supply

API Reference

​Largest token holders

API Reference

​Token accounts with the DAS API

API Reference

​Token metadata and price with the DAS API

API Reference

​Calculate market cap

​Best practices

​Next steps

Fungible Token Extension

Get Assets (NFTs)

DAS API reference

Overview

When to use this

Token account balance

Token accounts by owner

Token accounts by mint

Token supply

Largest token holders

Token accounts with the DAS API

Token metadata and price with the DAS API

Calculate market cap

Best practices

Next steps