API Reference

Get token balances for specified addresses

posthttps://gateway-api-testnet.circle.com/v1/balances

  • Reference
  • Playground

Returns the current available balance of each specified address across different domains where that address is valid

Body parameters
sources
array of objects
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.

domain
integer

Domain to query balance from. The depositor address must be valid on the given domain.

depositor
string
Required

Address of the depositor to query balance for

token
string
Required

Token type to query balances for

Allowed valuesUSDC
Response
RequestChoose a language
ResponseChoose an example
1{
2  "token": "USDC",
3  "balances": [
4    {
5      "domain": 0,
6      "depositor": "",
7      "balance": ""
8    }
9  ]
10}
Did this page help you?
© 2023-2026 Circle Technology Services, LLC. All rights reserved.