Skip to main content
GET
/
v1
/
wallets
/
{walletId}
/
balance
Get Wallet Balance
curl --request GET \
  --url https://api.beta.getpara.com/v1/wallets/{walletId}/balance \
  --header 'X-API-Key: <api-key>'
{
  "balance": "1.5",
  "symbol": "ETH",
  "rawBalance": "1500000000000000000"
}

Authorizations

​
X-API-Key
string
header
default:sk_your_secret_key_here
required

Your partner secret key (server-side only)

Headers

​
X-Request-Id
string<uuid>

UUID for request tracing. Para returns one if omitted.

Path Parameters

​
walletId
string
required

Wallet ID

Example:

"0a1b2c3d-4e5f-6789-abcd-ef0123456789"

Query Parameters

​
chainId
string

EVM chain ID. Required for EVM wallets when rpcUrl is not provided.

Example:

"1"

​
rpcUrl
string

Custom RPC URL (URL-encoded). If provided, overrides chainId for EVM wallets.

​
tokenAddress
string

Token contract address. EVM: ERC-20 contract. Solana: SPL mint address. Omit for native balance.

​
network
enum<string>

Solana network. In production, defaults to SOLANA. In beta, only SOLANA_DEVNET is allowed (and is the default).

Available options:
SOLANA,
SOLANA_DEVNET

Response

Wallet balance

​
balance
string
required

Human-readable balance in standard units (e.g. ETH, SOL)

Example:

"1.5"

​
symbol
string
required

Token symbol (e.g. ETH, SOL, USDC) or mint/contract address for tokens without on-chain symbol

Example:

"ETH"

​
rawBalance
string
required

Balance in smallest unit (wei for ETH, lamports for SOL, raw token units for ERC-20/SPL)

Example:

"1500000000000000000"