트레이딩 봇이 API 키를 통해 접근할 수 있는 암호화폐 데이터는 무엇인가요?

트레이딩 봇의 API 키는 비밀번호가 아닙니다. 이는 범위가 지정된 권한 증명서와 같습니다. 거래소는 세 가지 기능, 즉 계정 데이터 읽기, 거래 주문 및 취소, 자금 출금 중에서 정확히 원하는 기능만 활성화할 수 있게 해줍니다. 그리고 올바르게 설정된 트레이딩 봇은 이 중 처음 두 가지 권한만 받습니다. 세 번째인 출금 권한은 봇이 정당하게 가질 이유가 없는 유일한 권한이며, 모든 주요 거래소에서는 이 권한을 비활성화 상태로 둘 수 있습니다.

모든 거래소가 제공하는 세 가지 등급

Binance, Bybit, OKX, Kraken, 그리고 Gate.io는 각자의 설정 메뉴에서 어떻게 명명하든 모두 동일한 세 가지 기능 범위로 API 접근 권한을 구분합니다:

Read와 trade 권한만 있으면 봇이 해야 할 모든 일을 수행할 수 있습니다. 즉, Market을 확인하고, 포지션을 열고, 조정하고, 마감할 수 있습니다. Withdrawal 권한은 자금을 거래소 밖으로 완전히 이동시키는 것으로, 전략 실행과는 전혀 관련이 없습니다. 이는 독립적인 보안 연구자들도 동일하게 지적하는 부분입니다. 한 서드파티의 거래소 API 권한 분석에서도, 거래 권한은 어떤 봇이든 사실상 피할 수 없지만, withdrawal은 "가장 위험한 권한"이며 어떤 플랫폼이 요청하더라도 반드시 비활성화해야 한다고 명시하고 있습니다.

선물 봇에서 "거래"가 실제로 포함하는 범위

현물 봇의 경우, 거래 권한은 간단합니다: 매수/매도 주문을 제출하고 취소하는 것입니다. 선물 거래는 같은 "거래" 범주 내에서 약간 더 많은 권한이 필요합니다 — COMBO 또는 DCA Futures 전략을 실행하는 봇은 포지션을 개시하고 청산해야 하며, 일반적으로 전략 실행의 일환으로 해당 포지션의 레버리지와 마진도 조정해야 합니다. 이 모든 과정은 여전히 거래 권한 범위 내에 있으며, 출금 권한이 필요하지 않고, 봇이 거래소에서 원금 담보를 외부로 이동시킬 수 있는 권한도 부여하지 않습니다. 선물 거래가 가능한 키를 연결할 경우, 해당 거래소에서 거래 권한에 레버리지/마진 조정이 포함되어 있음을 확인할 수 있습니다 — 이는 동일한 권한 등급의 정상적인 일부이며, 별도의 더 위험한 권한이 아닙니다.

실제로 유출된 키를 무력화하는 권한: IP 화이트리스트 설정

권한 범위만이 유일한 조정 수단은 아닙니다. 대부분의 거래소에서는 API 키를 특정 IP 주소로 제한할 수 있도록 허용하므로, 키 문자열이 유출되더라도 다른 곳에서는 사용할 수 없습니다. 한 분석에 따르면, "공격자가 문자열을 탈취하더라도 정확히 그 주소에서 전송하지 않는 한 아무것도 할 수 없다"고 합니다. Binance는 한 걸음 더 나아가 이를 기본값으로 적용합니다. IP 제한이 설정되지 않은 경우, 90일이 지나면 해당 키의 거래 권한이 자동으로 해제됩니다. 이는 권한 등급과는 별개로 반드시 알아두어야 할 사항입니다. 또한, 사용자의 설정에 다른 변화가 없는데도 봇이 조용히 거래를 멈추는 가장 흔한 이유 중 하나이기도 합니다(이런 일이 발생했다면 why did my bot stop trading을 참고하세요).

왜 "trade-only"가 단순한 마케팅 문구가 아닌가

플랫폼이 봇이 trade-only 키로 실행된다고 말할 때, 이는 구체적이고 검증 가능한 주장입니다. 출금 토글이 꺼져 있고, 이를 강제하는 것은 봇 플랫폼이 아니라 거래소 자체입니다. Bitsgap의 자체 키 요청은 읽기 및 거래 권한만 요구합니다. 만약 거래소에서 출금이 활성화된 키를 생성해 연결하려고 하면, 이는 사용자가 부여한 권한과 플랫폼이 요구하는 권한이 일치하지 않는 것이지, 플랫폼이 더 많은 권한을 필요로 한다는 의미가 아닙니다. 보다 깊은 보안 관점—trade-only 키가 유출되었을 때 어떤 일이 발생하는지, 그리고 단순한 권한 토글보다 비수탁(non-custodial) 상태가 왜 더 중요한지—에 대해서는 거래소 API를 트레이딩 봇에 연결해도 안전한가요?를 참고하세요.

읽기 전용이 실제로 보여주는 것

읽기 전용 키는 거래 권한이 없어도 사람들이 생각하는 것보다 더 많은 정보를 드러냅니다. 모든 자산의 전체 잔고, 완전한 주문 내역, 보유 중인 포지션, 때로는 입금 주소까지 확인할 수 있습니다. 자금에는 위험이 없지만, 개인정보 노출이라는 점에서 주의가 필요합니다. 신뢰할 수 있는 서비스에만 읽기 전용 키를 제공하고, 서드파티 분석 도구가 어떤 권한을 요구하는지 반드시 확인해야 하는 이유입니다.

자신의 키 권한 범위 확인

위에 언급된 다섯 개 거래소 중 어느 곳이든, API 관리 페이지에서는 각 키의 활성화된 권한이 보통 토글이나 배지 형태로 나란히 표시됩니다. 만약 봇을 위해 생성한 키에서 출금 권한이 활성화되어 있다면 즉시 조치해야 합니다 — 해당 키를 삭제하고, 읽기 및 거래 권한만 활성화된 새 키를 생성한 뒤, 거래소에서 지원한다면 IP 제한도 추가하고 다시 연결하세요. 봇의 실제 동작은 변하지 않지만, 해당 키가 유출될 경우의 위험성은 달라집니다.

여러분이 한 번도 건드리지 않은 권한 토글이야말로, 유출된 키가 단순한 골칫거리가 될지 아니면 치명적인 재앙이 될지를 결정합니다.

FAQ

트레이딩 봇의 API 키가 내 자금을 거래소 밖으로 이동시킬 수 있나요? 아니요, 올바르게 범위가 지정된 경우에는 그렇지 않습니다. 출금은 별도의 선택적 권한이며, 트레이딩 봇이 실제로 필요로 하지 않는 기능입니다 — Bitsgap의 키 요청에서는 이 권한을 절대 요구하지 않습니다.

읽기 권한과 거래 권한의 차이점은 무엇인가요? 읽기 권한은 프로그램이 사용자의 잔고, 주문, 거래 내역을 조회할 수 있게 해줍니다. 거래 권한은 주문을 생성하거나 취소할 수 있게 해줍니다. 봇은 두 권한 모두 필요하며, 어느 쪽도 출금 권한은 제공하지 않습니다.

선물 봇이 읽기 및 거래 권한 외에 추가 권한이 필요한가요? 아닙니다. 선물 포지션의 레버리지 및 마진 조정은 동일한 거래 권한에 포함되며, 별도의 고위험 권한이 아니고 출금 권한도 부여하지 않습니다.

내 API 키에 이미 출금 권한이 없다면 IP 화이트리스트가 정말 중요한가요? 네, 중요합니다. IP 화이트리스트는 해당 키가 가진 권한의 오용을 방지합니다. 거래 전용 키가 유출되더라도, 해당 키가 귀하의 IP 주소로 제한되어 있다면, 키 문자열 자체를 가지고 있더라도 다른 사람은 사용할 수 없습니다.

읽기 전용 API 키는 완전히 안전할까요? 자금을 이동시킬 수는 없지만, 해당 키를 가진 사람에게는 잔고와 거래 내역이 노출됩니다. 보고 도구처럼 명확하게 필요로 하는 서비스에만 읽기 권한을 부여하세요.