ETHUSDT 선물 포지션 규모를 보는 방법은 무엇입니까?

Binance REST API를 통해 선물 포지션 데이터에 액세스

1. 사용자는 유효한 API 자격 증명과 적절한 서명 인증을 통해 /fapi/v2/positionRisk 엔드포인트를 호출하여 실시간 ETHUSDT 무기한 선물 포지션 크기를 검색합니다.

2. 거부를 방지하려면 요청에는 X-MBX-APIKEY 헤더와 바이낸스 서버 시간의 ±60,000밀리초 이내에 정렬된 타임스탬프 매개변수가 포함되어야 합니다.

3. 기호=ETHUSDT 및 타임스탬프 가 포함된 서명된 쿼리 문자열은 사용자의 비밀 키와 함께 HMAC-SHA256을 사용하여 생성됩니다.

4. 응답 페이로드는 각 개체가 계정의 위치에 해당하는 배열을 반환합니다. ETHUSDT의 경우 관련 항목에는 positionAmt , EntryPrice 및 unRealizedProfit 과 같은 필드가 포함됩니다.

5. positionAmt 필드는 계약의 순 포지션 크기를 나타내며 양수 값은 장기 노출을 나타내고 음수 값은 단기 노출을 나타냅니다.

포지션 금액 및 계약 단위 해석

1. ETHUSDT USD-M 선물의 경우 한 계약은 0.01 ETH를 나타냅니다. 즉, positionAmt = 100 은 1 ETH 매수 포지션과 같습니다.

2. notionalValue 필드는 현재 시장 평균 가격의 USDT로 표현된 포지션 크기를 반영하므로 수동 변환 없이 즉시 평가가 가능합니다.

3. 레버리지 설정은 원시 positionAmt 값을 변경하지 않지만 동일한 응답에 표시된 마진 사용 및 청산 임계값에 직접적인 영향을 미칩니다.

4. 격리 및 교차 마진 모드에 걸쳐 여러 위치가 존재하는 경우 각각은 고유한 marginType 및 격리된 마진 필드가 있는 별도의 배열 요소로 나타납니다.

5. 값이 0인 positionAmt는 최근 주문 내역이나 보류 중인 트리거와 관계없이 해당 기호에 대한 열린 포지션이 없음을 확인합니다.

실시간 업데이트를 위해 WebSocket 스트림 사용

1. !account 사용자 데이터 스트림을 구독하면 실행, 청산 또는 조정 시 REST 대기 시간을 우회하여 포지션 업데이트가 즉시 제공됩니다.

2. 각 메시지에는 REST 응답과 구조가 동일한 위치 배열이 포함되어 있어 폴링 없이 로컬 상태에 직접 매핑할 수 있습니다.

3. 각 포지션 개체 내부의 updateTime 필드는 밀리초 단위의 정밀도 UNIX 타임스탬프를 전달하며, 이는 캔들스틱 또는 주문장 스트림과 동기화하는 데 중요합니다.

4. WebSocket 메시지에는 crossWalletBalance 및 availableBalance 도 포함되어 위치 크기와 함께 상황별 마진 상태를 제공합니다.

5. 재연결 로직은 ListenKey 유효성을 유지해야 합니다. 60분마다 새로 고치지 않으면 스트림이 종료되고 위치 델타 연속성이 손실됩니다.

클라이언트 측 구문 분석 및 표시 고려 사항

1. 원시 JSON을 구문 분석하는 프런트엔드 애플리케이션은 렌더링하기 전에 positionAmt 의 존재를 검증해야 합니다. 누락된 키는 위치가 0이거나 권한이 제한된 계정 범위를 나타내기 때문입니다.

2. 소수점 정밀도 처리는 필수입니다. ETHUSDT는 positionAmt 에 소수점 이하 3자리를 사용하며 잘림 오류로 인해 표시된 크기와 실제 노출이 잘못 정렬됩니다.

3. 위치 배열을 기호 별로 정렬하면 동일한 계정에서 여러 기호가 활성화될 때 결정적인 렌더링 순서가 보장됩니다.

4. WebSocket 페이로드의 비어 있거나 null 위치 배열에는 명시적인 UI 폴백이 필요합니다. 시퀀스 번호를 비교하지 않고 "변경 없음"이라는 가정을 해서는 안 됩니다.

5. 색상으로 구분된 지표(양수 포지션Amt 는 녹색, 음수는 빨간색)는 손익 상태 또는 레버리지 수준과 관계없이 부호만 반영해야 합니다.

자주 묻는 질문

Q: 지정가 주문을 한 후에도 positionAmt가 0으로 표시되는 이유는 무엇입니까? 포지션 규모는 체결된 계약만 반영합니다. 채워지지 않은 주문은 position이 아닌 openOrders 아래에 표시됩니다.

Q: 만료된 배송 계약의 포지션 크기를 볼 수 있나요? 아니요. 현재 선물 시장 목록에서 지원되는 활발하게 거래되는 기호만 포지션 응답에 나타납니다. 만료된 계약은 완전히 제외됩니다.

Q: positionAmt에는 API 하위 계정을 통해 보유한 포지션이 포함됩니까? 아니요. 각 API 키는 자체 마스터 계정이나 명시적으로 위임된 하위 계정에만 액세스합니다. 교차 하위 계정 집계에는 키별로 별도의 인증 호출이 필요합니다.

Q: positionAmt가 부분 청산의 영향을 받나요? 예. 부분 청산은 positionAmt를 비례적으로 줄이고 수정된 값과 업데이트된 liquidationPrice 로 즉시 WebSocket 업데이트를 트리거합니다.