TriportRPC
DashboardDocs

getTokenLargestAccounts

Last updated:

`getTokenLargestAccounts` returns the up-to-20 largest **token accounts** for a given SPL Token mint, ranked by balance in descending order. Each entry reports the token account `address`, the raw integer `amount`, the mint's `decimals`, and the human-readable `uiAmount` / `uiAmountString` already scaled by those decimals. Use it to surface a token's top holders, estimate holder concentration, or locate large liquidity / treasury accounts for a mint.

The `mint` you pass must be the address of the **token mint** — not a wallet and not an individual token account. The method returns holdings *of that mint* across the largest accounts; it does not enumerate the accounts owned by a wallet. To go from a wallet to its token accounts instead, use `getTokenAccountsByOwner`.

Results are reported relative to a particular slot, returned in the `context` object. Use the optional `commitment` config to control how finalized that slot must be, and `minContextSlot` to require the node has reached at least a given slot before serving the request. The list is capped at 20 entries and cannot be paginated — it always reflects the largest accounts at the queried slot.

Parameters

getTokenLargestAccounts parameters
NameTypeRequiredDescription
mintPubkeyYes
configCommitmentConfigNo

Returns

getTokenLargestAccounts return value
FieldType
resultobject

Examples

curl https://<your-endpoint>/ \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"getTokenLargestAccounts","params":["<mint>","<config>"]}'
const res = await fetch("https://<your-endpoint>/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "id": 1,
  "method": "getTokenLargestAccounts",
  "params": [
    "<mint>",
    "<config>"
  ],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"getTokenLargestAccounts","params":["<mint>","<config>"],"jsonrpc":"2.0"})
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet, devnet, testnet.
  3. Credit cost: 1 per call.

FAQ

What does getTokenLargestAccounts do?
Returns the 20 largest accounts holding a particular SPL Token mint.
How many credits does getTokenLargestAccounts cost?
getTokenLargestAccounts costs 1 credit(s) per call on Triport by default.
Is getTokenLargestAccounts available over WebSocket?
getTokenLargestAccounts is an HTTP JSON-RPC method.