---
title: getTokenAccountBalance
hideTableOfContents: true
h1: getTokenAccountBalance RPC Method
---

Returns the token balance of an SPL Token account.

<DocSideBySide>

<DocLeftSide>

### Parameters

<Parameter type={"string"} required={true}>
  Pubkey of Token account to query, as base-58 encoded string
</Parameter>

<Parameter type={"object"} optional={true}>

Configuration object containing the following fields:

<Field
  name="commitment"
  type="string"
  optional={true}
  href="/docs/rpc/index.mdx#configuring-state-commitment"
/>

</Parameter>

### Result

The result will be an RpcResponse JSON object with `value` equal to a JSON
object containing:

- `amount: <string>` - the raw balance without decimals, a string representation
  of u64
- `decimals: <u8>` - number of base 10 digits to the right of the decimal place
- `uiAmount: <number|null>` - the balance, using mint-prescribed decimals
  **DEPRECATED**
- `uiAmountString: <string>` - the balance as a string, using mint-prescribed
  decimals

For more details on returned data, the
[Token Balances Structure](/docs/rpc/json-structures#token-balances) response
from [getBlock](/docs/rpc/http/getblock) follows a similar structure.

</DocLeftSide>

<DocRightSide>

### Code sample

```shell
curl https://api.devnet.solana.com -s -X POST -H "Content-Type: application/json" -d '
  {
    "jsonrpc": "2.0", "id": 1,
    "method": "getTokenAccountBalance",
    "params": [
      "7fUAJdStEuGbc3sM84cKRL6yYaaSstyLSU4ve5oovLS7"
    ]
  }
'
```

### Response

```json
{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 1114
    },
    "value": {
      "amount": "9864",
      "decimals": 2,
      "uiAmount": 98.64,
      "uiAmountString": "98.64"
    }
  },
  "id": 1
}
```

</DocRightSide>
</DocSideBySide>
