Posição

Ver como Markdown

Nota

Endpoints de posição exigem permissão comercial.

Alavancagem de Conjunto

1POST /v1/private/position/leverage
2Content-Type: application/json

Órgão do pedido:

1{
2 "symbol": "BTCUSDT",
3 "leverage": 20
4}

Campos de resposta:

CampoTipoDescrição
symbolstringSímbolo
leverageint32Alavancagem
timestampint64Carimbo de data e hora

Definir Modo Margem

1POST /v1/private/position/margin-mode
2Content-Type: application/json

Órgão do pedido:

1{
2 "symbol": "BTCUSDT",
3 "marginMode": 1
4}

marginMode: 1 cruzar, 2 isolado.

Configurações de Posição

1GET /v1/private/position/settings?symbol=BTCUSDT

Campos de resposta:

CampoTipoDescrição
symbolstringSímbolo
marginModeint321 cruzar, 2 isolado
leverageint32Alavancagem

Cargos Atuais

1GET /v1/private/position/positions?symbol=BTCUSDT

Parâmetros da solicitação:

ParâmetroTipoObrigatórioDescrição
symbolstringNãoSímbolo

Campos de resposta:

CampoTipoDescrição
positions[].symbolstringSímbolo
positions[].marginModestringModo margem
positions[].positionSidestringLado da posição
positions[].leverageint32Alavancagem
positions[].quantitystringQuantidade de posição
positions[].entryPricestringPreço de entrada
positions[].breakEvenPricestringPreço de equilíbrio
positions[].liqPricestringPreço de liquidação
positions[].marginRatiostringRazão de margem
positions[].unrealizedPnlstringPnL não realizado
positions[].roestringRetorno sobre o patrimônio líquido
positions[].nextFundingFeestringPróxima taxa estimada de financiamento
positions[].fundingFeeAccumstringTaxa acumulada de financiamento
positions[].tpPricestringPreço de lucro
positions[].slPricestringPreço de stop-loss

Histórico da Posição

1GET /v1/private/position/history?symbol=BTCUSDT&page=1&pageSize=20

Parâmetros da solicitação:

ParâmetroTipoObrigatórioDescrição
symbolstringNãoSímbolo
sidestringNãolong / short
startTimeint64NãoHorário de início
endTimeint64NãoFim dos tempos
pageint64NãoNúmero da página, 1 padrão
pageSizeint64NãoItens por página, padrão 20

Campos de resposta:

CampoTipoDescrição
list[].symbolstringSímbolo
list[].positionSidestringLado da posição
list[].leverageint32Alavancagem
list[].maxQuantitystringQuantidade máxima de posição
list[].entryPricestringPreço de entrada
list[].closePricestringPreço fechado
list[].pnlstringPnL realizado
list[].roestringRetorno sobre o patrimônio líquido
list[].marginModestringModo margem
list[].triggerModeint32Modo de gatilho fechado
list[].fundingFeeAccumstringTaxa acumulada de financiamento
list[].openedAtint64Horário aberto
list[].closedAtint64Tempo de fechamento
totalint64Contagem total