Utente e Account

Visualizza come Markdown

Salvo diversa specificazione, i seguenti endpoint possono utilizzare JWT o API Key firming.

Informazioni utente

1GET /v1/private/user/info

Campi di risposta:

CampoTipoDescrizione
userInfo.userIdstringID utente esterno
userInfo.usernamestringNome utente
userInfo.agentIdint64ID agente
userInfo.vipLevelint64VIP livello
userInfo.lastLoginAtint64Ultimo tempo di accesso
userInfo.lastLoginIpstringUltimo accesso IP

Risorse utente

1GET /v1/private/user/asset

Campi di risposta:

CampoTipoDescrizione
userAsset.userIdstringID utente esterno
userAsset.assetTypestringTipo di asset
userAsset.walletBalancestringBilanciamento portafoglio
userAsset.frozenMarginstringMargine congelato da ordini in sospeso
userAsset.usedMarginstringMargine utilizzato dalle posizioni

Crea listenKey

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

Crea una chiave di autenticazione per flussi privati WebSocket .

Rinnovare listenKey

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

Estende listenKey validità.

Close listenKey

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

Chiude il listenKeyspecificato.

Registro delle modifiche degli account

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
assetTypestringNoTipo di asset, come USDT
changeTypestringNoCambio di tipo
startTimeint64NoOrario di inizio
endTimeint64NoFine dei tempi
pageint32NoNumero di pagina, 1 predefinito
pageSizeint32NoElementi per pagina, 20 predefinita

Campi di risposta:

CampoTipoDescrizione
list[].assetTypestringTipo di asset
list[].amountstringImporto modificato
list[].walletBalanceBeforestringSaldo del portafoglio prima del cambio
list[].walletBalanceAfterstringSaldo del portafoglio dopo il cambio
list[].frozenBalanceBeforestringSaldo congelato prima del cambiamento
list[].frozenBalanceAfterstringSaldo congelato dopo il cambio
list[].changeTypestringCambio di tipo
list[].referenceIdstringID aziendale correlato
list[].createdAtint64Tempo di creazione
totalint64Conteggio totale

Statistiche del volume a 30 giorni

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

Campi di risposta:

CampoTipoDescrizione
volume30dstringVolume cumulativo di trading negli ultimi 30 giorni
feeTotal30dstringTariffe cumulative negli ultimi 30 giorni

Storia del bilanciamento

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
periodstring1D / 1W / 1M
limitintNoNumero di oggetti restituiti, predefinito 30

Campi di risposta:

CampoTipoDescrizione
items[].datestringData di aggregazione
items[].balancestringBilanciamento portafoglio
items[].pnlstringPnL realizzato per il periodo

Panoramica del settore

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
typestringIntervallo di tendenza: 1D, 1W, 1M, 3M, 6M 1Y

Campi di risposta:

CampoTipoDescrizione
todayPnlstringIl PnL realizzato di oggi
todayVolumestringVolume di contratti di oggi
totalVolumestringVolume cumulativo di contratti
totalPnlstringPnL realizzato cumulativo
maxDrawdown30dstringImporto massimo di ritiro negli ultimi 30 giorni
maxDrawdown30dRatestringTasso massimo di riduzione degli ultimi 30 giorni, decimale da 0 a 1
transferInstringFondi trasferiti cumulativi
transferOutstringFondi trasferiti cumulativi
items[]arrayDati sulle tendenze degli asset

Riepilogo dell’Asset

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

I campi di risposta sono gli stessi dei campi di riepilogo della panoramica commerciale, escludendo items[].

Tendenza panoramica degli asset

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

Parametri della richiesta:

ParametroTipoRichiestoDescrizione
typestringIntervallo di tendenza: 1D, 1W, 1M, 3M, 6M 1Y

Campi di risposta:

CampoTipoDescrizione
items[].snapshotTimeint64Tempo di istantanea
items[].balancestringSaldo del conto corrente
items[].pnlstringPnL per il periodo attuale
items[].pnlRatestringTasso PnL per il periodo corrente
items[].totalPnlstringPnL cumulativo

Simboli preferiti

Salva

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

Corpo della richiesta:

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

Query

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

Campi di risposta:

CampoTipoDescrizione
symbolsstring[]Elenco dei simboli preferiti