Обновление API: изменения в эндпоинте CSA

В рамках развития платформы мы обновляем эндпоинт GET /api/v1/user/csa. Теперь он будет возвращать все активные займы CSA, привязанные к аккаунту, вместо прежнего ответа, содержащего только одну запись.

Дата и время вступления в силу: 11 июня 2026 года, 06:00 UTC

Что изменится?

Ранее эндпоинт GET /api/v1/user/csa возвращал один объект или статус 204 No Content. Теперь он всегда будет возвращать статус 200 OK и объект-обертку, содержащий массив. Ниже приведен пример изменений в ответе API:

До

{   "csaID": "4e0ff949-7b31-1a85-a41c-6461d7d8197d",   "currency": "USDT",   "csaStatus": "New",   ... }

После

{   "csas": [     {       "csaID": "4e0ff949-7b31-1a85-a41c-6461d7d8197d",       "currency": "USDT",       "csaStatus": "New",       ...     },     {       "csaID": "d2877e04-7004-d1b7-4e28-41f798ed5961",       "currency": "XBt",       "csaStatus": "New",       ...     }   ] }

Обработка пустых ответов

Если у аккаунта нет активных займов CSA, эндпоинт вернет статус 200 OK с пустым массивом вместо 204 No Content:

{ "csas": [] }

Несколько займов CSA на один аккаунт

Если на аккаунте открыто несколько активных займов CSA (по одному на каждую валюту обеспечения), эндпоинт теперь вернет их все.

Статусы займов CSA

Поле csaStatus теперь будет отражать полный жизненный цикл займа. Отмененные (Canceled) и отклоненные (Rejected) займы исключаются из ответа. Все остальные поля (csaID, account, currency, amount, mmRatioMarginCall, maintMarginRatio и т. д.) остаются без изменений. Возможные значения:

Необходимые действия

Пользователям эндпоинта GET /api/v1/user/csa необходимо:

• Читать response.csas как массив, а не обращаться напрямую к корню ответа

• Обрабатывать статус 200 с csas: [] вместо 204

• Если у вас открыт займ CSA только в одной валюте, используйте csas[0] для сохранения прежней логики работы

• Если у вас открыто несколько займов CSA, итерируйте по всем записям массива