List Withdrawals
GET
/api/v1/wallets/{type}
/api/v1/wallets/{type}?customerId={customerId}| Field | Type | Description |
|---|---|---|
type | string | Operation type — deposit or withdraw |
| Field | Type | Description |
|---|---|---|
customerId | string (uuid) | Unique identifier of the customer whose assets you want — required |
| Field | Values | Meaning |
|---|---|---|
accountStatus | Active | Asset account is usable for withdrawals |
kycState | Approved | Customer KYC is verified for this asset |
| Field | Type | Description |
|---|---|---|
data.totalInBaseAmount | number | Total balance across all wallets in base currency (USD) |
data.wallets[].name | string | Wallet display name (e.g. USDT) |
data.wallets[].totalBalanceInUsd | number | Wallet balance in USD |
data.wallets[].assets[].name | string | Asset name (e.g. Tether) |
data.wallets[].assets[].code | string | Currency ticker (e.g. USDT) |
data.wallets[].assets[].coinCode | string | Currency + network code (e.g. USDT-TRC20) |
data.wallets[].assets[].image | string | Asset icon/image URL, if set |
data.wallets[].assets[].amount | number | Asset balance |
data.wallets[].assets[].amountInBase | number | Asset balance in base currency |
data.wallets[].assets[].minLimit | number | Minimum withdrawal amount |
data.wallets[].assets[].maxLimit | number | Maximum withdrawal amount |
data.wallets[].assets[].accountStatus | string | Asset account status |
data.wallets[].assets[].kycState | string | Customer KYC state for this asset |
data.wallets[].assets[].actionType | string | Action type this asset entry applies to |
data.wallets[].assets[].note | string | Additional note, if any |
data.wallets[].assets[].remarks | string | Additional remarks, if any |
data.wallets[].assets[].accountCreationFee | number | Fee charged to create this asset account, if applicable |
data.wallets[].assets[].providerStatus | string | Underlying provider's account status, if applicable |
data.wallets[].assets[].providerRemarks | string | Underlying provider's remarks, if any |
data.wallets[].assets[].isCustomerCreated | boolean | Whether the customer created this asset account themselves |
data.wallets[].assets[].paymentSubState | boolean | Payment sub-state flag, if applicable |
data.wallets[].assets[].bankStatus | string | Bank account status, if this asset is bank-linked |
data.wallets[].assets[].customerHolderStatus | string | Customer's holder status for this asset, if applicable |
requestId | string | Unique identifier of this API request |
timestamp | string (date-time) | Server timestamp of the response (UTC) |
minLimit/maxLimit/totalInBaseAmount are omitted from the JSON entirely when null (server uses Newtonsoft NullValueHandling.Ignore) — several of the asset-level fields above (e.g. bankStatus, paymentSubState, customerHolderStatus, providerStatus, providerRemarks) are shared with fiat/bank asset listings and are not expected to be populated for crypto withdrawals specifically.Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/wallets/?CustomerId=' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'Response Response Example
{
"data": {
"totalInBaseAmount": 1250.75,
"wallets": [
{
"name": "USDT",
"totalBalanceInUsd": 1250.75,
"assets": [
{
"name": "Tether USD",
"code": "USDT",
"coinCode": "USDT-TRC20",
"amount": 1250.75,
"amountInBase": 1250.75,
"actionType": "WITHDRAWCRYPTO",
"accountStatus": "Active",
"kycState": "Approved",
"minLimit": 10.0,
"maxLimit": 50000.0
}
]
}
]
},
"requestId": "d4a0f7c31e8b45629af1c5e7b0d38264",
"timestamp": "2026-08-21T10:03:11.2277409Z"
}Modified at 2026-08-22 09:38:35