Usuário e Conta

Ver como Markdown

A menos que especificado de outra forma, os seguintes endpoints podem usar JWT ou API Key assinatura.

Informações do Usuário

1GET /v1/private/user/info

Campos de resposta:

CampoTipoDescrição
userInfo.userIdstringID de usuário externo
userInfo.usernamestringNome de usuário
userInfo.agentIdint64ID do Agente
userInfo.vipLevelint64VIP nível
userInfo.lastLoginAtint64Último tempo de login
userInfo.lastLoginIpstringÚltimo login IP

Recursos de Usuário

1GET /v1/private/user/asset

Campos de resposta:

CampoTipoDescrição
userAsset.userIdstringID de usuário 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 fluxos privados WebSocket .

Renovar listenKey

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

Estende listenKey validade.

Fechar listenKey

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

Fecha a listenKeyespecificada.

Registros de Alteração de Conta

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

Parâmetros da solicitação:

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

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 troca
list[].frozenBalanceAfterstringSaldo congelado após a troca
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 de Balanço

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

Parâmetros da solicitação:

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

Campos de resposta:

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

Visão Geral do Comércio

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

Parâmetros da solicitação:

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

Campos de resposta:

CampoTipoDescrição
todayPnlstringO PnL realizado de hoje
todayVolumestringVolume de negociação de contratos de hoje
totalVolumestringVolume acumulado de negociação de contratos
totalPnlstringPnL realizado cumulativo
maxDrawdown30dstringValor máximo de redução 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 da solicitação:

ParâmetroTipoObrigatórioDescrição
typestringSimFaixa de tendência: 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

Salvar

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 favorita