위치
위치
주
포지션 엔드포인트는 거래 허가가 필요합니다.
레버리지 설정
1 POST /v1/private/position/leverage 2 Content-Type: application/json
요청 본문:
1 { 2 "symbol": "BTCUSDT", 3 "leverage": 20 4 }
응답 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
symbol | string | 상징 |
leverage | int32 | 레버리지 |
timestamp | int64 | 타임스탬프 |
마진 모드 설정
1 POST /v1/private/position/margin-mode 2 Content-Type: application/json
요청 본문:
1 { 2 "symbol": "BTCUSDT", 3 "marginMode": 1 4 }
marginMode: 1 교차, 2 고립됐어.
위치 설정
1 GET /v1/private/position/settings?symbol=BTCUSDT
응답 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
symbol | string | 상징 |
marginMode | int32 | 1 십자가, 2 고립 |
leverage | int32 | 레버리지 |
현재 직책
1 GET /v1/private/position/positions?symbol=BTCUSDT
요청 매개변수:
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
symbol | string | 아니 | 상징 |
응답 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
positions[].symbol | string | 상징 |
positions[].marginMode | string | 마진 모드 |
positions[].positionSide | string | 포지션 사이드 |
positions[].leverage | int32 | 레버리지 |
positions[].quantity | string | 위치 수량 |
positions[].entryPrice | string | 입장 가격 |
positions[].breakEvenPrice | string | 손익분기점 |
positions[].liqPrice | string | 청산 가격 |
positions[].marginRatio | string | 마진 비율 |
positions[].unrealizedPnl | string | 실현되지 않은 PnL |
positions[].roe | string | 자기자본수익률 |
positions[].nextFundingFee | string | 예상 다음 자금 지원 수수료 |
positions[].fundingFeeAccum | string | 누적 자금 지원 수수료 |
positions[].tpPrice | string | 이익 실현 가격 |
positions[].slPrice | string | 스톱로스 가격 |
직책 역사
1 GET /v1/private/position/history?symbol=BTCUSDT&page=1&pageSize=20
요청 매개변수:
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
symbol | string | 아니 | 상징 |
side | string | 아니 | long / short |
startTime | int64 | 아니 | 시작 시간 |
endTime | int64 | 아니 | 종말 |
page | int64 | 아니 | 페이지 번호, 기본 1 |
pageSize | int64 | 아니 | 페이지당 항목 수, 기본 20 |
응답 필드:
| 필드 | 유형 | 설명 |
|---|---|---|
list[].symbol | string | 상징 |
list[].positionSide | string | 포지션 사이드 |
list[].leverage | int32 | 레버리지 |
list[].maxQuantity | string | 최대 위치 양 |
list[].entryPrice | string | 입장 가격 |
list[].closePrice | string | 종가 |
list[].pnl | string | 실현된 PnL |
list[].roe | string | 자기자본수익률 |
list[].marginMode | string | 마진 모드 |
list[].triggerMode | int32 | 클로즈 트리거 모드 |
list[].fundingFeeAccum | string | 누적 자금 지원 수수료 |
list[].openedAt | int64 | 오픈 타임 |
list[].closedAt | int64 | 마감 시간 |
total | int64 | 총 집단 |