OKX를 수동으로 연결하려면 다른 거래소보다 더 많은 단계가 필요합니다. API 키를 생성하고, 권한을 선택하고, 패스프레이즈를 설정하고, 한 번만 볼 수 있는 시크릿을 복사한 다음, 세 가지 모두를 오타 없이 Freya에 붙여넣어야 합니다.
빠른 연결을 사용하면 이 모든 과정이 필요 없습니다. Freya는 공인 OKX 브로커이므로, OKX가 여러분의 계정 내에서 키를 생성하여 Freya에 직접 전달할 수 있습니다. OKX 화면에서 한 번 승인하면, Spot과 Futures 연결이 모두 Freya에 나타납니다.
이 글에서는 승인이 의미하는 바, OKX 계정에서 변경되는 사항, 그리고 OKX나 Freya에서 녹색 체크 대신 메시지가 나타날 때 대처하는 방법을 설명합니다.
핵심 요약
- OKX 자체 사이트에서 Freya를 승인합니다. OKX가 키를 생성하고 Freya가 서버에서 이를 수신합니다.
- 시크릿이나 패스프레이즈를 직접 보거나, 복사하거나, 입력할 필요가 없습니다.
- 한 번의 승인으로 OKX Spot과 OKX Futures가 모두 설정됩니다.
- 키는 조회 및 거래 권한만 가집니다. Freya는 출금 권한을 요청하지 않으며, 출금이 가능한 키는 거부합니다.
- OKX는 계정당 Freya 키를 하나만 허용하므로, 키를 교체하려면 먼저 OKX에서 기존 키를 제거해야 합니다.
"원클릭"이 실제로 의미하는 것
OKX가 키를 생성합니다. 여러분이 아닙니다. 승인 후 OKX가 여러분의 OKX 계정 내에 Freya용 API 키를 생성합니다. OKX에서 FreyaFinance라는 이름으로 표시됩니다.
자격 증명이 여러분의 손을 거치지 않습니다. 키와 시크릿은 OKX에서 Freya 서버로 직접 전송되어 패스프레이즈와 함께 암호화되어 저장됩니다. 클립보드, 채팅 메시지, 스크린샷을 통해 복사되는 것이 없으므로, API 키가 가장 흔히 유출되는 경로를 차단합니다.
패스프레이즈를 만들거나 IP를 붙여넣을 필요가 없습니다. OKX 키에는 항상 패스프레이즈가 있습니다. 빠른 연결에서는 Freya가 이를 설정하고 키와 함께 저장하므로, 기억할 것이 없습니다. IP 주소를 어디에 복사할 필요도 없습니다.
승인하는 내용
빠른 연결로 생성되는 키는 다음을 할 수 있습니다:
- 조회: 잔액, 포지션, 주문 내역을 확인
- 주문 실행, 수정, 취소: 봇이 거래할 수 있게 하는 권한
다음은 할 수 없습니다:
- 출금 또는 자금 이체. Freya는 출금을 요청하지 않습니다. 출금이 가능한 키가 전달되면 Freya가 이를 거부하고 저장하지 않습니다.
- OKX 비밀번호나 보안 설정 변경.
이것은 올바르게 생성된 수동 키와 동일한 접근 권한입니다. 빠른 연결이 더 많은 권한을 부여하는 것이 아니라, 수동으로 권한을 선택하는 과정을 생략해 줄 뿐입니다.
단계별 진행 과정
- Settings → API Keys를 열고 Add API Key를 선택합니다.
- OKX를 선택합니다. Fast Connection 탭이 기본으로 선택되어 있습니다.
- Connect with OKX를 선택합니다. 같은 탭에서 OKX 페이지로 이동합니다.
- 메인 계정으로 OKX에 로그인하거나, 계정이 없다면 먼저 OKX 계정을 만듭니다.
- 요청을 검토하고 승인합니다.
- Freya로 돌아와 OKX connected가 표시됩니다. OKX Spot과 OKX Futures 키가 추가됩니다.
시작한 것과 같은 브라우저에서 완료하세요. Freya로 돌아오는 페이지가 시작한 페이지와 다르거나, OKX에서 너무 오래 대기하면 This attempt could not be matched가 표시됩니다. 아무것도 생성되지 않았으며, 같은 화면에서 연결을 다시 시작하면 됩니다.
거부한 경우
아무것도 생성되지 않고 변경되는 것도 없습니다. Freya가 Connection cancelled (You declined on OKX's screen, so no API key was created.)를 표시하며, 원할 때 다시 시도할 수 있습니다.
OKX가 키를 생성하지 않은 경우
간혹 OKX가 연결을 통한 키 생성을 허용하지 않는 경우가 있습니다. OKX did not create a key가 표시되며, OKX 계정에 아무것도 추가되지 않습니다. 대신 Manual Connection 탭에서 직접 키를 생성하여 연결하세요. How to Connect Your Exchange 가이드에서 자세한 과정을 안내합니다.
연결 시 OKX 계정에 변경되는 사항
빠른 연결은 Spot과 Futures 봇이 모두 작동할 수 있도록 계정을 준비합니다. 두 가지 설정이 변경될 수 있으며, 승인 전에 알아두면 좋습니다.
계정 모드. Futures에는 이를 허용하는 OKX 계정 모드가 필요합니다. 계정이 Spot 모드인 경우, Freya가 Futures 모드로 전환합니다. 열린 포지션이나 미체결 주문 등의 이유로 OKX가 전환을 허용하지 않으면, Spot으로만 연결이 작동합니다. Freya가 Needs OKX Futures mode. Spot is ready를 표시하고 해결 방법을 안내합니다. Futures 봇을 실행하려면 OKX에서 Trade → Account mode로 이동하여 계정을 Futures 모드로 전환하세요.
포지션 모드. Freya의 Futures 봇은 롱/숏(헤지) 모드를 사용하여 롱과 숏 포지션을 동시에 열 수 있습니다. 연결 시 Freya가 이를 활성화합니다. 단방향 포지션이 열려 있는 경우 전환이 종료될 때까지 대기하며, Will activate once your open One-Way positions close가 표시됩니다.
그 외에는 계정에 변경되는 것이 없으며, 자금은 그대로 유지됩니다.
OKX 계정당 하나의 Freya 키
OKX는 계정당 Freya 키를 하나만 허용합니다. 발생할 수 있는 대부분의 메시지는 이 규칙과 관련됩니다.
동일한 계정이 이미 연결되어 있는 경우. 다시 연결해도 변경되는 것이 없습니다. This OKX account is already connected가 표시됩니다. 이는 현재 봇이 사용 중인 키를 보호하기 위한 것입니다.
OKX에 이미 Freya 키가 있는 경우. 이전 연결의 키가 아직 OKX에 있어서 새 키를 생성하지 않은 것입니다. Freya가 OKX already has a Freya key를 세 가지 단계와 함께 표시합니다:
- Freya가 보여주는 버튼으로 OKX 인증 페이지를 엽니다.
- 해당 페이지에서 FreyaFinance를 제거합니다. 해당 API 키가 함께 삭제됩니다. 다른 API 키는 영향받지 않습니다.
- 돌아와서 Try Again을 선택합니다.
키가 다른 Freya 계정에 속한 경우. This OKX account is connected to another Freya account 메시지가 표시되면 OKX에서 아무것도 제거하지 마세요. 다른 계정의 봇이 중지될 수 있습니다. 대신 Manual Connection으로 이 계정에 OKX를 추가하세요.
Freya가 키 사용자를 확인할 수 없는 경우. Freya가 check before you remove anything on OKX를 요청하면, 어떤 Freya 계정도 해당 키를 사용하지 않는다고 확신할 때만 FreyaFinance를 제거하세요. 확신이 없다면 Manual Connection을 사용하세요.
작동하지 않는 키 교체하기
- OKX 키를 사용하는 봇을 중지합니다. Freya는 실행 중인 봇이 사용하는 키를 삭제하지 않습니다.
- API Keys 페이지에서 OKX Spot과 OKX Futures를 모두 삭제합니다. OKX에서는 하나의 키를 공유합니다.
- OKX 인증 페이지에서 FreyaFinance를 제거합니다. Freya에서만 삭제하면 기존 키가 OKX에 남아 있습니다.
- 빠른 연결로 다시 연결한 후, 봇을 새 키로 설정합니다.
연결 후
Settings → API Keys에서 OKX Spot과 OKX Futures로 키가 표시되며, 생성하는 모든 봇에서 바로 사용할 수 있습니다. 이전에 수동으로 추가한 키는 영향받지 않으며, 둘 다 동시에 존재할 수 있습니다.
OKX로 로그인. 메인 OKX 계정이 이 방식으로 연결되면 로그인에도 사용할 수 있습니다. Settings → Profile Settings → Sign-in methods에서 활성화하세요. 연결이 유지되는 동안 작동합니다. 연결을 제거하면, 스위치에서 이 OKX 계정을 먼저 다시 연결하라는 안내가 표시됩니다.
접근 권한 제거는 여러분의 손에 있습니다. Freya에서 키를 삭제하면 Freya의 사본만 제거되고 OKX에는 키가 남습니다. Freya가 OKX에서 제거하는 방법을 안내합니다. OKX 인증 페이지에서 FreyaFinance를 제거하면 OKX의 키가 삭제되어, OKX Spot과 OKX Futures가 즉시 작동을 멈춥니다.
자주 묻는 질문
OKX 빠른 연결은 안전한가요?
수동으로 키를 생성하는 것만큼 또는 그 이상으로 안전합니다. OKX가 계정 내에서 키를 생성하여 Freya 서버로 직접 전송하므로, 시크릿이 클립보드나 스크린샷에 남지 않습니다. OKX 자체 도메인에서 승인하며, 아무것도 생성되지 않은 상태에서 거부할 수 있습니다.
Freya가 내 OKX 비밀번호를 볼 수 있나요?
아닙니다. Freya가 아닌 OKX 사이트에서 로그인합니다. Freya는 OKX 로그인 정보를 수신하지 않습니다.
Freya가 내 자금을 출금할 수 있나요?
아닙니다. 키는 조회 및 거래 권한만 가지며, Freya는 출금이 가능한 키를 거부합니다. 자금은 오직 여러분의 직접적인 조작으로만 OKX 계정에서 출금할 수 있습니다.
패스프레이즈를 만들어야 하나요?
아닙니다. OKX 키에는 항상 패스프레이즈가 있지만, 빠른 연결에서는 Freya가 이를 설정하고 키와 함께 저장합니다. 직접 만든 키에만 자체 패스프레이즈가 필요합니다.
Spot과 Futures를 따로 설정해야 하나요?
아닙니다. 한 번의 승인으로 OKX Spot과 OKX Futures가 모두 추가됩니다. OKX에서 같은 키를 공유합니다.
연결하면 OKX 계정에 변경되는 것이 있나요?
Futures 봇이 작동할 수 있도록 두 가지 설정이 변경될 수 있습니다. 계정이 Spot 모드인 경우 계정 모드, 그리고 롱/숏으로의 포지션 모드입니다. Freya가 변경할 수 없는 경우 이를 알려줍니다. 또한 FreyaFinance라는 이름의 키가 하나 추가되며, 언제든지 OKX 인증 페이지에서 제거할 수 있습니다.
OKX 서브 계정을 사용할 수 있나요?
빠른 연결은 OKX 메인 계정용입니다. 서브 계정의 경우 해당 서브 계정 내에서 키를 생성하고 Manual Connection을 사용하세요.
수동 연결을 선호하는 경우에도 가능한가요?
네. Manual Connection 탭은 항상 사용할 수 있습니다. 패스프레이즈를 포함한 수동 연결 단계는 How to Connect Your Exchange to Freya Finance를 참고하세요.