제휴 안내: 이 글에는 OKX 파트너 링크가 포함되어 있습니다. 해당 링크를 통해 가입·거래하면 운영자에게 수익이 발생할 수 있습니다. 이용자 혜택은 계정·지역·VIP 등급·캠페인에 따라 달라질 수 있으므로 가입 화면과 My Rewards에서 실제 적용 조건을 확인하세요.
결론부터 말하면, OKX API 키는 외부 앱이나 거래 봇이 내 계정 정보를 읽거나 주문을 실행하도록 허용하는 인증 수단입니다. 만들 때는 목적에 필요한 최소 권한만 선택하고, 신뢰하는 고정 IP를 연결하며, Secret Key와 Passphrase를 다시 볼 수 없는 비밀정보로 관리해야 합니다. 출금 권한이 없어도 탈취된 Trade 권한으로 큰 손실이 발생할 수 있으므로 사용하지 않는 키는 즉시 폐기해야 합니다.
보안·거래 위험: API 키는 자동 수익 기능이 아닙니다. Trade 권한이 노출되면 출금 권한이 없어도 불리한 가격의 주문, 과도한 레버리지, 반복 매매로 자산이 손실될 수 있습니다. 선물 API 주문은 증거금 부족과 강제청산 위험이 있으며, IP 제한과 2FA도 잘못된 권한 부여나 악성 제3자 앱의 위험을 완전히 없애지 못합니다. 상품·권한·화면은 지역과 계정에 따라 다를 수 있습니다.
OKX API 키란?
OKX API 키는 프로그램이 OKX 계정에 인증된 요청을 보내도록 만드는 자격 증명입니다. 일반적으로 API Key, Secret Key, Passphrase가 한 묶음이며, 각각이 모두 일치해야 개인 계정 데이터 조회나 주문 요청이 승인됩니다. 비밀번호를 공유하는 방식이 아니라 용도별 키와 권한을 따로 만들 수 있다는 장점이 있지만, 권한 범위를 넓게 주면 사고 범위도 커집니다.
공식 도움말은 API 키가 외부 앱과 플랫폼의 계정 정보 조회 및 자동 주문에 사용된다고 설명합니다. 다만 이용 가능한 기능은 계정 유형, 하위 계정, 지역, 상품 자격과 현재 화면에 따라 달라질 수 있으므로 이 글의 메뉴 이름보다 로그인 후 표시되는 OKX 화면을 우선하세요.
Read·Trade·Withdraw 권한 차이
| 권한 | 가능한 작업 · 주요 위험 · 권장 원칙 |
|---|---|
| Read | 가능한 작업: 잔액·주문·포지션 등 허용된 계정 데이터 조회 주요 위험: 보유 자산과 거래 전략 등 민감한 계정 정보 노출 권장 원칙: 조회만 필요한 대시보드에는 Read만 부여 |
| Trade | 가능한 작업: 주문 제출·취소, 내부 자금 이체와 쓰기 설정 등 해당 API가 허용한 작업 주요 위험: 무단 매매, 레버리지 확대, 수수료 누적, 청산 권장 원칙: 자동매매가 꼭 필요한 키에만 부여하고 별도 하위 계정 검토 |
| Withdraw | 가능한 작업: API를 통한 출금 주요 위험: 자산이 외부 주소로 이동할 수 있는 가장 큰 위험 권장 원칙: 일반 거래 봇에는 부여하지 말고 명확한 업무 필요가 있을 때만 검토 |
| Transfer·Loan·Earn 등 | 가능한 작업: 계정 간 이체, 대출·상환, Earn 구독·상환 등 표시된 기능 주요 위험: 거래 외 자금 배치와 부채·상품 상태 변경 권장 원칙: 계정에 실제로 표시된 권한을 하나씩 재검토 |
Read-only도 무위험은 아닙니다. 잔액, 주문 기록과 포지션이 유출되면 피싱이나 표적 공격에 악용될 수 있습니다. 반대로 Withdraw를 끈 Trade 키도 안전하다고 단정할 수 없습니다. 유동성이 낮은 거래쌍에서 반복 주문을 내거나 선물 레버리지를 높이면 거래만으로 큰 손실을 유발할 수 있습니다.
2026년 9월 28일 업데이트된 OKX API FAQ는 Transfer·Loan·Earn 세부 권한을 설명하고, 이전에 Trade 권한이 활성화된 키에는 해당 업데이트에 따라 이 세 권한이 자동 활성화될 수 있음을 안내합니다. Loan·Earn은 해당 기능을 사용할 자격이 있는 계정에 한합니다. 기존 키도 현재 API 관리 화면에서 실제 권한을 다시 확인하세요. 기술 문서의 큰 권한 분류만 보고 이체·대출·상품 동작이 불가능하다고 단정하면 안 됩니다.
API 키를 만들기 전에 정할 것
- 목적: 잔액 조회, 거래 봇, 자체 프로그램, 세금·회계 도구 중 무엇인지 한 문장으로 적습니다.
- 계정 범위: 메인 계정 전체가 필요한지, 잔액을 분리한 하위 계정으로 충분한지 결정합니다.
- 권한: 목적에 필요한 최소 권한만 선택합니다.
- IP: 프로그램이 사용하는 신뢰 가능한 고정 공인 IP를 확인합니다. 공유·임시 IP를 추측해 넣지 않습니다.
- 보관 위치: Key·Secret·Passphrase를 코드, 스크린샷, 메신저, 공개 저장소에 남기지 않을 방법을 정합니다.
- 폐기 기준: 프로젝트 종료, 담당자 변경, 의심 주문, 기기 침해가 발생하면 누가 언제 키를 삭제할지 정합니다.
거래 전략을 계정 전체와 분리하려면 하위 계정이 도움이 될 수 있습니다. 그러나 하위 계정도 손실을 막아 주는 보험이 아니며, 내부 이체 권한과 메인 계정 연결 구조를 함께 확인해야 합니다. 계정 전반의 보안 설정은 OKX 안전성·계정 보안 가이드에서 확인할 수 있습니다.
OKX API 키 생성 방법
웹에서 만드는 순서
- OKX에 로그인하고 Profile → API and connections 또는 현재 계정에 표시되는 API 메뉴를 엽니다.
- Create API key를 선택합니다.
- 키 이름을 입력하고 연결할 메인 계정 또는 하위 계정을 확인합니다.
- 사용 목적과 필요한 권한을 선택합니다.
- 가능하면 프로그램의 신뢰 IP를 허용목록에 연결합니다.
- 새 Passphrase를 만들고 비밀 관리 도구에 저장합니다.
- OKX 계정의 2FA 인증을 완료합니다.
- 생성 직후 API Key와 Secret Key를 지정한 안전한 위치에 한 번만 저장하고 화면을 닫습니다.
앱에서 만드는 순서
2026년 10월 24일 확인한 OKX 공식 API FAQ는 앱에서 Menu → API → Create API key 경로를 제시합니다. 앱 버전과 지역에 따라 API 메뉴가 Tools 또는 다른 하위 메뉴에 보일 수 있습니다. 메뉴가 보이지 않는다면 비공식 앱이나 우회 경로를 찾지 말고, 앱 배포자와 업데이트 상태 및 내 계정의 기능 제공 여부를 공식 지원에서 확인하세요.
일부 지역·계정에는 API 발급을 위한 별도 자격이나 자산 기준이 적용될 수 있습니다. 기능이 보이지 않으면 현재 계정의 공식 안내와 고객지원에서 확인하고, API 발급을 위해 불필요하게 입금하거나 다른 지역·신원으로 우회하지 마세요.
API 키 생성 화면의 Account 항목이 잠겨 있어도 오류라고 단정할 수 없습니다. 공식 FAQ에 따르면 연결된 하위 계정이 없는 메인 계정에서는 Main account로 미리 선택되어 잠겨 있을 수 있습니다.
IP 허용목록과 Passphrase 설정
OKX 공식 API FAQ는 키 하나에 최대 20개 IP 주소를 쉼표 또는 공백으로 구분해 연결할 수 있다고 안내합니다. IP 제한은 허용되지 않은 네트워크에서 키를 쓰는 것을 막는 중요한 통제지만, Secret과 Passphrase가 노출된 상태를 방치해도 된다는 뜻은 아닙니다.
- 서버의 실제 공인 고정 IP를 인프라 담당 화면에서 확인합니다.
- 개인용 VPN이나 수시로 바뀌는 가정용 IP를 고정 IP로 추측하지 않습니다.
- 더 이상 사용하지 않는 서버 IP는 즉시 제거합니다.
- 제3자 봇이 안내한 IP가 그 업체의 공식 문서와 일치하는지 도메인과 지원 채널을 대조합니다.
- 여러 서비스에 같은 API 키를 재사용하지 않습니다.
Passphrase는 OKX 로그인 비밀번호가 아닙니다. 사용자가 API 키 생성 시 정하는 별도 문자열이며, 공식 FAQ는 잊어버린 Passphrase를 복구할 수 없다고 설명합니다. 분실했다면 기존 키를 삭제하고 새 키를 만들어야 합니다. Secret Key와 Passphrase를 코드 파일에 직접 적거나 브라우저 자동 저장, 화면 캡처, 이메일로 보관하지 마세요.
14일 비활성 자동 삭제 조건
2026년 10월 24일 확인한 API V5 보안 문서에 따르면 일반 API 키는 IP 미연결, Trade 또는 Withdraw 권한 보유, 14일 비활성 조건이 함께 성립할 때 만료됩니다. 공식 FAQ는 이 경우 자동 삭제로 안내합니다. 인증이 필요한 잔액·계정 내역·주문 API 호출은 사용으로 계산되지만, 인증이 필요 없는 시세 API에 키를 함께 보냈다는 이유만으로 활동으로 계산되지는 않습니다.
WebSocket은 로그인 동작만 키 사용으로 계산하며 로그인 이후의 구독·주문만으로 사용 시점이 갱신된다고 가정하면 안 됩니다. 공식 문서는 데모 트레이딩 API 키는 이 만료 규칙의 예외라고 명시합니다. 상태·사용 기록은 현재 API 목록과 Security Center에서 확인하세요.
따라서 “키를 만들었으니 계속 존재한다”고 가정하지 말고 Profile의 API 목록에서 상태를 확인하세요. 반대로 자동 삭제를 보안 관리 대신으로 사용해서도 안 됩니다. 프로젝트가 끝났거나 노출이 의심되는 키는 14일을 기다리지 말고 즉시 직접 폐기해야 합니다. 읽기 전용·IP 연결 키의 만료 조건도 현재 계정 화면과 최신 공식 FAQ를 우선하세요.
거래 봇 연결 시 최소 권한 예시
| 사용 사례 | 필요 가능성이 높은 권한 · 보통 불필요한 권한 · 추가 통제 |
|---|---|
| 잔액·성과 대시보드 | 필요 가능성이 높은 권한: Read 보통 불필요한 권한: Trade, Withdraw 추가 통제: 전용 키, 신뢰 IP, 정기 폐기 |
| 현물 주문 봇 | 필요 가능성이 높은 권한: Read, Trade 보통 불필요한 권한: Withdraw 추가 통제: 거래쌍·주문 한도, 별도 하위 계정 |
| 선물 주문 봇 | 필요 가능성이 높은 권한: Read, Trade 보통 불필요한 권한: Withdraw 추가 통제: 낮은 레버리지, 격리·교차 확인, 최대 손실 한도 |
| 세금·회계 내역 수집 | 필요 가능성이 높은 권한: Read 보통 불필요한 권한: Trade, Withdraw 추가 통제: 내보내기 기간 제한, 제공자 보안 검토 |
| 자체 출금 시스템 | 필요 가능성이 높은 권한: 업무상 필요한 경우에만 Withdraw 검토 보통 불필요한 권한: 목적과 무관한 모든 권한 추가 통제: 주소·금액 통제, 별도 계정, 다중 승인과 모니터링 |
선물 자동매매는 주문 코드가 정상 동작해도 시장 위험이 남습니다. 포지션 방향, 계정 모드, 마진 방식, 레버리지와 예상 청산가를 이해하지 못했다면 OKX 선물거래 초보자 가이드를 먼저 확인하고 실제 자금 전 데모 환경에서 주문 흐름을 시험하세요.
API와 거래 수수료 계산
API로 주문한다고 거래 수수료가 없어지지는 않습니다. 주문이 Maker 또는 Taker로 체결되는지, 현물·선물 상품, VIP 등급과 계정 조건에 따라 현재 수수료가 적용됩니다. 자동매매는 주문 횟수가 많아 비용 누적을 놓치기 쉬우므로 전략 손익에서 수수료를 별도로 계산해야 합니다.
가정 계산: 한쪽 체결 명목금액이 10,000 USDT이고 설명용 요율이 0.05%라면, 0.05% = 0.0005이므로 한쪽 거래 수수료는 10,000 × 0.0005 = 5 USDT입니다. 동일 금액·동일 요율로 진입과 종료를 100회씩 체결했다고 가정하면 5 × 2 × 100 = 1,000 USDT입니다.
이는 두 방향의 명목금액과 요율이 모두 같고 수수료를 USDT로 계산한다는 가정이며 실제 OKX 요율을 제시한 것이 아닙니다. 실제 계산은 계정의 Maker/Taker 요율·실제 체결 금액·부과 통화와 반올림을 적용합니다. 파생상품은 증거금만으로 계산하지 않으며 펀딩비·스프레드·슬리피지·출금비용·리베이트·매매 손익은 위 합계에서 제외했습니다.
추천코드 혜택과 API 권한은 별개입니다. 코드 OKDCC의 적용 가능한 수수료 혜택은 가입 전 화면과 가입 후 My Rewards에서 확인해야 하며 계정·지역·VIP·캠페인에 따라 달라질 수 있습니다. 확인 절차는 OKX 레퍼럴 코드 OKDCC 가이드를 참고하세요.
데모 API 키와 실거래 키를 분리해야 하는 이유
OKX 공식 API FAQ는 데모 트레이딩용 API 키를 실거래 키와 별도 경로에서 만들도록 안내합니다. 데모 환경에서 성공한 요청이 실거래 계정의 체결, 유동성, 슬리피지와 손익을 보장하지 않습니다. 데모는 전용 키를 사용하고 요청에 x-simulated-trading: 1 헤더를 적용합니다. SDK를 사용한다면 해당 SDK의 데모 설정도 공식 문서대로 맞춰야 합니다. 실거래와 데모가 REST 호스트를 공유할 수 있으므로 주소가 같다는 이유만으로 같은 환경이라고 판단하지 마세요. 키·요청 헤더·SDK 설정·계정이 등록된 사이트를 함께 확인하세요.
- 데모와 실거래에 서로 다른 키 이름을 사용합니다.
- 프로그램 시작 로그에 환경을 표시하되 Secret은 출력하지 않습니다.
- 실거래 전 주문 수량·거래쌍·계정 모드·레버리지의 상한을 코드와 계정에서 이중 확인합니다.
- 데모 결과를 실제 수익률 예측이나 수익 보장으로 사용하지 않습니다.
환경별 주문 흐름과 연습 한계는 OKX 데모 트레이딩 안내에서 확인할 수 있습니다. 데모는 입출금 등 일부 기능을 지원하지 않으며 실거래 손실 가능성을 없애지 않습니다.
자주 발생하는 실패와 점검 순서
| 증상 | 먼저 확인할 항목 · 안전한 대응 |
|---|---|
| 인증 실패 | 먼저 확인할 항목: API Key·Secret·Passphrase 조합, 실거래/데모 환경 안전한 대응: 비밀값을 로그에 출력하지 말고 키 이름과 환경만 대조 |
| IP 관련 거부 | 먼저 확인할 항목: 서버의 실제 공인 IP와 허용목록 안전한 대응: 무분별하게 제한을 해제하지 말고 공식 인프라 IP만 수정 |
| 권한 부족 | 먼저 확인할 항목: Read·Trade 등 선택 권한과 요청 기능 안전한 대응: 오류 하나 때문에 Withdraw까지 모두 켜지 말고 필요한 권한만 추가 |
| 키가 목록에서 사라짐 | 먼저 확인할 항목: IP 미연결, 거래·출금 권한, 최근 14일 활동 안전한 대응: 기존 자격 증명을 반복 전송하지 말고 새 키가 필요한지 공식 화면에서 확인 |
| 주문 방향 오류 | 먼저 확인할 항목: 계정 모드와 posSide 등 현재 API 문서의 파라미터 안전한 대응: 실거래 재시도 전에 데모와 소액으로 설정을 검증 |
| 50101·50119 등 키/환경 오류 | 먼저 확인할 항목: 데모/실거래 키와 헤더, 계정 등록 사이트, 제공자의 공식 API 호스트 안전한 대응: 다른 지역 계정으로 우회하지 말고 현재 계정에 맞는 공식 문서·지원에서 확인 |
| 50004 등 주문 요청 시간 초과 | 먼저 확인할 항목: 주문이 실제 접수·체결됐는지 주문 ID·클라이언트 주문 ID와 주문 내역으로 확인 안전한 대응: 실패로 단정해 같은 주문을 즉시 중복 전송하지 않기 |
| 예상하지 않은 주문 | 먼저 확인할 항목: 키 사용 서비스, 활성 세션, 열린 주문·포지션 안전한 대응: 키 폐기, 봇 중지, 주문·포지션 확인과 계정 보안 점검을 즉시 진행 |
오류 메시지를 없애기 위해 모든 권한을 켜거나 IP 제한을 해제하는 방식은 안전한 해결이 아닙니다. 현재 OKX API 문서의 요청 파라미터와 계정 모드를 확인하고, 실패한 요청의 시간·엔드포인트·오류 코드만 기록하되 Key·Secret·Passphrase와 전체 계정 응답은 지원 게시판이나 공개 저장소에 올리지 마세요.
키 유출·이상 주문이 의심될 때
- 해당 API 키를 즉시 삭제하거나 폐기합니다.
- 연결된 봇과 서버 프로세스를 중지합니다.
- 열린 주문, 포지션, 내부 이체와 출금 내역을 확인합니다.
- 모르는 로그인 기기·세션·Passkey와 다른 API 키를 점검합니다.
- OKX 로그인 비밀번호와 2FA 상태를 안전한 기기에서 재검토합니다.
- 노출된 저장소·로그·메신저에서 비밀값을 제거하되, 이미 공개된 키는 재사용하지 않습니다.
- 새 키가 필요하다면 최소 권한·새 Passphrase·신뢰 IP로 다시 만들고 연결 서비스를 하나씩 복구합니다.
- 손실이나 무단 거래가 확인되면 주문 ID와 시간 등 비밀값을 제외한 증거를 보존해 OKX 공식 지원에 문의합니다.
키 삭제와 주문 정리는 별개의 확인입니다. 키를 폐기했다는 사실만으로 열린 주문이 모두 취소되거나 포지션이 종료됐다고 판단하지 마세요. 신뢰할 수 있는 기기의 공식 앱·웹에서 실제 주문·포지션·내부 이체 상태를 확인하고, 상황에 맞는 주문 관리와 공식 지원 절차를 따르세요. 이는 손실 회복이나 추가 손실 방지를 보장하는 절차가 아닙니다.
발급 전·후 체크리스트
- □ 키 목적을 한 문장으로 설명할 수 있는가?
- □ Read·Trade·Withdraw와 표시된 Transfer·Loan·Earn 등 실제 세부 권한을 검토했는가?
- □ 출금이 필요 없는 봇에서 Withdraw를 껐는가?
- □ 신뢰할 수 있는 실제 고정 IP를 연결했는가?
- □ Secret과 Passphrase를 코드·스크린샷·메신저에 남기지 않았는가?
- □ 데모와 실거래 키·요청 헤더·SDK 환경·계정 등록 사이트를 구분했는가?
- □ 주문 수량·거래쌍·레버리지·최대 손실 한도를 설정했는가?
- □ 미사용 키와 오래된 IP를 정기적으로 삭제하는가?
- □ 이상 주문 알림과 키 폐기 절차를 준비했는가?
- □ 수수료와 펀딩비를 전략 손익에 반영했는가?
자주 묻는 질문
OKX를 일반 앱이나 웹에서만 거래해도 API 키가 필요한가요?
아니요. API 키는 외부 프로그램·봇·데이터 도구를 연결할 때 사용합니다. 일반 OKX 앱과 웹에서 직접 거래하는 사용자에게 필수 설정이 아닙니다.
Read 권한만으로 주문을 넣을 수 있나요?
아니요. 공식 권한 구분상 주문 제출과 취소에는 Trade 권한이 필요합니다. 잔액·주문 기록 조회만 필요한 도구에는 Trade를 부여하지 않는 것이 최소 권한 원칙입니다.
Secret Key나 Passphrase를 잊으면 다시 볼 수 있나요?
공식 FAQ는 Passphrase를 복구할 수 없다고 안내합니다. Secret을 안전하게 저장하지 못했거나 노출이 의심되면 기존 키를 폐기하고 새 키를 만드는 것이 안전합니다.
OKX API 키는 14일 후 모두 만료되나요?
아닙니다. IP 미연결·Trade 또는 Withdraw 권한·14일 비활성이라는 조건이 함께 적용됩니다. 인증이 필요한 호출과 WebSocket 로그인만 공식 문서가 설명하는 활동으로 계산됩니다. 데모 트레이딩 키는 이 만료 규칙의 예외이며 실제 상태는 API 목록과 최신 공식 문서에서 확인해야 합니다.
거래 봇에 Withdraw 권한이 꼭 필요한가요?
일반적인 주문 실행만 하는 봇은 보통 Read와 Trade 범위에서 작동합니다. 제3자 서비스가 Withdraw를 요구한다면 왜 필요한지, 출금 주소·금액 통제가 무엇인지 확인하기 전에는 승인하지 마세요.
주문 요청이 시간 초과되면 다시 보내도 되나요?
시간 초과만으로 주문 실패가 확정되지는 않습니다. 공식 API FAQ의 50004 안내처럼 실제 주문 접수·체결 상태를 먼저 확인해야 합니다. 주문 ID 또는 클라이언트 주문 ID와 공식 주문 내역을 대조한 뒤 처리하고, 같은 주문을 즉시 중복 전송하지 마세요.
공식 자료와 검토일
- OKX: Subaccounts, Account Mode, and API Connections FAQ — 2026년 8월 27일 업데이트 표시 확인
- OKX API FAQ — 2026년 9월 28일 업데이트 표시 확인
- OKX: How do I enhance my OKX app security? — 2026년 9월 22일 업데이트 표시 확인
- OKX API V5 공식 문서 — 요청 파라미터와 최신 엔드포인트 확인용
최종 검토일: 2026년 10월 24일. API 메뉴, 권한, IP 제한, 비활성 삭제, 계정 모드와 상품 제공 조건은 바뀔 수 있습니다. 공식 사실과 AKEYX의 안전 운영 예시는 구분해서 읽고, 실제 작업 전에는 로그인한 계정 화면과 최신 OKX API 문서를 다시 확인하세요.