OKX에서 선물 모드를 설정했는데 계정 모드가 지원되지 않는 이유는 무엇인가요?

이 오류는 무엇을 의미하나요?

AlgoRover Live에서 OKX 데모 자격 증명을 테스트할 때 계정 모드 오류, acctLv=1 또는 spot mode cannot trade perpetual swaps가 표시되면 이번 API 조회에서 해당 계정이 현물 모드로 확인된 것입니다. 이 모드에서는 무기한 선물을 거래할 수 없습니다.

같은 API 키에 연결된 계정과 환경을 확인하세요. 주 계정이 선물 모드여도 API를 만든 하위 계정의 모드까지 같다는 뜻은 아닙니다.

이 글의 한국어 이미지는 OKX 영어 페이지를 Google 브라우저 번역으로 표시한 참고 화면입니다. 이미지 상단에 번역 출처가 표시되어 있으며, 설정 용어는 OKX 원문과 함께 확인하세요.

API가 속한 주 계정 또는 하위 계정 확인하기

OKX 오른쪽 위 사용자 메뉴를 여세요. API가 주 계정에 속하면 주 계정을, 하위 계정 A나 B에 속하면 해당 하위 계정을 확인해야 합니다.

하위 계정 표시를 확인하고 계정 전환 메뉴에서 API를 생성한 계정을 선택하세요. 이미지의 계정 이름과 UID는 가려져 있습니다.

데모 거래 환경인지 확인하기

이 글은 데모 거래를 대상으로 합니다. API가 속한 계정에서 왼쪽 위의 데모 거래 표시와 자산 메뉴의 데모 거래 표시를 확인하세요. 실거래로 돌아가는 버튼은 현재 실거래 중이라는 뜻이 아닙니다.

AlgoRover Live의 자격 증명이 OKX 데모로 표시되는지 확인하고, OKX 데모 환경에서 생성한 API를 사용하세요. 하위 계정 A의 데모 API라면 하위 계정 A → 데모 거래에서 계정 모드를 확인해야 합니다.

거래 설정에서 계정 모드 확인하기

확인한 계정과 데모 환경에서 BTCUSDT 무기한 선물 같은 거래 화면을 여세요. 오른쪽 거래 설정 아이콘을 누른 뒤 계정 모드를 선택하세요. 영어 원문 경로는 Settings → Account mode입니다.

계정 모드는 거래 가능한 상품을 결정하고 포지션 모드는 롱·숏 포지션 관리 방식을 결정합니다. acctLv=1 오류는 먼저 계정 모드를 확인한 뒤 전략 배포 조건에 맞게 포지션 모드와 레버리지를 확인하세요.

선물 모드가 적용되었는지 확인하기

API에 연결된 계정이 아직 현물 모드라면 선물 모드를 선택하고 OKX 안내를 읽은 뒤 확인을 완료하세요. 전환 조건이 표시되면 화면 안내에 따라 처리하세요.

선물 모드 카드의 체크 표시와 아래의 현재 모드 버튼을 확인하세요. 영어 원문은 Futures mode와 Current mode입니다. 설정 창을 열거나 항목을 선택한 것만으로 전환 완료를 판단하지 마세요.

AlgoRover Live로 돌아와 다시 테스트하기

AlgoRover Live → 자격 증명 → OKX 데모 → 테스트를 여세요. OKX 설정을 바꾸기 전의 실패 결과가 남아 있을 수 있으므로 새 테스트 결과를 기준으로 확인하세요.

acctLv=1이 계속 표시되면 API가 속한 계정, 데모 환경과 모드 적용 여부를 다시 확인하세요.

계정 조회와 선물 권한 검사를 통과했다면 계정 모드 검사는 해결된 것입니다. 나머지 검사 항목을 확인하세요.

서명 또는 인증 오류라면 API 키, Secret Key와 API 암호가 같은 세트인지 확인하고 데모 환경을 점검하세요.

선물 권한은 통과했지만 WebSocket이 실패하면 네트워크나 프록시 연결을 확인하세요. 계정 모드를 반복해서 바꿀 필요는 없습니다.

모든 검사를 통과하면 연결 테스트가 성공한 것입니다. 전략 배포를 준비하고 시작 전에 구체적인 설정을 확인하세요.

API 키를 새로 만들어야 하나요?

계정 모드 오류만으로 API 키를 다시 만들어야 한다고 판단할 수는 없습니다. 해당 계정의 모드를 확인한 뒤 다시 테스트하세요. 자격 증명 오류, 분실 또는 다른 API 문제가 확인되면 해당 안내에 따라 처리하세요.

오류가 계속되면 어떤 정보를 보내야 하나요?

새 테스트 시간과 오류 코드, API가 주 계정 또는 하위 계정 중 어디에 속하는지, 데모 환경을 사용한다는 정보를 보내세요. 계정 이름, UID와 잔액을 가린 계정 모드 스크린샷을 첨부할 수 있습니다.

API 키, Secret Key, API 암호, 로그인 비밀번호 또는 인증 코드는 보내지 마세요.