기존 포지션에 영향을 주지 않고 OKX의 레버리지를 조정하는 방법은 무엇입니까?

레버리지 조정 메커니즘 이해

1. OKX 레버리지 변경은 포지션별이 아닌 마진 모드 수준에서 적용됩니다. 사용자가 교차 마진 모드와 격리 마진 모드 사이를 전환하거나 레버리지 값을 수정하면 시스템은 현재 시장 상황과 공개 주문 상태를 기반으로 마진 요구 사항을 다시 계산합니다.

2. 레버리지 조정은 자동 청산이나 포지션 폐쇄를 유발하지 않습니다. 플랫폼은 조정 후 유지 증거금이 충분하게 유지되는 한 대기 주문을 포함한 모든 활성 포지션을 유지합니다.

3. 격리된 마진 포지션은 전용 마진 풀을 유지합니다. 하나의 격리된 포지션에 대한 레버리지 수정은 다른 격리된 포지션이나 교차 마진 잔액에 영향을 미치지 않습니다.

4. 교차 마진 모드는 거래 계좌의 사용 가능한 전체 잔액을 담보로 사용합니다. 여기에서 레버리지를 변경하면 각 포지션에 할당되는 공유 풀의 양에 영향을 주지만 새 주문이 이루어지지 않는 한 강제로 재할당되지는 않습니다.

5. OKX는 레버리지 변경 사항을 적용하기 전에 엄격한 검증을 시행합니다. 요청된 레버리지로 인해 즉시 마진 부족이 발생하는 경우 API는 오류 코드 51008을 반환하고 업데이트를 거부합니다.

단계별 활용 수정 흐름

1. GET /api/v5/account/positions를 사용하여 현재 포지션 상태를 검색하여 상품 ID, 포지션 측면 및 마진 모드를 확인합니다.

2. 마진으로 사용되는 특정 통화(예: USDT 마진 계약의 경우 USDT)에 초점을 맞춰 GET /api/v5/account/balance 로 마진 가용성을 확인합니다.

3. 정확한 매개변수 instId , lever , mgnMode 및 posSide 를 사용하여 레버리지 수정 요청을 구성합니다. 필수 필드를 생략하면 거부가 발생합니다.

4. POST /api/v5/account/set-leverage 를 통해 요청을 제출합니다. 응답에는 감사 추적을 위한 고유한 ordId가 포함되어 있으며 새로운 레버리지 값을 확인합니다.

5. 위치 세부 정보를 다시 가져와 변경 사항을 확인합니다. 응답의 레버 필드는 제출된 값과 일치해야 하며, margin 및 maintMargin은 위치 상태 변경 없이 업데이트된 계산을 반영해야 합니다.

레버리지 업데이트 중 일반적인 함정

1. 포지션이 청산 또는 adl (자동 청산) 상태에서 레버리지 조정을 시도하면 즉시 거부됩니다. 사용자는 포지션이 이러한 위험 상태를 벗어날 때까지 기다려야 합니다.

2. 레버리지를 포지션 크기 및 계층형 마진 규칙에 따라 결정되는 상품의 최대 허용 값보다 높게 설정하면 오류 50007이 발생합니다. 이 한도는 자산 및 계약 유형에 따라 다릅니다.

3. 요청 서명에 오래된 타임스탬프를 사용하면 오류 5가 발생합니다. OKX 서버는 내부 시계에 대해 시간 차이를 확인합니다. ±30초를 초과하는 편차는 인증을 무효화합니다.

4. 100ms 이내에 중복 레버리지 요청을 제출하면 속도 제한을 위반합니다. API는 100ms 기간마다 상품당 하나의 성공적인 레버리지 변경을 적용합니다.

5. 교차 및 분리된 마진 식별자를 혼동하면 매개변수 불일치가 발생합니다. mgnMode 필드는 대소문자를 구분하여 '교차' 또는 '격리'만 허용합니다.

API 통합 모범 사례

1. API 자격 증명을 하드코딩하는 대신 항상 환경 변수를 사용하세요. 버전 관리에서 제외된 .env 파일에 OKX_API_KEY , OKX_SECRET_KEY 및 OKX_PASSPHRASE를 저장합니다.

2. HTTP 429 응답에 대한 지수 백오프를 사용하여 재시도 논리를 구현합니다. OKX는 거래 엔드포인트에 대해 초당 20개의 요청을 허용하지만 레버리지 조정은 이 할당량에 포함됩니다.

3. 업데이트를 제출하기 전에 위치 데이터를 로컬로 캐시하고 타임스탬프를 비교합니다. 빈번한 불필요한 호출은 실패 위험을 증가시키고 속도 제한을 소비합니다.

4. 플래그 매개변수를 올바르게 사용하십시오. 데모 거래의 경우 '1' 로 설정하고 라이브 계좌의 경우 '0' 으로 설정하십시오. 엔드포인트 전체에서 이러한 플래그를 혼합하면 일관되지 않은 상태가 생성됩니다.

5. 응답 코드를 엄격하게 검증합니다. 200 상태가 성공을 보장하지는 않습니다. JSON 본문 내부의 코드 필드를 확인하세요. '0' 만 올바른 실행을 나타냅니다.

자주 묻는 질문

Q: 여러 포지션의 레버리지를 동시에 변경할 수 있나요? A: 아니요. 각 레버리지 조정은 단일 상품-포지션 측면 조합을 대상으로 합니다. 일괄 업데이트에는 적절한 비율 제한 처리가 포함된 순차적 API 호출이 필요합니다.

Q: 레버리지 변경이 미실현 손익 계산에 영향을 미치나요? A: 아니요. 미실현 손익은 진입 가격, 시장 평균가, 포지션 규모를 사용해 계산됩니다. 레버리지는 마진 사용에 영향을 주지만 손익 산술에는 영향을 미치지 않습니다.

Q: 유효한 요청을 제출한 후 내 포지션에 '레버리지 변동 없음'이 표시되는 이유는 무엇입니까? 답변: 이는 요청한 레버리지가 현재 가치와 같을 때 발생합니다. OKX는 동일한 값을 무작동 작업으로 처리하고 처리를 건너뜁니다.

Q: 레버리지 조정과 관련된 수수료가 있습니까? A: 아니요. OKX는 레버리지 설정 수정에 대해 거래 수수료를 청구하지 않습니다. 실제 주문에만 수수료가 부과됩니다.