읽기 전용 API 키: Binance, Bybit, OKX
읽기 전용 API 키로 무엇을 할 수 있고 왜 안전한지. Binance, Bybit, OKX의 권한, MT5 투자자 비밀번호, IP 제한, 유출 대응.
읽기 전용 API 키는 잔고, 포지션, 거래 내역을 볼 수 있지만 주문, 이체, 출금은 할 수 없습니다. 그래서 매매일지나 세금 계산 도구에 맡겨도 됩니다. 도난당해도 드러나는 것은 데이터이지 계정이 아닙니다. 아래에서는 Binance, Bybit, OKX에서 어떤 권한을 켜 둘지, MetaTrader 5는 키 대신 무엇을 주는지, 언제 키를 IP 주소에 묶을지, 키가 유출되면 무엇을 할지 다룹니다.
읽기 전용 키로 할 수 있는 것
API 키는 키와 시크릿, 두 개의 문자열입니다. 프로그램은 이것으로 비밀번호 없이 거래소 계정에 들어가, 키의 권한이 허용하는 일을 합니다. 권한에는 세 종류가 있습니다.
- 읽기. 잔고, 포지션, 주문, 거래 내역.
- 거래. 사용자를 대신한 주문 접수, 정정, 취소.
- 출금과 이체. 계정 밖으로, 또는 계정 사이의 자금 이동.
거래할 수 있는 키는 이미 돈에 손댈 수 있는 열쇠입니다. 서비스나 내 컴퓨터에서 도난당하면 남이 내 계정으로 거래할 수 있고, 출금 권한까지 있으면 자금을 빼 갈 수도 있습니다. Binance도 제3자 플랫폼에 키를 입력하는 것은 보안 위험이라고 분명히 밝힙니다.
읽기 전용 키는 이 위험을 없앱니다. 그래도 데이터, 즉 거래 내역과 계정 규모는 드러납니다. 믿을 수 있는 서비스에만 주고, 서비스마다 별도의 키를 주십시오.
켜 둘 권한: Binance, Bybit, OKX, MetaTrader 5
거래소마다 이름이 다릅니다. 아래 그림은 2026년 10월 8일 기준 거래소와 MetaQuotes의 도움말과 문서를 따릅니다. 화면은 지역과 버전에 따라 다르므로 스크린샷이 아니라 도식입니다.
| 어디서 | 켜 둘 것 | 꺼 둘 것 | 서비스가 확인하는 방법 |
|---|---|---|---|
| Binance | Enable Reading | Enable Spot & Margin Trading, Enable Margin Loan, Repay & Transfer, Enable Futures, Enable Withdrawals | apiRestrictions 요청: enableReading = true, 다른 권한은 모두 false |
| Bybit | Read-Only | Read-Write | query-api 요청: readOnly = 1 |
| OKX | Read | Trade, Withdraw | account/config 요청: perm = read_only |
| MetaTrader 5 | 투자자 비밀번호 | 마스터 비밀번호 | 키 없음: 비밀번호 자체가 권한을 정함 |
매매일지나 분석 도구가 거래나 출금 권한을 달라고 하면 거절할 이유가 됩니다. 이런 서비스에 필요한 것은 읽기뿐입니다.
거래소별로 키를 만드는 방법
Binance
Binance는 먼저 세 가지를 요구합니다. 2단계 인증(2FA), 금액과 관계없는 현물 지갑 입금, 그리고 신원 인증 완료입니다.
- API Management를 엽니다. 프로필 아이콘 → Account → API Management.
- 키를 만듭니다. Create API → System generated를 고르고, 이름을 정한 뒤 2FA나 패스키로 확인합니다.
- 시크릿을 저장합니다. Secret Key는 만들 때만 보이고, 그 뒤에는 가려집니다.
- 권한을 확인합니다. Edit restrictions에서 Enable Reading만 체크되어 있어야 합니다. 기본으로 켜져 있습니다.
2023년 1월 30일부터 IP 제한이 없는 시스템 생성 키는 읽기만 할 수 있습니다. Binance는 IP 주소에 묶인 키에서만 출금을 허용합니다.
Bybit
키는 웹사이트에서만 만들 수 있고 앱에서는 만들 수 없습니다. 새 계정은 처음 48시간 동안 키를 만들지 못할 수 있습니다.
- API Management를 엽니다. 오른쪽 위의 프로필 아이콘 → API.
- 키를 만듭니다. Create New Key → System-generated API Keys → API Transaction을 고르고 이름을 정합니다.
- Read-Only를 고릅니다. 다른 선택지인 Read-Write는 거래를 허용합니다.
- 항목을 체크합니다. 예를 들어 Unified Trading. Read-Only 키는 체크한 항목을 읽기만 합니다.
- 확인하고 시크릿을 저장합니다. Google Authenticator 코드를 입력하면 API Key와 API Secret이 나옵니다. 시크릿은 한 번만 보입니다.
OKX
- API 섹션을 엽니다. 프로필 → API. 웹사이트에서는 API and connections라고 되어 있을 수 있습니다. Create API key를 클릭합니다.
- 양식을 채웁니다. 이름, 계정(메인 또는 서브계정), 키의 용도.
- 권한은 Read 하나만 둡니다. Trade와 Withdraw는 꺼 둡니다.
- 패스프레이즈를 정합니다. 키 자체의 비밀번호입니다. 나중에 다시 볼 수 없으므로, 잃어버리면 키를 삭제하고 새로 만들어야 합니다.
- 세 문자열을 모두 저장합니다. API key, Secret key, Passphrase.
일부 지역에서는 계정 자산이 $100를 넘어야 OKX에서 키를 만들 수 있습니다. 유럽경제지역과 미국 거주자에게는 별도의 OKX 사이트가 있으며, 그 사이트의 키는 eea.okx.com과 us.okx.com을 통해 작동합니다. 서비스가 자신의 사이트를 지원하는지 확인하십시오.
MetaTrader 5: 투자자 비밀번호
MetaTrader 5 계좌에는 비밀번호가 두 개 있습니다. 마스터 비밀번호는 모든 권한을 줍니다. 투자자 비밀번호로는 계좌를 보고 시세를 분석할 수 있지만 거래는 할 수 없습니다. 매매일지가 키 대신 받는 것이 바로 이 비밀번호입니다.
투자자 비밀번호는 터미널에서 바꿀 수 있습니다. Tools → Options → Server 탭 → Change → Change investor password. 브로커가 마스터 비밀번호 변경을 강제하면 투자자 비밀번호도 초기화됩니다.
키를 IP 주소에 묶어야 합니까?
IP 제한은 지정한 주소에서 온 요청만 키가 받도록 하는 것입니다. 거래소들은 이를 권장합니다. IP에 묶인 키는 도난당해도 남의 컴퓨터에서는 작동하지 않습니다.
규칙은 간단합니다. 서비스가 IP 주소를 공개한다면 그 주소를 입력합니다. 공개하지 않는다면 읽기 전용 키는 묶지 않아도 됩니다. 어차피 거래도 출금도 할 수 없기 때문입니다. 다만 거래소마다 IP에 묶이지 않은 키에 대한 제한이 따로 있습니다.
| 거래소 | IP에 묶이지 않은 키 |
|---|---|
| Bybit | 90일 뒤, 또는 계정 비밀번호를 바꾸고 7일 뒤 작동을 멈춤 |
| Binance | 30일 동안 쓰지 않으면 삭제 |
| OKX | Trade나 Withdraw 권한이 있는 키는 14일 동안 쓰지 않으면 삭제 |
키를 계속 쓰는 서비스라면 Binance의 30일 규칙에 걸리지 않습니다. 하지만 Bybit에서는 IP에 묶이지 않은 키가 90일 뒤 작동을 멈춥니다. 거래소별로 매매일지를 연결할 때 무엇을 고를지, Bybit 키를 어떻게 연장하는지는 Binance, Bybit, OKX 연결 페이지에서 다룹니다.
키가 유출되었을 때 할 일
Bybit는 시크릿을 절대 두면 안 되는 곳을 나열합니다. 스크린샷과 동영상, 공개 소스 코드와 저장소, 보안되지 않은 채널로 보내는 메시지입니다. 시크릿이 다른 사람에게 갔을 가능성이 있다면 다음과 같이 합니다.
- 즉시 키를 삭제합니다. Binance는 API Management에서, Bybit는 Action 열의 Delete로(웹사이트에서만), OKX는 API 섹션에서 삭제합니다. 삭제된 키는 누구에게도 작동하지 않습니다.
- 비밀번호 변경만으로는 부족합니다. Bybit에서 IP에 묶이지 않은 키는 계정 비밀번호를 바꾼 뒤에도 7일 동안 작동합니다. 키를 끄는 방법은 삭제뿐입니다.
- 내역을 확인합니다. 최근 며칠간의 주문, 거래, 이체, 출금. OKX에서는 Security Center가 IP에 묶이지 않고 Trade나 Withdraw 권한이 있는 키가 언제 쓰였는지 보여 줍니다.
- 새 키를 만듭니다. 읽기 전용으로, 서비스마다 따로 만듭니다. 그래야 한 곳에서 유출되어도 모든 곳을 고칠 필요가 없습니다.
- 거래소 고객지원에 연락합니다. 내가 하지 않은 거래나 출금이 보인다면 그렇게 하십시오.
키를 넘기기 전 체크리스트
- 권한은 하나, 읽기. 키를 만드는 중에만 보지 말고, 만든 뒤 API 페이지에서 다시 확인하십시오.
- 서비스마다 키 하나. 더 이상 필요 없는 키는 다른 키를 건드리지 않고 삭제할 수 있습니다.
키로 연결된 매매일지는 수수료, 펀딩비, MAE와 MFE까지 거래를 직접 기록합니다. 매매일지를 직접 작성한다면 키는 필요 없습니다. Excel용 매매일지 템플릿이면 충분하고, 무엇을 기록할지는 매매일지 쓰는 법에서 다룹니다.
출처
- Binance: How to Create API Keys on Binance?: 요건, 단계, Enable Reading. 2023년 1월 30일부터 IP 제한이 없는 키는 읽기만 가능. 출금에는 IP 제한이 필요.
- Binance: Frequently Asked Questions on API: Secret Key는 만들 때만 보임. 제3자 플랫폼은 보안 위험.
- Binance: How to Use an API Key Securely: IP에 묶이지 않고 30일 동안 쓰지 않은 키는 삭제. 용도마다 키 하나. 유출이 의심되면 즉시 키 교체.
- Binance Developers: Wallet Quick Start: 새 키의 기본 제한은 Enable Reading.
- Binance Developers: Margin Trading Best Practice: Enable Spot & Margin Trading과 Enable Margin Loan, Repay & Transfer 권한.
- Binance: How to Create an API Key for a Futures Lead Trading Portfolio?: Edit restrictions 버튼과 Enable Futures 권한.
- Binance: How to Download and Set up Binance Gift Card API: Enable Withdrawals 권한.
- Binance Developers: Get API Key Permission: apiRestrictions 요청과 그 필드.
- Bybit: How to Create Your API Key?: 웹사이트에서만, 새 계정은 48시간, API Management 단계.
- Bybit EU: What Is API Trading and How to Set It Up: Read-Only와 Read-Write, IP whitelisting과 No IP restriction, IP에 묶이지 않은 키는 90일, 시크릿은 한 번만 보임, 시크릿을 두면 안 되는 곳.
- Bybit API: Create Sub UID API Key: IP에 묶이지 않은 키는 90일 뒤, 또는 비밀번호 변경 7일 뒤 작동 중지.
- Bybit API: Get API Key Information: query-api 요청과 readOnly 필드.
- Bybit: How to Delete Your API Key: Action 열의 Delete, 웹사이트에서만.
- OKX: API FAQ: 키 만들기, 패스프레이즈, $100 조건, EEA와 미국 사이트, IP에 묶이지 않은 키의 만료.
- OKX API v5 documentation: Read, Trade, Withdraw 권한. IP 주소 최대 20개. Trade나 Withdraw가 있는 묶이지 않은 키는 14일. Security Center. account/config 요청과 perm 필드.
- MetaTrader 5 Help: Connect to an Account: 마스터 비밀번호와 투자자 비밀번호, 투자자 접속으로 할 수 있는 것.
- MetaTrader 5 Help: Platform Settings: Server 탭에서 투자자 비밀번호 변경.
버튼 이름은 거래소의 영문 사이트 기준입니다. 다른 언어와 지역별 사이트에서는 표기가 다를 수 있으며, 거래소는 수시로 페이지 디자인을 바꿉니다.
