SDK Explorer

Retrieves a list of all wallets that fit the specified parameters, including native balances and USDC/EURC token balances if specified.

NOTE: Balances update automatically with transfers or via the Get token balance for a wallet for accuracy.

Parameters
input
object
Required

Represents the input for listing wallets.

address
string

The address of the wallet to filter by.

amountGte
string

Filters wallets where the balance is greater than or equal to the specified amount. Applies to the specified token if tokenAddress is provided; otherwise, to the native token.

blockchain
string
Required

The blockchain network that the resource is to be created on or is currently on.

Allowed valuesARBARB-SEPOLIAAVAXAVAX-FUJIBASEBASE-SEPOLIAETHETH-SEPOLIAEVMEVM-TESTNETMATICMATIC-AMOYNEARNEAR-TESTNETOPOP-SEPOLIASOLSOL-DEVNETUNIUNI-SEPOLIA
refId
string

Reference or description used to identify the wallet.

tokenAddress
string

Blockchain address of the transferred token. Empty for native tokens.

walletSetId
string

The ID of the wallet set to filter by.

xRequestId
string

Developer-provided parameter used to identify this request.

from
string

Start time of the query, inclusive.

pageAfter
string

Used to return items after the specified item exclusively. SHOULD NOT be used in conjunction with pageBefore.

pageBefore
string

Used to return items before the specified item exclusively. SHOULD NOT be used in conjunction with pageAfter.

pageSize
number

The number of items to return.

to
string

End time of the query, inclusive. Defaults to the current time.

Responses
Example
1const response = await client.getWalletsWithBalances({
2 blockchain: 'ETH-SEPOLIA',
3 amountGte: '1',
4})
5console.log(response.data?.wallets)
ResponseChoose an example
1{
2  "data": {
3    "wallets": [
4      {
5        "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
6        "address": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
7        "blockchain": "MATIC-AMOY",
8        "createDate": "2023-01-01T12:04:05Z",
9        "updateDate": "2023-01-01T12:04:05Z",
10        "custodyType": "DEVELOPER",
11        "name": "",
12        "refId": "custom_ref_id",
13        "state": "LIVE",
14        "userId": "ext_user_id_1",
15        "walletSetId": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
16        "initialPublicKey": "3eQoJ3ex6uWX3R8F1THF6Y6oBQwPYpF1X9HBM1gjqw7w",
17        "accountType": "EOA",
18        "tokenBalances": [
19          {
20            "amount": "6.62607015",
21            "token": {
22              "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
23              "name": "",
24              "standard": "ERC20",
25              "blockchain": "MATIC-AMOY",
26              "decimals": 0,
27              "isNative": false,
28              "symbol": "",
29              "tokenAddress": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
30              "updateDate": "2023-01-01T12:04:05Z",
31              "createDate": "2023-01-01T12:04:05Z"
32            },
33            "updateDate": "2023-01-01T12:04:05Z"
34          }
35        ]
36      }
37    ]
38  }
39}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.