Пользователь и аккаунт

Просмотр в формате Markdown

Если не указано иное, следующие конечные точки могут использовать JWT или API Key подписи.

Информация о пользователях

1GET /v1/private/user/info

Поля ответов:

ПолеТипОписание
userInfo.userIdstringВнешний идентификатор пользователя
userInfo.usernamestringИмя пользователя
userInfo.agentIdint64Идентификатор агента
userInfo.vipLevelint64VIP уровень
userInfo.lastLoginAtint64Последнее время входа
userInfo.lastLoginIpstringПоследний вход IP

Пользовательские активы

1GET /v1/private/user/asset

Поля ответов:

ПолеТипОписание
userAsset.userIdstringВнешний идентификатор пользователя
userAsset.assetTypestringТип актива
userAsset.walletBalancestringБаланс кошелька
userAsset.frozenMarginstringМаржа заморожена неожиданными ордерами
userAsset.usedMarginstringМаржа по позициям

Создайте listenKey

1POST /v1/private/user/listen-key

Создаёт ключ аутентификации для приватных WebSocket потоков.

Обновить listenKey

1PUT /v1/private/user/listen-key

Расширяет listenKey валидность.

Закрыть listenKey

1DELETE /v1/private/user/listen-key

Закрывает указанный listenKey.

Журналы изменений аккаунта

1GET /v1/private/user/account-change-log?assetType=USDT&page=1&pageSize=20

Параметры запроса:

ПараметрТипОбязательноОписание
assetTypestringНетТип актива, например, USDT
changeTypestringНетТип изменения
startTimeint64НетВремя начала
endTimeint64НетКонец
pageint32НетНомер страницы, по умолчанию 1
pageSizeint32НетПункты на странице, по умолчанию 20

Поля ответов:

ПолеТипОписание
list[].assetTypestringТип актива
list[].amountstringИзменённая сумма
list[].walletBalanceBeforestringБаланс кошелька до изменения
list[].walletBalanceAfterstringБаланс кошелька после смены
list[].frozenBalanceBeforestringЗамороженный баланс до изменений
list[].frozenBalanceAfterstringЗамороженный баланс после изменения
list[].changeTypestringТип изменения
list[].referenceIdstringСвязанный бизнес-идентификатор
list[].createdAtint64Время создания
totalint64Общее количество

Статистика объёмов за 30 дней

1GET /v1/private/user/volume-stats

Поля ответов:

ПолеТипОписание
volume30dstringСовокупный объём торгов за последние 30 дней
feeTotal30dstringНакопленные комиссии за последние 30 дней

История баланса

1GET /v1/private/user/balance-history?period=1D&limit=30

Параметры запроса:

ПараметрТипОбязательноОписание
periodstringДа1D / 1W / 1M
limitintНетКоличество возвращённых товаров, по умолчанию 30

Поля ответов:

ПолеТипОписание
items[].datestringДата агрегации
items[].balancestringБаланс кошелька
items[].pnlstringРеализовал PnL за этот период

Обзор торговли

1GET /v1/private/user/trade-overview?type=1M

Параметры запроса:

ПараметрТипОбязательноОписание
typestringДаДиапазон трендов: 1D, 1W, 1M, 3M, 6M, 1Y

Поля ответов:

ПолеТипОписание
todayPnlstringСегодняшний реализованный PnL
todayVolumestringСегодняшний объём торговли по контрактам
totalVolumestringНакопленный объём торговли по контрактам
totalPnlstringКумулятивный реализованный PnL
maxDrawdown30dstringМаксимальная сумма понижения за последние 30 дней
maxDrawdown30dRatestringМаксимальный темп снижения за последние 30 дней, десятичный от 0 до 1
transferInstringНакопленные переводные средства
transferOutstringКумулятивные переводные средства
items[]arrayДанные о тенденциях активов

Обзор активов

1GET /v1/private/user/asset/overview/summary

Поля ответов совпадают с полями обзора торговли, за исключением items[].

Обзор трендов активов

1GET /v1/private/user/asset/overview/trend?type=1M

Параметры запроса:

ПараметрТипОбязательноОписание
typestringДаДиапазон трендов: 1D, 1W, 1M, 3M, 6M, 1Y

Поля ответов:

ПолеТипОписание
items[].snapshotTimeint64Время снимка
items[].balancestringБаланс текущего счета
items[].pnlstringPnL за текущий период
items[].pnlRatestringСтавка PnL за текущий период
items[].totalPnlstringКумулятивный PnL

Любимые символы

Сохранить

1POST /v1/private/user/favorite-symbols
2Content-Type: application/json

Запрос:

1{
2 "symbols": ["BTCUSDT", "ETHUSDT"]
3}

Запрос

1GET /v1/private/user/favorite-symbols

Поля ответов:

ПолеТипОписание
symbolsString[]Список любимых символов