Get a wallet's balance

Returns a wallet’s current USDC balance, read live from the chain rather than summed from deposits Minisend has recorded. The chain is always the source of truth, so this figure can never drift from what’s actually there.

This only reports the balance on the chain the wallet was issued on. Because an address is identical across every EVM chain, a wallet issued on Base can still receive funds on Polygon or another chain — those funds exist, but this endpoint won’t show them. The wallet.deposit.received webhook and the deposit endpoints report the chain a transfer actually landed on; use those to know about activity on chains other than the one you issued.

Endpoint

GET https://merchant.minisend.xyz/api/v1/wallets/{walletId}/balance

Authorization: Bearer wsk_live_your_key_here

Example

curl https://merchant.minisend.xyz/api/v1/wallets/3f6b2e1a-.../balance \
  -H "Authorization: Bearer wsk_live_your_key_here"

Response (200)

{
  "wallet_id": "3f6b2e1a-...",
  "wallet_ref": "user-9214",
  "address": "0xabc1230000000000000000000000000000dead",
  "chain": "BASE",
  "token": "USDC",
  "amount": "10.500000"
}

string

required

The chain this balance covers — always the wallet’s issued chain.

string

required

A string, not a number. Compare and store it as a decimal.

Errors

Status	Meaning
`401`	Missing or invalid API key
`404`	Unknown wallet, or it belongs to another account
`502`	The balance couldn’t be read right now. Retry

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Get a wallet's balance

Endpoint

Example

Response (200)

Errors

​Endpoint

​Example

​Response (200)

​Errors

Endpoint

Example

Response (200)

Errors