getTokenLargestAccounts
Returns the 20 largest token accounts for an SPL Token mint.
Request
{ "jsonrpc": "2.0", "id": 1, "method": "getTokenLargestAccounts", "params": [ "3wyAj7Rt1TWVPZVteFJPLa26JmLvdb1CAKEFZm3NY75E", { "commitment": "finalized" } ]}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| pubkey | string | Yes | Pubkey of the token Mint to query, as a base-58 encoded string. |
| commitment | string | No | Desired commitment level. One of processed, confirmed, or finalized. Defaults to finalized. |
Commitment levels
| Value | Description |
|---|---|
| processed | Return data from the highest slot this node has processed on the fork it currently considers best. This is the newest view, but it can still change if the cluster switches forks. |
| confirmed | Return data from the highest slot that at least two-thirds of active stake has directly voted to confirm. More stable than processed, but a weaker guarantee than finalized. |
| finalized | Return data from the highest slot that the cluster recognizes as finalized. The slot has reached maximum vote lockout in validators' vote towers and is recognized by at least two-thirds of active stake. This is the strongest commitment level. |
Response
{ "jsonrpc": "2.0", "result": { "context": { "apiVersion": "3.1.8", "slot": 1114 }, "value": [ { "address": "FYjHNoFtSQ5uijKrZFyYAxvEr87hsKXkXcxkcmkBAf4r", "amount": "771", "decimals": 2, "uiAmount": 7.71, "uiAmountString": "7.71" }, { "address": "BnsywxTcaYeNUtzrPxQUvzAWxfzZe3ZLUJ4wMMuLESnu", "amount": "229", "decimals": 2, "uiAmount": 2.29, "uiAmountString": "2.29" } ] }, "id": 1}context
Slot and API version the node used to answer this request.
| Field | Type | Description |
|---|---|---|
| slot | u64 | Slot at which the node evaluated this request. |
| apiVersion | string | RPC API version reported by the node. This field may be omitted by older nodes. |
value
Array of up to 20 token-balance objects, sorted by descending balance. Each element combines a token-account address with the standard uiTokenAmount fields.
| Field | Type | Description |
|---|---|---|
| address | string | Token-account address, as a base-58 encoded string. |
| amount | string | Raw token balance as a base-10 integer string with no decimal point. |
| decimals | u8 | Number of decimal places configured on the mint. |
| uiAmount | number | null | Decimal-scaled token balance as a floating-point number. Deprecated — prefer uiAmountString. |
| uiAmountString | string | Decimal-scaled token balance as a string. |