Добавить кошелек контрагента

Позволяет добавить новый кошелек клиенту/контрагенту. Можно создавать основной кошелек или субсчет (sub-wallet) под уже существующую валюту и сеть.

POST/v1/clients/:uuid/wallets

Headers

Example of x-api-key

74364121-2fb8-4e06-b093-7b1f83f0d5a8

Please note: the x-api-key is unique and provided to each client individually by Monocrypt.

---

Path Parameters 📌

Parameter	Type	Description
uuid	string	Уникальный идентификатор клиента.

---

Body Parameters 📝

Field	Type	Description
currency	string	Валюта кошелька (например, USDT).
network	string	Сеть, к которой привязан кошелек (например, TRC20).
name	string	Имя кошелька. Можно использовать для внутренней маркировки: торговые аккаунты, имена клиентов, услуги и т.д. 🔑
isSubWallet	boolean	true,если создаем субсчет, false для основного кошелька.

💡 Важно: для создания субсчета должен существовать основной кошелек той же валюты и сети.

---

Пример тела запроса 📝

{
  "currency": "USDT",
  "network": "TRC20",
  "name": "name1",
  "isSubWallet": true
}

---

Важно ⚠️

1. Субсчет (isSubWallet: true) можно создать только если уже существует основной кошелек (isSubWallet: false) для этой валюты и сети.

2. Имя кошелька (name) играет ключевую роль – его можно использовать для внутренней маркировки в вашей CRM: торговые аккаунты, клиенты, услуги и т.д.

3. Можно создавать несколько субсчетов одной валюты и сети, чтобы разделять операции внутри одного клиента.

---

Response

200 OK

{
    "currency": "TRX",
    "network": "TRC20",
    "subId": 3,
    "name": "test",
    "client": {
        "id": 35,
        "createdAt": "2024-12-06T14:11:02.675Z",
        "updatedAt": "2024-12-09T09:16:03.190Z",
        "clientId": 35,
        "uuid": "f44c3c11-f5ff-4d18-b735-d81afa1d5df3",
        "email": "[email protected]",
        "name": "PLbedbedeebecffa",
        "rootUnitId": 6,
        "unitId": 4,
        "isExternalParam": false,
        "wallets": [
            {
                "id": 189,
                "createdAt": "2024-12-06T14:11:02.994Z",
                "updatedAt": "2025-07-08T12:54:20.094Z",
                "subId": null,
                "clientId": 35,
                "unitId": null,
                "invoiceId": null,
                "name": "PL-b9e0db4e-908d-4e3e-8b37-13317ec5ffa8",
                "currency": "TRX",
                "network": "TRC20",
                "balance": "0",
                "transit_balance": "0",
                "service_fee_balance": "0",
                "walletAddress": "TTJW3idzSZ47DEdkamNXnPd1EDbfZvsSNh",
                "riskScore": 0,
                "total_deposits": "12000000"
            },
        ],
        "labels": []
    },
    "walletAddress": "TWHhjRSKBuwaVHsS9onDiC8tyEdfEGNYzS",
    "clientId": 35,
    "unitId": null,
    "invoiceId": null,
    "id": 2672,
    "createdAt": "2025-11-03T14:22:16.901Z",
    "updatedAt": "2025-11-03T14:22:16.901Z",
    "balance": "0",
    "transit_balance": "0",
    "service_fee_balance": "0",
    "riskScore": 0,
    "total_deposits": "0"
}

400 BadRequest