---
title: "Latest Fungible Token Balances"
method: POST
path: "/api/v1/developer/wallet/balances"
tags: ["BALANCES", "DEVELOPER", "WALLET"]
---

# Latest Fungible Token Balances

`POST /api/v1/developer/wallet/balances`

Get the latest balances for a list of wallets.

## Query parameters

- `with_liquidity_info` boolean — If true, returns total_liquidity_usd as well. See [this page](https://docs.allium.so/api/developer/data-tips#token-liquidity-filtering) for more details.

## Request body

- PayloadAddress[] — List of wallet chain+address pairs to get balances for.
  - `chain` string, required — Lowercase chain name
  - `address` string, required — Wallet address

## Response `200`

Successful Response

- WalletLatestBalancesNewEnvelope
  - `items` union[], required — Token balance entries
    - union
      - EVMWalletBalances
        - `chain` string, required — Lowercase chain name
        - `address` string, required
        - `token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `raw_balance` integer, required — Raw balance of the token
        - `raw_balance_str` string, required — Raw balance of the token as a string
        - `block_timestamp` string, date-time, required — Block timestamp (UTC)
        - `block_number` integer, nullable — Block number
        - `block_hash` string, nullable — Block hash
      - SolanaBalances
        - `chain` string, required — Lowercase chain name
        - `address` string, required
        - `token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `raw_balance` integer, required — Raw balance of the token
        - `raw_balance_str` string, required — Raw balance of the token as a string
        - `block_timestamp` string, date-time, required — Block timestamp (UTC)
        - `block_slot` integer, required — Block slot
        - `txn_index` integer, required — Transaction index
        - `token_account` string, required
        - `block_hash` string, required — Block hash
        - `txn_id` string, required — Transaction ID
      - BitcoinBalances
        - `chain` string, required — Lowercase chain name
        - `address` string, required
        - `raw_balance` integer, required — Balance in satoshis
        - `decimals` integer, required — Token decimal places
        - `block_timestamp` string, date-time, required — Block timestamp (UTC)
      - NearWalletBalances
        - `chain` string, required — Lowercase chain name
        - `address` string, required
        - `token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `raw_balance` integer, required — Raw balance of the token
        - `block_timestamp` string, date-time, required — Block timestamp (UTC)
        - `block_height` integer, nullable — Block height
        - `block_hash` string, nullable — Block hash
        - `account_id` string, nullable — Near account ID
      - SuiWalletLatestBalances
        - `block_timestamp` string, date-time, required — Block timestamp (UTC)
        - `address` string, required
        - `chain` string, required — Lowercase chain name
        - `raw_balance` integer, required — Balance in smallest unit
        - `token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
  - `cursor` string, nullable — Pagination cursor for next page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)