> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soo.network/llms.txt
> Use this file to discover all available pages before exploring further.

# GetTokenSupply

## getTokenSupply RPC Method

Returns the total supply of an SPL Token type.

<div className="grid grid-cols-2 gap-1 mt-2">
  <div className="col-span-1">
    #### Parameters

    `string` **required**\
    Pubkey of the token Mint to query

    * Base-58 encoded string

    `object` **optional**\
    Configuration object containing the following fields:

    **commitment** `string` **optional**\
    The level of commitment desired when querying state
  </div>

  <div className="col-span-1">
    #### Code Sample

    ```bash theme={"system"}
    curl https://rpc.testnet.soo.network/rpc \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTokenSupply",
      "params": [
        "BESTc6u4kKPDrdAXHTKPgCm9bwBzDn2Nq9g4gk1Ld3P4",
        {
          "commitment": "finalized"
        }
      ]
    }'
    ```

    #### Response

    ```json theme={"system"}
    {
      "jsonrpc": "2.0",
      "result": {
        "context": {
          "slot": 369624
        },
        "value": {
          "amount": "1000000000",
          "decimals": 6,
          "uiAmount": 1000.0,
          "uiAmountString": "1000.0"
        }
      },
      "id": 1
    }
    ```
  </div>
</div>

#### Result Details

The result is an RpcResponse JSON object with `value` containing:

* `amount: <string>`
  * Raw total token supply without decimals
  * String representation of u64 integer
  * Represents the absolute number of tokens

* `decimals: <u8>`
  * Number of decimal places for the token
  * Determines how the raw amount should be displayed

* `uiAmount: <number|null>` **DEPRECATED**
  * Total token supply using mint-prescribed decimals
  * Will be removed in future versions

* `uiAmountString: <string>`
  * Total token supply as a string
  * Formatted using mint-prescribed decimal places

#### Important Notes

* Provides comprehensive information about token supply
* Includes both raw and user-friendly token supply representations
* Decimals help in correct token amount interpretation
