Користувач і обліковий запис

View as 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 валідність.

Close 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[]Список улюблених символів