OKX를 ZeroLoss에 연결하는 방법: API 키 설정
ZeroLoss는 이용자 본인의 OKX 계정에서 OKX USDT 증거금 무기한 스왑을 거래합니다. 비밀번호가 아니라 OKX에서 직접 만든 API 키로 연결하며, 이 키에는 계정 조회와 선물 거래 권한만 있으면 됩니다. 자금은 처음부터 끝까지 OKX에 그대로 있습니다. 이 가이드에서는 키를 만들고, 제한을 설정하고, ZeroLoss에 연결하는 방법을 안내합니다. 약 5분이면 됩니다.
무언가를 연결하기 전에 봇이 거래하는 모습을 먼저 보고 싶으신가요? 무료 7일 모의 테스트는 거래소가 전혀 필요 없습니다.
시작하기 전에
- 2단계 인증을 켠 OKX 계정. EEA(유럽경제지역)에 있다면 eea.okx.com을, 미국에 있다면 us.okx.com을 사용하세요. 한 사이트의 키는 다른 사이트에서 작동하지 않습니다. 일부 지역에서는 OKX가 키를 만들기 전에 최소 100 USD 상당의 자산을 요구합니다.
- 선물 거래가 가능한 계정 모드. Trade settings → Account mode(거래 설정 → 계정 모드)에서 Spot mode(현물 모드)가 아닌 다른 모드를 선택하세요. 현물 모드에서는 계약 거래가 차단됩니다. 이 설정은 웹사이트나 앱에서만 변경할 수 있습니다.
- Trading account(거래 계정)에 최소 100 USDT. Assets → Transfer(이체)를 사용해 Funding account(펀딩 계정)에서 Trading account로 옮기세요.
- ZeroLoss 계정. 무료 모의 테스트로 먼저 시작하고 나중에 연결해도 됩니다.
1단계: OKX에서 API 키 만들기
- OKX 웹사이트에서 Profile → API and connections(앱에서는 Menu → API)를 연 다음 Create API key를 누르세요.
- 키 이름을 정하고, 메인 계정(또는 USDT가 있는 서브 계정)과 본인 API 트레이딩 용도를 선택하세요.
- IP 허용 목록(3단계)과 권한(2단계)을 추가하세요.
- 패스프레이즈를 설정하세요. 대문자와 소문자, 숫자, 기호를 섞은 강력한 패스프레이즈를 쓰고 꼭 적어 두세요. OKX는 이를 보여 주거나 복구할 수 없으며, ZeroLoss에 필요합니다.
- 확인한 뒤 API key와 Secret key를 복사하세요.
2단계: 권한 선택하기
- Read(읽기): 켜기.
- Trade(거래): 켜기. 주문을 넣고 취소합니다.
- Withdraw(출금): 끄기.
- Transfer, Loan, Earn: 끄기. ZeroLoss는 이 권한이 전혀 필요하지 않습니다.
3단계: 키를 ZeroLoss IP 주소로 제한하기
키를 몇 개의 IP 주소로 제한하면, 누군가 키를 복사하더라도 해당 서버에서만 작동합니다. ZeroLoss 앱에서 거래소 연결(거래소 연결)를 여세요. 당사 IP 추가(IP 화이트리스트) 단계에 ZeroLoss 서버 주소 목록과 모두 복사(모두 복사) 버튼이 있습니다. 이를 OKX의 IP 제한 입력란에 붙여 넣으세요.
OKX는 키당 최대 20개의 주소를 쉼표나 공백으로 구분해 입력할 수 있습니다. IP 허용 목록이 없는 거래 키는 14일 동안 사용하지 않으면 자동으로 삭제됩니다. 허용 목록이 있는 키는 만료되지 않습니다.
4단계: ZeroLoss에서 키 연결하기
- ZeroLoss에 로그인하고 거래소 연결(거래소 연결)를 여세요.
- 1 · Pick your exchange(거래소 선택)에서 OKX를 선택하세요.
- 2 · Paste your API key(API 키 붙여 넣기)에 API 키, 시크릿 키, 패스프레이즈를 붙여 넣으세요. 패스프레이즈는 OKX에서 키를 만들 때 입력한 것이며, OKX는 이를 다시 보여 주지 않습니다.
- Verify & connect(확인 및 연결)를 클릭하세요. ZeroLoss가 키를 확인하고 선물 잔고를 읽어 옵니다. 연결하려면 OKX Trading account에 최소 100 USDT가 있어야 합니다.
키가 안전한지 확인하기
OKX의 API 관리 페이지를 열고 만든 키를 확인하세요. 읽기와 선물 거래가 허용되어 있고 출금은 꺼져 있어야 합니다. 언제든 ZeroLoss를 멈추려면 OKX에서 키를 삭제하세요. 저희 쪽 조치 없이도 해당 키를 통한 거래가 즉시 종료됩니다. 이 설정이 중요한 이유는 거래 전용 API 키 가이드에서 설명합니다.
자주 발생하는 문제
- 키에 문제가 없는데 주문이 거부됨: 계정이 현물 모드입니다. OKX 거래 설정에서 계정 모드를 변경하세요.
- 키, 시크릿, 패스프레이즈가 맞아 보이는데 실패함: 세 값 모두 같은 계정(메인 또는 서브 계정)에서, 그리고 올바른 지역 사이트(okx.com, eea.okx.com 또는 us.okx.com)에서 발급된 것이어야 합니다.
- 패스프레이즈 분실: OKX는 이를 보여 줄 수 없습니다. 키를 삭제하고 새로 만드세요.
- “Invalid API Key or Secret”(잘못된 API 키 또는 시크릿): 복사할 때 문자가 빠졌습니다. 둘 다 다시 복사하세요. 시크릿을 저장하지 않았다면 키를 삭제하고 새로 만드세요.
- “API key missing required permissions”(API 키에 필요한 권한 없음): 키에 선물 거래 또는 읽기가 체크되어 있지 않습니다. 키를 편집하거나 두 권한을 모두 갖춘 새 키를 만드세요.
- “API IP restriction issue”(API IP 제한 문제): 키가 제한되어 있지만 ZeroLoss 주소 전체로 제한되지는 않았습니다. 앱에서 모두 복사(모두 복사)을 사용해 전체 목록을 다시 붙여 넣으세요.
- “Minimum 100 USDT required in Futures wallet”(선물 지갑에 최소 100 USDT 필요): USDT가 Funding account에 있습니다. OKX에서 Trading account로 이체한 뒤 다시 시도하세요.
암호화폐 선물 거래는 손실 위험이 높으며, 자동매매가 그 위험을 없애 주지는 않습니다. 거래소 화면은 수시로 바뀝니다. 메뉴가 다르게 보이면 위의 권한 이름을 찾으세요. 이 페이지는 일반 정보이며 투자 조언이 아닙니다. 위험 & 책임 고지를 참고하세요.