Create Wallet
POST
/api/v1/wallets/createWallet
walletId and on-chain deposit walletAddress immediately. No separate lookup is required to get the deposit address; the same details can also be retrieved later via List Wallets or Get Wallet.currency + network combination must be one returned by GET /api/v1/wallets/supportedCurrencies.customerId must already exist.| Field | Type | Description | Constraints |
|---|---|---|---|
customerId | string (uuid) | Customer the wallet belongs to. Must not be an empty GUID. | - |
currency | string | Currency ticker for the wallet (e.g. USDT) | Min: 2 · Max: 20 · Pattern: ^[A-Za-z0-9_-]+$ |
network | string | Blockchain network for the wallet (e.g. TRC-20) | Min: 2 · Max: 20 · Pattern: ^[A-Za-z0-9_-]+$ |
| Field | Type | Description |
|---|---|---|
data.walletId | string (uuid) | Wallet identifier — use it to call Get Wallet |
data.walletAddress | string | On-chain deposit address provisioned for this wallet |
requestId | string | Unique identifier of this API request |
timestamp | string (date-time) | Server timestamp of the response (UTC) |
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/wallets/createWallet' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
"customerId": "f9218ba2-d6f9-4166-8eb2-884300f0545d",
"currency": "USDT",
"network": "TRC-20"
}'Response Response Example
201 - Success
{
"data": {
"walletId": "6b1d4c90-8a53-4f21-9c77-5d1e2f3a4b60",
"walletAddress": "TWFgpZGWq85xkGmUS8guHsuXQhkCqedfsj"
},
"requestId": "9f2c1a77d5f04a1b8e3c0b6d2f5a4e91",
"timestamp": "2026-08-21T09:41:12.4471203Z"
}Modified at 2026-08-22 09:32:04