Get List Of Wallet (v2)¶
Get List Of Wallet V2 returns a streamlined response optimized for performance, returning wallet-level summary data. We recommend using V2 for all new integrations.
Endpoint¶
Request¶
Query Parameters¶
| Field | Type | Description |
|---|---|---|
| b_id Optional | String | Business line ID. If empty, all wallets are returned. |
| type Optional | String | Filter by wallet storage type. If omitted, both hot and cold wallets are returned. Allowed values: HOT, COLD |
| hide_no_coin_wallet Optional | Boolean | When true, excludes wallets with zero balance from results. Default: false Allowed values: true, false |
| key_word Optional | String | Search filter. Matches against wallet name or wallet code. |
| total_market_order Optional | Integer | Sort by total USD market value. Mutually exclusive with createTimeOrder. If neither sort parameter is provided, results default to creation time descending. Allowed values: 0 (descending), 1 (ascending) |
| create_time_order Optional | Integer | Sort by wallet creation time. Mutually exclusive with totalMarketOrder. Default: 0 (descending) Allowed values: 0 (descending), 1 (ascending) |
| offset Optional | Integer | Pagination offset. Default: 0 |
| limit Optional | Integer | Number of results per page. Default: 10 |
Response¶
Response Body¶
| Field | Type | Description |
|---|---|---|
| code | Integer | Response code (0 = success) |
| message | String | Response message |
| successful | Boolean | Whether the request was successful |
| data | Object | Below shows the list of items inside the data object |
data (object)¶
| Field | Type | Description |
|---|---|---|
| offset | Integer | Pagination offset |
| limit | Integer | Pagination limit |
| total | Integer | Total number of wallets |
| list | Array | List of wallet(s) (see list array details below) |
list (array of objects)¶
Each item in list:
| Field | Type | Description |
|---|---|---|
| wallet_code | String | Wallet ID |
| wallet_name | String | Wallet name |
| wallet_type | String | Wallet type. Values: MIXED_ADDRESS, SEGREGATED_ADDRESS, DAPP_ADDRESS, DAPP_CUSTOM_ADDRESS |
| storage_type | String | Storage type. Values: PRIME_HOT, PRIME_COLD_LV1 |
| address_count | Integer | Number of addresses currently in the wallet |
| address_limit | Integer | Maximum number of addresses allowed in the wallet |
| usd_total_market | Decimal | Total market value in USD |
| usd_total_market_str | String | Total market value in USD in string format |
| create_time_stamp | Long | Wallet creation time (timestamp in milliseconds) |
| bid | String | Business line ID |
Response Example¶
{
"code": 0,
"message": "",
"successful": true,
"data": {
"offset": 0,
"limit": 2,
"list": [
{
"wallet_code": "CHSOL5020680207",
"wallet_name": "",
"wallet_type": "MIXED_ADDRESS",
"storage_type": "PRIME_HOT",
"address_count": 1,
"address_limit": 99999,
"usd_total_market": 0,
"usd_total_market_str": "0",
"create_time_stamp": 1768812797000,
"bid": "af6fcbc38b4d48cf99a23d68ed609b05"
},
{
"wallet_code": "CHSOL0074341064",
"wallet_name": "",
"wallet_type": "MIXED_ADDRESS",
"storage_type": "PRIME_HOT",
"address_count": 10,
"address_limit": 100,
"usd_total_market": 0,
"usd_total_market_str": "0",
"create_time_stamp": 1768812772000,
"bid": "91726a4a8f8a408880e55bd14688c087"
}
],
"total": 97,
"metadata": null
}
}