봇을 생성한 후 “Invalid API Key” 오류가 표시되는 이유는 무엇인가요?

TradeSanta에서 봇을 생성할 때 때때로 다음 오류가 표시될 수 있습니다. “Invalid API Key.”

이 경우 봇은 트레이딩을 시작하지 않으며, “Stop Bot” 옵션 아래의 바가 빨간색으로 변합니다, 그리고 동일한 메시지인 Invalid API Key가 표시됩니다.

그렇다면 이 오류의 의미는 무엇이며 어떻게 해결할 수 있을까요?

⚙️ “Invalid API Key” 오류의 원인

이 오류는 일반적으로 API 키가 잘못된 권한으로 생성되었거나 또는 IP 화이트리스트가 올바르게 설정되지 않음을 의미합니다. 이는 거래소를 TradeSanta에 연결할 때 발생합니다.

즉, 설정이 누락되었거나 잘못되어 API 키가 TradeSanta의 트레이딩 데이터 액세스 또는 주문 실행을 허용하지 않는 상태입니다.

사용 중인 거래소에 따라 확인해야 할 사항을 살펴보겠습니다.

Binance를 연결했는데 “Invalid API Key”가 표시된다면, Binance의 API Management 페이지에서 다음 권한을 확인해 주세요:

필수 권한:

✅ Enable Reading — 반드시 on
✅ Enable Spot & Margin Trading — 반드시 on
❌ Enable Withdrawals — 반드시 off
❌ Enable Symbol Whitelist — 반드시 off
🔒 IP 주소 제한:
- 보안 강화를 위해 TradeSanta’s IP whitelist와 함께 Restricted로 설정되어야 합니다.

TradeSanta 계정의 다음 경로에서 고유 IP 리스트를 확인하실 수 있습니다:

Your exchanges → Binance → IP List.

모든 IP를 복사하여 Binance의 “Restrict access to trusted IPs only” 필드에 붙여넣었는지 확인하세요.

화이트리스트가 누락되었거나 잘못된 경우, API 키가 작동하지 않으며 봇에 Invalid API Key가 표시됩니다.

상세한 단계별 설정 방법은 여기에서 확인하실 수 있습니다:

Binance에서 API 키를 생성하는 방법

Binance/Binance Futures에서 IP 화이트리스트를 활성화하는 방법

HTX (구 Huobi)를 사용 중이라면, API Management 페이지를 열고 키 권한이 다음과 일치하는지 확인하세요:

필요한 권한:

권한이 잘못 설정되었거나 더 이상 편집할 수 없는 경우, 새 API 키를 생성하고 위의 올바른 옵션을 활성화했는지 확인하세요.

단계별 전체 설정 가이드는 여기에서 확인할 수 있습니다:

HTX에서 API 키를 생성하는 방법

만약 OKX를 연결하는 경우, 키 권한과 설정을 주의 깊게 확인하세요.

OKX에서 “Invalid API Key” 오류가 발생하는 일반적인 원인은 거래 권한 누락, 잘못된 Passphrase 또는 설정되지 않은 IP 화이트리스트입니다.

필요한 권한:

전체 설정 가이드는 여기에서 확인할 수 있습니다:

OKX에서 API 생성하는 방법

API 키가 잘못된 권한이나 IP로 생성되었고 더 이상 편집할 수 없는 경우 다음을 수행하세요:

기존 API 키를 새 키로 안전하게 교체하는 방법은 여기에서 배울 수 있습니다:

새 API 키로 액세스 포인트를 업데이트하는 방법

다시 연결하기 전에 다음을 확인하세요:

모든 설정이 올바르게 완료되면 TradeSanta에서 거래소를 다시 연결하세요. 그러면 봇이 성공적으로 거래를 시작할 것입니다.