OKX API 키 생성과 연결 방법: 권한 선택과 양방향 포지션 설정

자동매매용 OKX API 키를 단계별로 만듭니다. 읽기와 거래 권한만(출금 없음), 패스프레이즈 저장, 롱/숏 모드(양방향 포지션) 전환, 서브 계정으로 자금 분리, 연결 오류 해결까지 정리했습니다.

핵심은 세 가지입니다. 권한은 '읽기'와 '거래'만, '출금'은 절대 체크하지 않기. 시크릿 키와 패스프레이즈는 한 번만 표시되니 직접 저장하기. 포지션 모드는 롱/숏 모드(양방향 포지션)로 바꾸기.

시작 전에: 서브 계정 만들기

플랫폼은 자신이 연 포지션만 관리합니다. 연결한 계좌에 이미 선물 포지션이 있으면 넘겨받기를 거부해 수동 포지션을 잘못 청산하지 않도록 합니다. 전략 전용 OKX 서브 계정을 만들어 수동 거래 자금과 분리하는 것을 강력히 권장합니다.

처음이라면 OKX 모의투자도 쓸 수 있습니다. 모의투자용 API 키를 따로 만들면 시그널과 리스크 관리가 실거래와 같아서 흐름을 익힌 뒤 실계좌 키로 바꿀 수 있습니다.

1단계: API 키 만들기

OKX에 로그인하고(서브 계정을 쓰면 전환), 프로필 메뉴의 API 관리에서 'API 키 생성'을 누릅니다. 용도는 API 거래, 이름은 알아보기 쉽게 정합니다.

권한은 '읽기'와 '거래'만 체크하고 '출금'은 체크하지 마세요. 출금 권한이 없으면 플랫폼은 자금을 옮길 수 없습니다.

패스프레이즈를 정하고 보안 인증을 마치면 API 키, 시크릿 키, 패스프레이즈가 표시됩니다. 시크릿 키는 이때 한 번만 보이니 바로 안전한 곳에 저장하세요.

2단계: 양방향 포지션으로 전환

시스템은 롱과 숏 포지션, 손절을 따로 관리합니다. OKX 거래 설정에서 포지션 모드를 '롱/숏 모드(양방향 포지션)'로 바꾸세요. 포지션이나 미체결 주문이 있으면 전환이 막힐 수 있으니 먼저 정리합니다.

플랫폼은 계좌 설정을 대신 바꾸지 않습니다. 모드가 맞지 않으면 연결할 때 양방향 포지션 모드가 필요하다는 메시지가 나옵니다.

3단계: 플랫폼에 연결하고 증거금 맞추기

'계정' 페이지에서 OKX를 고르고 API 키, 시크릿 키, 패스프레이즈를 입력합니다. 플랫폼은 거래소에서 직접 검증한 뒤 사용자별로 암호화해 저장하며, 화면과 API는 평문을 다시 보여 주지 않습니다.

이어서 '전략' 페이지의 자금 매칭 점검을 엽니다. 실시간 잔고를 읽어 최악의 경우 증거금 사용이 가용 자금을 넘는지 확인하고, 부족하면 권장값을 한 번에 적용할 수 있습니다. 마지막으로 전략이 켜져 있고 모드가 자동 실행인지 확인합니다.

자주 나오는 연결 오류

양방향 포지션 모드가 필요하다고 나올 때: 2단계로 돌아가 모드를 바꾸고 다시 검증합니다.

계좌에 알 수 없는 포지션이 있다고 나올 때: 플랫폼이 열지 않은 포지션이 있습니다. 청산하거나 깨끗한 서브 계정으로 연결하세요.

시그널은 있는데 주문이 안 될 때: 대개 자금 부족, 최대 포지션 수 도달, 또는 전략이 관찰 전용 모드입니다. 자금 매칭 점검의 제안대로 조정하세요.

OKX API에 출금 권한이 필요한가요?
필요 없고 켜면 안 됩니다. 읽기와 거래만으로 충분하며, 출금 권한이 없으면 누구도 플랫폼을 통해 자금을 옮길 수 없습니다.
시크릿 키나 패스프레이즈를 잊어버렸다면?
OKX는 시크릿 키를 다시 보여 주지 않습니다. 기존 키를 삭제하고 새로 만든 뒤 계정 페이지에서 다시 연결하세요.
나중에 권한을 취소하려면?
계정 페이지에서 언제든 연결을 해제하거나 OKX에서 API 키를 삭제하면 즉시 무효가 됩니다.