Skip to main content
POST
/
v1
/
balances
Get token balances for specified addresses
curl --request POST \
  --url https://gateway-api-testnet.circle.com/v1/balances \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "USDC",
  "sources": [
    {
      "depositor": "<string>",
      "domain": 0
    }
  ]
}
'
{
  "token": "USDC",
  "balances": [
    {
      "domain": 0,
      "depositor": "<string>",
      "balance": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
token
enum<string>
required

Token type to query balances for

Available options:
USDC
​
sources
object[]
required

List of sources to query balances from. If domain is omitted from any source, the balances from all domains for that depositor will be returned.

Response

Successfully retrieved balances

Response containing token balances for specified sources

​
token
enum<string>
required

Token type that was queried

Available options:
USDC
​
balances
object[]
required

List of balance responses for each source