Utilizador e Conta

Ver como Markdown

Salvo indicação em contrário, os seguintes endpoints podem usar JWT ou API Key assinatura.

Informação do Utilizador

1GET /v1/private/user/info

Campos de resposta:

CampoTipoDescrição
userInfo.userIdstringID de utilizador externo
userInfo.usernamestringNome de utilizador
userInfo.agentIdint64ID do agente
userInfo.vipLevelint64VIP nível
userInfo.lastLoginAtint64Última hora de login
userInfo.lastLoginIpstringÚltimo login IP

Recursos de Utilizador

1GET /v1/private/user/asset

Campos de resposta:

CampoTipoDescrição
userAsset.userIdstringID de utilizador externo
userAsset.assetTypestringTipo de ativo
userAsset.walletBalancestringSaldo da carteira
userAsset.frozenMarginstringMargem congelada por ordens pendentes
userAsset.usedMarginstringMargem usada pelas posições

Crie listenKey

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

Cria uma chave de autenticação para streams privados WebSocket .

Renovar listenKey

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

Estende listenKey validade.

Fechar listenKey

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

Fecha a listenKeyespecificada.

Registos de Alterações de Conta

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

Parâmetros do pedido:

ParâmetroTipoObrigatórioDescrição
assetTypestringNãoTipo de ativo, como USDT
changeTypestringNãoMudança de tipo
startTimeint64NãoHora de início
endTimeint64NãoFim dos tempos
pageint32NãoNúmero de página, 1 padrão
pageSizeint32NãoItens por página, 20 padrão

Campos de resposta:

CampoTipoDescrição
list[].assetTypestringTipo de ativo
list[].amountstringValor alterado
list[].walletBalanceBeforestringSaldo da carteira antes da troca
list[].walletBalanceAfterstringSaldo da carteira após a troca
list[].frozenBalanceBeforestringSaldo congelado antes da alteração
list[].frozenBalanceAfterstringSaldo congelado após a alteração
list[].changeTypestringMudança de tipo
list[].referenceIdstringID de negócio relacionado
list[].createdAtint64Tempo de criação
totalint64Contagem total

Estatísticas de Volume de 30 Dias

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

Campos de resposta:

CampoTipoDescrição
volume30dstringVolume acumulado de negociação nos últimos 30 dias
feeTotal30dstringTaxas acumuladas nos últimos 30 dias

Histórico da Balança

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

Parâmetros do pedido:

ParâmetroTipoObrigatórioDescrição
periodstringSim1D / 1W / 1M
limitintNãoNúmero de itens devolvidos, 30 padrão

Campos de resposta:

CampoTipoDescrição
items[].datestringData de agregação
items[].balancestringSaldo da carteira
items[].pnlstringPnL realizado para o período

Visão Geral do Comércio

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

Parâmetros do pedido:

ParâmetroTipoObrigatórioDescrição
typestringSimGama de tendências: 1D, 1W, 1M, 3M, 6M, 1Y

Campos de resposta:

CampoTipoDescrição
todayPnlstringO PnL realizado hoje
todayVolumestringVolume de negociação de contratos de hoje
totalVolumestringVolume cumulativo de negociação de contratos
totalPnlstringPnL acumulado realizado
maxDrawdown30dstringMontante máximo de retirada nos últimos 30 dias
maxDrawdown30dRatestringTaxa máxima de redução nos últimos 30 dias, decimal de 0 a 1
transferInstringFundos transferidos cumulativos
transferOutstringFundos transferidos cumulativos para fora
items[]arrayDados de tendência de ativos

Resumo da Visão Geral do Ativo

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

Os campos de resposta são os mesmos que os campos de resumo de visão geral do comércio, excluindo items[].

Tendência de Visão Geral dos Ativos

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

Parâmetros do pedido:

ParâmetroTipoObrigatórioDescrição
typestringSimGama de tendências: 1D, 1W, 1M, 3M, 6M, 1Y

Campos de resposta:

CampoTipoDescrição
items[].snapshotTimeint64Tempo de snapshot
items[].balancestringSaldo da conta corrente
items[].pnlstringPnL para o período atual
items[].pnlRatestringTaxa PnL para o período atual
items[].totalPnlstringPnL acumulado

Símbolos Favoritos

Guardar

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

Órgão do pedido:

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

Consulta

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

Campos de resposta:

CampoTipoDescrição
symbolsfio[]Lista de símbolos favoritos