Usuario y cuenta

Ver como Markdown

A menos 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 cartera
userAsset.frozenMarginstringMargen congelado por órdenes 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 predeterminado
pageSizeint32NoElementos por página, 20 predeterminado

Campos de respuesta:

CampoTipoDescripción
list[].assetTypestringTipo de activo
list[].amountstringCantidad cambiada
list[].walletBalanceBeforestringSaldo de la cartera antes del cambio
list[].walletBalanceAfterstringSaldo de la cartera después del cambio
list[].frozenBalanceBeforestringSaldo congelado antes del cambio
list[].frozenBalanceAfterstringSaldo congelado después del cambio
list[].changeTypestringCambio de tipo
list[].referenceIdstringID de negocio relacionado
list[].createdAtint64Tiempo de creación
totalint64Conteo 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
feeTotal30dstringCuotas acumuladas en los últimos 30 días

Historial de Balance

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 predeterminado

Campos de respuesta:

CampoTipoDescripción
items[].datestringFecha de agregación
items[].balancestringSaldo de 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 acumulados transferidos
transferOutstringFondos transferidos acumulados
items[]arrayDatos de tendencias de activos

Resumen del Activo

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

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

Tendencia de Resumen 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 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