token

Supported chain families:

EVMSolanaAptosTONCanton

Query native or token balance for an address on any supported chain.

Synopsis

Bash

ccip-cli token -n <network> -H <holder> [options]

Description

The token command queries the balance of native tokens (ETH, SOL, APT, etc.) or ERC20/SPL tokens for a specified wallet address. It supports EVM, Solana, Aptos, and TON chains. Canton balance queries are not yet implemented.

Options

Required Options

Option	Alias	Type	Description
--network	-n	string	Network chain ID or name (e.g., ethereum-mainnet, solana-devnet)
--holder	-H	string	Wallet address to query balance for

Optional Options

Option	Alias	Type	Default	Description
--token	-t	string	-	Token address (omit for native token balance)

See Configuration for global options (--rpcs, --format, etc.).

Command Builder

Build your token command interactively:

ccip-cli token Builder

Query native or token balance for an address

Output Options

Control command output format

Output Format-- Select --Pretty (human-readable tables)JSON (machine-readable)Log (console.log style)

Format for command output

Verbose

Enable debug logging

RPC Configuration

Configure blockchain RPC connections

RPC URLs

List of RPC endpoint URLs (ws[s] or http[s])

RPC File

File containing RPC endpoints (reads RPC_* environment variables)

Fill in required fields to generate command

Generated Command

ccip-cli token --rpcs-file ./.env --format pretty

Output Fields

Field	Description
network	Network name
holder	Wallet address queried
token	Token symbol (e.g., "USDC") or "native"
balance	Raw balance in smallest units (wei, lamports, etc.)
formatted	Human-readable balance with decimals
symbol	Token symbol (for ERC20/SPL tokens)
name	Token name (for ERC20/SPL tokens)
decimals	Token decimal places

Examples

Query native ETH balance

Bash

ccip-cli token -n ethereum-mainnet -H 0x1234567890abcdef1234567890abcdef12345678

Query ERC20 token balance (USDC)

Bash

ccip-cli token \
  -n ethereum-mainnet \
  -H 0x1234567890abcdef1234567890abcdef12345678 \
  -t 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

Query native SOL balance on Solana

Bash

ccip-cli token -n solana-devnet -H EPUjBP3Xf76K1VKsDSc6GupBWE8uykNksCLJgXZn87CB

Query LINK token balance on Avalanche

Bash

ccip-cli token \
  -n avalanche-mainnet \
  -H 0xYourAddress \
  -t 0x5947BB275c521040051D82396192181b413227A3

Output as JSON

Bash

ccip-cli token -n ethereum-mainnet -H 0x1234... --format json

Example JSON output:

JSON

{
  "network": "ethereum-mainnet",
  "holder": "0x1234567890abcdef1234567890abcdef12345678",
  "token": "USDC",
  "balance": "1000000000",
  "formatted": "1000.0",
  "symbol": "USDC",
  "name": "USD Coin",
  "decimals": 6
}

Query in a script

Bash

# Get raw balance value
BALANCE=$(ccip-cli token -n ethereum-mainnet -H $WALLET --format json | jq -r '.balance')
echo "Balance: $BALANCE wei"

Multi-Chain Support

The token command supports all CCIP-enabled chain families:

Chain Family	Native Token	Example Network
EVM	ETH, MATIC, AVAX, etc.	ethereum-mainnet, polygon-mainnet
Solana	SOL	solana-mainnet, solana-devnet
Aptos	APT	aptos-mainnet, aptos-testnet
TON	GRAM	ton-mainnet, ton-testnet
Canton	—	Not supported (balance queries not implemented)

See Also

• get-supported-tokens - List supported CCIP tokens
• send - Send tokens cross-chain
• Configuration - RPC setup

Exit Codes

Code	Meaning
0	Success - balance retrieved
1	Error (network failure, invalid address, missing arguments)