읽기 전용 API 키: Kraken, Coinbase, OKX에서 체크할 권한
읽기 전용 API 키는 앱이 내 계정을 보기만 하고 거래나 출금은 할 수 없게 해요. Kraken, Kraken Futures, Coinbase, OKX의 정확한 권한과 IP 주소 제한을 알려 드려요.
읽기 전용 API 키는 플랫폼의 내 계정에 접근하는 키로, 잔고, 주문, 내역을 조회할 수 있지만 주문을 넣거나, 이체하거나, 출금할 수는 없어요.
키 권한이 중요한 이유
포트폴리오를 추적하는 앱은 나 대신 플랫폼을 호출하려고 내 키를 보관해요. 그 키가 유출되면 키의 권한이 넘어가고, 넘어가는 건 그 권한뿐이에요. Coinbase는 Transfer 권한에 대해 경고해요: 그런 키의 시크릿을 손에 넣은 사람은 내 가상자산을 모두 계정 밖으로 보낼 수 있어요. 읽기 전용 키는 내가 직접 보는 것만 보여 줘요.
플랫폼별 권한
| 플랫폼 | 줄 권한 | 주지 않을 권한 |
|---|---|---|
| Kraken | Query Funds, Query Open Orders & Trades, Query Closed Orders & Trades, Query Ledger Entries, Export Data | 입금, 출금, 그리고 주문을 만들거나 수정하거나 취소하는 모든 권한 |
| Kraken Futures | General API 읽기 전용 | General API 전체 접근, Withdrawal API 전체 접근 |
| Coinbase | View | Trade, Transfer |
| OKX | Read | Trade, Withdraw |
권한별로 할 수 있는 일
- Kraken: 조회 권한은 자금, 미체결 주문과 종료된 주문, 원장, 내보내기를 읽어요. 입금, 출금, 주문 권한은 계정에 직접 작용해요.
- Kraken Futures: 별도의 키예요. 읽기 전용이면 서버에 아무것도 쓰지 않는 엔드포인트만 열려요. 전체 접근을 주면 마스터 키가 되고, 출금은 별도 권한인 Withdrawal API 권한에 달려 있어요.
- Coinbase: View 권한은 계정을 조회하고, Trade 권한은 주문을 넣고, Transfer 권한은 자금을 보내요.
- OKX: Read 권한은 계정과 그 내역을 조회해요. Trade 권한은 주문을 넣고 취소하며, 자금을 옮기고, 설정을 바꿔요. Withdraw 권한은 출금해요.
키를 IP 주소로 제한하기
키를 특정 IP 주소로 제한할 수도 있어요. 다른 곳에서 온 호출이면, 올바른 시크릿이 있어도 플랫폼이 키를 거부해요.
- Kraken은 키마다 허용할 IP 주소 목록과 만료일을 정할 수 있게 해요.
- Coinbase는 IP 허용 목록을 권장하지만, 필수로 요구하지는 않아요.
- OKX는 키 하나에 IP 주소를 최대 20개까지 받아요. 거래나 출금이 가능한 키가 IP 주소에 묶여 있지 않으면, 14일 동안 쓰지 않을 때 만료돼요.
Hyperliquid: 키가 전혀 필요 없어요
Hyperliquid의 info 엔드포인트는 요청에 평문으로 담긴 어떤 주소에 대해서도 응답해요. 계정을 추적하려면 주소만 있으면 돼요. Hyperliquid는 API 지갑의 주소가 아니라 계정 자체의 주소를 넣으라고 안내해요. API 지갑 주소로는 빈 결과가 돌아와요.
나중에 키 점검하기
- 권한 다시 보기: 플랫폼의 API 페이지에 키마다 권한이 표시돼요.
- 안 쓰는 키는 삭제하기: 삭제한 키는 시크릿이 유출됐더라도 더는 아무 쓸모가 없어요.
- 의심스러운 키는 교체하기: 새 키를 만들어 앱에 넣고, 잘 작동하는지 확인한 다음, 예전 키를 삭제하세요.
CentraFIN이 키를 다루는 방법
- 보관하기 전에 확인: CentraFIN은 새 키의 권한을 Coinbase와 OKX에 물어보고, 거래, 이체, 출금이 가능한 키는 거부해요. Kraken은 이런 확인을 허용하지 않아서, 추가 창에 체크할 권한을 안내해요.
- 암호화: 키와 시크릿은 도착하자마자 암호화되고(AES-256-GCM), 다시는 표시되지 않아요.
- 주소는 하나: 요청은 저희 릴레이 130.110.240.91에서 나가요. 키에 허용할 주소가 바로 이 주소예요.
플랫폼마다 단계별로 안내해요: Kraken, Kraken Futures, Coinbase, OKX, Hyperliquid.
출처
- Kraken: API 키 만들기
- Kraken Futures: API 키 만들기
- Coinbase: API 키 인증
- OKX: API 키 생성
- Hyperliquid: info 엔드포인트
자주 묻는 질문
읽기 전용 키로 내 계정을 비울 수 있나요?
아니요. 주문도, 이체도, 출금도 할 수 없어요. 다만 키를 가진 사람에게 내 잔고와 내역은 보여요.
앱마다 키를 따로 만들어야 하나요?
그러는 편이 좋아요. 그러면 다른 키는 건드리지 않고 하나만 삭제할 수 있어요.
키를 IP 주소로 제한하는 이유는 뭔가요?
도난당한 키를 다른 곳에서는 쓸 수 없게 되기 때문이에요. 허용된 주소에서 오지 않은 호출은 플랫폼이 모두 거부해요.
CentraFIN은 내 키로 무엇을 보나요?
키로 조회할 수 있는 것: 잔고, 포지션, 주문, 체결, 이체예요. 그 이상은 없어요. 키로는 다른 일을 할 수 없으니까요.
내 자산을 직접 관리하세요
비밀번호 없이, 1분이면 계정이 준비돼요.