영구 포지션 | 6MM Docs

이 가이드는 Agent Java SDK v0.3.0, Java 8+ 및 태그된 공개 계약을 대상으로 합니다. 예제는 client를 초기화한 후 파트너 백엔드에서 실행됩니다. 빠른 시작.

예시 전제조건

Java 조각은 이러한 가져오기를 공유합니다. 빠른 시작을 사용하여 client를 초기화하고 저장된 바인딩에서 platformUserId를 가져옵니다. 예시 사용자/주문 ID는 고유한 지속 값으로 대체되어야 합니다.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

`listCurrentPerpetualPositions`

요청 모델: CurrentPerpetualPositionsRequest.

import com.sixmm.agent.model.CurrentPerpetualPositionsRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
CurrentPerpetualPositionsRequest request = new CurrentPerpetualPositionsRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
PerpetualResponse response = client.listCurrentPerpetualPositions(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

요청 필드

필드	Java 유형	필수의	의미
`platformUserIds`	`java.util.List<String>`	가정 어구	1~100개의 고유한 공개 ID 채우기 및 조건부 주문에 필요합니다. 직접 플레이어 범위에 대해 지원되는 쿼리를 생략합니다. []는 유효하지 않습니다.
`symbol`	`String`	아니요	선택적 거래 쌍 필터.
`limit`	`Integer`	아니요	기본 500; 1~1000.
`cursor`	`String`	아니요	변경되지 않은 필터와 함께 반환된 nextCursor를 사용합니다. hasMore가 false인 경우 중지합니다.

예제에서는 한 페이지를 읽습니다. 필수 필드, 플레이어 범위, 필터 의미, 제한, 커서 및 제한된 재시도에 대해서는 다음을 따르세요. 쿼리 개요. 페이징하는 동안 모든 필터를 변경하지 않고 유지하세요. 오류를 빈 결과로 해석하지 마십시오.

`listPerpetualPositionHistory`

요청 모델: PerpetualPositionHistoryRequest.

import com.sixmm.agent.model.PerpetualPositionHistoryRequest;
import com.sixmm.agent.model.PerpetualResponse;
import java.util.Collections;
PerpetualPositionHistoryRequest request = new PerpetualPositionHistoryRequest();
request.platformUserIds = Collections.singletonList("1188041528");
request.limit = 100;
request.symbol = "BTCUSDT";
request.endTime = System.currentTimeMillis();
request.startTime = request.endTime - 3_600_000L;
PerpetualResponse response = client.listPerpetualPositionHistory(request);
System.out.println(response.data.items.size());
System.out.println(response.data.hasMore);
System.out.println(response.data.nextCursor);

요청 필드

필드	Java 유형	필수의	의미
`platformUserIds`	`java.util.List<String>`	가정 어구	1~100개의 고유한 공개 ID 채우기 및 조건부 주문에 필요합니다. 직접 플레이어 범위에 대해 지원되는 쿼리를 생략합니다. []는 유효하지 않습니다.
`symbol`	`String`	아니요	선택적 거래 쌍 필터.
`positionSide`	`String`	아니요	소스 위치 측 열거형을 사용하여 필터링합니다.
`startTime`	`Long`	아니요	Unix 밀리초를 포함합니다. 고정된 UTC 기록 창을 사용합니다.
`endTime`	`Long`	아니요	독점 Unix 밀리초.
`limit`	`Integer`	아니요	기본 500; 1~1000.
`cursor`	`String`	아니요	변경되지 않은 필터와 함께 반환된 nextCursor를 사용합니다. hasMore가 false인 경우 중지합니다.

직위: 현재 및 과거

`data` 필드	유형	현재 위치	역사적 위치	의미
`positionId`	string	공급	공급	entityId에 해당하는 위치 ID
`symbol`	string	공급	공급	거래쌍
`positionSide`	string	공급	공급	LONG / SHORT / BOTH 및 기타 위치 방향
`status`	string	공급	공급	위치의 숫자 상태가 포함된 문자열, 쿼리 개요 참조
`leverage`	integer	공급	공급	여러 가지 활용
`marginMode`	string	공급	공급	전체 위치의 경우 숫자 열거 문자열 “1”, 격리된 위치의 경우 “2”
`quantity`	string	공급	사용할 수 없음	현재 위치 수량
`entryPrice`	string	공급	공급	저장된 포지션의 평균 개시 가격
`margin`	string	공급	사용할 수 없음	사용자의 전체 계약 지갑 잔액이 아닌 현재 포지션 증거금 금액
`maxQuantity`	string	사용할 수 없음	공급	이 역사적 위치에 기록된 최대 위치 수
`closeQuantity`	string	사용할 수 없음	공급	과거 포지션 수명 주기 동안 청산된 누적 포지션 수
`closePrice`	string	사용할 수 없음	공급	저장된 평균 종가
`pnl`	string	사용할 수 없음	공급	역사적 위치 손익; 단순히 반복하고 축적하기 위해 거래 realizedPnl와 결합하지 마십시오.
`roe`	string	사용할 수 없음	공급	100을 곱하지 않은 역사적 위치 수익의 비례 값입니다. 예를 들어, `"0.043"`는 `4.3%`를 나타내고, `"-0.05"`는 `-5%`를 나타냅니다.
`fundingFeeAccum`	string	공급	공급	누적된 펀딩 수수료, 소스 기호 및 정확성 유지
`openedAt`	integer	공급	공급	위치 개방 시간(밀리초)
`updatedAt`	integer	공급	사용할 수 없음	현재 위치 업데이트 시간(밀리초)
`closedAt`	integer	사용할 수 없음	공급	종료 시간(밀리초) 이 필드를 사용하여 과거 위치 시간을 필터링하세요.

이력 roe의 계산 구경은 pnl / (entryPrice × maxQuantity / leverage)이며 인터페이스는 저장된 비율 값을 직접 반환합니다. 백분율을 표시할 때는 소수 연산을 사용하고 100을 곱한 다음 %를 추가합니다. 분모는 계정 지갑 잔액이 아닌 과거 포지션 기록의 명목 마진을 사용합니다. 시가 또는 최대포지션수량이 0인 경우, 레버리지가 무효인 경우 등 계산할 수 없는 경우에는 소스가 0으로 저장됩니다. 따라서 roe=0만으로는 손익이 0이라고 유추할 수 없습니다.

현재 포지션에는 실시간 표시가, 실시간 변동 손익, 실시간 ROE 또는 실시간 청산 가격이 없습니다. 저장된 포지션 상태를 반영하며 업데이트 시간 및 마진 필드를 사용하여 현재 실시간 리스크 통제 결과를 주장할 수 없습니다.

응답 봉투 예시

이것은 완료된 거래의 샘플이 아닌 예시용 빈 페이지입니다. 위의 리소스별 필드 테이블은 채워진 items[].data에 대해 설명합니다.

{"code":0,"message":"success","data":{"items":[],"nextCursor":"","hasMore":false}}

예시 전제조건

listCurrentPerpetualPositions

요청 필드

listPerpetualPositionHistory

요청 필드

직위: 현재 및 과거

응답 봉투 예시

소스 및 관련 가이드

`listCurrentPerpetualPositions`

`listPerpetualPositionHistory`