Usuario y cuenta

Ver como Markdown

Salvo que se especifique lo contrario, los siguientes puntos finales pueden usar JWT o API Key firma.

Información de usuario

1GET /v1/private/user/info

Campos de respuesta:

CampoTipoDescripción
userInfo.userIdstringID de usuario externo
userInfo.usernamestringNombre de usuario
userInfo.agentIdint64ID de agente
userInfo.vipLevelint64VIP nivel
userInfo.lastLoginAtint64Última hora de inicio de sesión
userInfo.lastLoginIpstringÚltimo inicio de sesión IP

Activos de usuario

1GET /v1/private/user/asset

Campos de respuesta:

CampoTipoDescripción
userAsset.userIdstringID de usuario externo
userAsset.assetTypestringTipo de activo
userAsset.walletBalancestringSaldo de la cartera
userAsset.frozenMarginstringMargen congelado por pedidos pendientes
userAsset.usedMarginstringMargen utilizado por posiciones

Crea listenKey

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

Crea una clave de autenticación para flujos de WebSocket privados.

Renovar listenKey

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

Extiende listenKey validez.

Cierra listenKey

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

Cierra la listenKeyespecificada.

Registros de cambios de cuenta

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
assetTypestringNoTipo de activo, como USDT
changeTypestringNoCambio de tipo
startTimeint64NoHora de inicio
endTimeint64NoFin del tiempo
pageint32NoNúmero de página, 1 por defecto
pageSizeint32NoElementos por página, por defecto 20

Campos de respuesta:

CampoTipoDescripción
list[].assetTypestringTipo de activo
list[].amountstringCantidad modificada
list[].walletBalanceBeforestringSaldo de la cartera antes del cambio
list[].walletBalanceAfterstringSaldo de la cartera tras el cambio
list[].frozenBalanceBeforestringSaldo congelado antes del cambio
list[].frozenBalanceAfterstringSaldo congelado tras el cambio
list[].changeTypestringCambio de tipo
list[].referenceIdstringIdentificador empresarial relacionado
list[].createdAtint64Época de creación
totalint64Recuento total

Estadísticas de volumen a 30 días

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

Campos de respuesta:

CampoTipoDescripción
volume30dstringVolumen acumulado de operaciones en los últimos 30 días
feeTotal30dstringComisiones acumuladas en los últimos 30 días

Historial de la balanza

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
periodstring1D / 1W / 1M
limitintNoNúmero de elementos devueltos, 30 por defecto

Campos de respuesta:

CampoTipoDescripción
items[].datestringFecha de agregación
items[].balancestringSaldo de la cartera
items[].pnlstringPnL realizado para ese periodo

Resumen del comercio

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
typestringRango de tendencias: 1D, 1W, 1M, 3M, 6M 1Y

Campos de respuesta:

CampoTipoDescripción
todayPnlstringEl PnL realizado hoy
todayVolumestringVolumen de negociación de contratos hoy
totalVolumestringVolumen acumulativo de operaciones de contratos
totalPnlstringPnL acumulado realizado
maxDrawdown30dstringCantidad máxima de reducción en los últimos 30 días
maxDrawdown30dRatestringTasa máxima de reducción en los últimos 30 días, decimal de 0 a 1
transferInstringFondos transferidos acumulados
transferOutstringFondos transferidos acumulados
items[]arrayDatos de tendencias de activos

Resumen de los activos

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

Los campos de respuesta son los mismos que los campos de resumen de la visión de la Visión, excluyendo items[].

Tendencia de visión general de activos

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

Parámetros de la solicitud:

ParámetroTipoObligatorioDescripción
typestringRango de tendencias: 1D, 1W, 1M, 3M, 6M 1Y

Campos de respuesta:

CampoTipoDescripción
items[].snapshotTimeint64Tiempo de instantánea
items[].balancestringSaldo de la cuenta corriente
items[].pnlstringPnL para el periodo actual
items[].pnlRatestringTasa PnL para el periodo actual
items[].totalPnlstringPnL acumulado

Símbolos favoritos

Salvar

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

Cuerpo de la solicitud:

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

Consulta

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

Campos de respuesta:

CampoTipoDescripción
symbolscuerda[]Lista de símbolos favoritos