Posição

Ver como Markdown

Nota

Os endpoints de posição requerem 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 temporal

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 cruz, 2 isolado.

Definições de Posição

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

Campos de resposta:

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

Cargos Atuais

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

Parâmetros do pedido:

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

Campos de resposta:

CampoTipoDescrição
positions[].symbolstringSímbolo
positions[].marginModestringModo de 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 capital próprio
positions[].nextFundingFeestringPróxima taxa de financiamento estimada
positions[].fundingFeeAccumstringTaxa de financiamento acumulada
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 do pedido:

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

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 próximo
list[].pnlstringPnL Realizado
list[].roestringRetorno sobre o capital próprio
list[].marginModestringModo de margem
list[].triggerModeint32Modo de gatilho fechado
list[].fundingFeeAccumstringTaxa de financiamento acumulada
list[].openedAtint64Horário aberto
list[].closedAtint64Tempo de fechamento
totalint64Contagem total