메인 콘텐츠로 건너뛰기

바이낸스 API 키에 대해 "Symbol not whitelisted for API key" 오류가 나는 이유가 뭐야?

바이낸스에서 "심볼 미등록" 에러 발생? 서브 계정 설정에서 API 트레이딩 심볼 화이트리스트 활성화해줘.

작성자: Pete Darby
최소 2주 전에 업데이트됨

이 에러가 무엇을 의미하는지

이 오류는 Binance 서브 계정을 사용할 때 발생합니다. Binance의 API 거래 심볼 화이트리스트는 서브 계정의 현물/마진 API 거래를 마스터 계정에서 선택한 쌍으로 제한합니다. 봇이 화이트리스트에 없는 쌍으로 거래를 시도하면 이 오류가 발생합니다.

심볼 화이트리스트 설정 방법

1. Binance 계정에 로그인하고 [프로필][서브 계정]을 클릭하세요.

Cryptohopper 문제 해결 가이드: Binance 프로필 메뉴에서 API 화이트리스트 설정을 위한 서브 계정 옵션 표시, 프로필 아이콘을 통해 심볼 미등록 거래 봇 오류 해결 경로

2. 왼쪽에 있는 [서브 계정] 아래의 [API 관리]로 이동하세요. 심볼 화이트리스트를 활성화하려는 서브 계정을 찾은 후 옆의 [수정]을 클릭하세요.

3. API 관리 페이지로 이동됩니다. [수정]을 클릭한 다음 [심볼 화이트리스트 활성화] 옆의 체크박스를 선택하세요.

Cryptohopper 설정 가이드: Binance API 관리 수정 패널에 '심볼 화이트리스트 활성화' 체크박스와 수정 버튼이 표시되고, 자동 거래 봇 설정을 위한 API 보안 설정 및 제한 사항 포함

4. 화이트리스트 쌍을 설정하려면 [심볼 화이트리스트 활성화] 옆의 [수정]을 클릭하세요. 여기서 심볼 쌍을 검색할 수 있습니다. 쌍을 화이트리스트에 추가하려면 [추가]를 클릭하세요. 서브 계정 API당 최대 30개의 쌍을 추가할 수 있습니다.

Cryptohopper 설정 가이드: Binance 현물 & 마진 심볼 화이트리스트 모달에 BTC 거래 쌍 선택 및 추가/제거 옵션, 검색 기능, 거래 봇 API 설정을 위한 30개 쌍 제한 공지 표시

5. 가장 인기 있는 쌍도 볼 수 있습니다. 쌍을 화이트리스트에 추가하려면 [추가]를 클릭하세요.

Cryptohopper 통합 가이드: Binance 심볼 화이트리스트 인기 거래 쌍 보기, BTC/USDT, SOL/USDT, XRP/USDT, BNB/USDT, ETH/USDT 표시 및 자동 거래 봇 설정을 위한 추가 버튼

6. 즐겨찾는 거래 쌍을 보려면 [즐겨찾기에서 가져오기]를 클릭하고 화이트리스트에 추가하세요.

Cryptohopper 설정 가이드: Binance 심볼 화이트리스트 설정 화면에 '즐겨찾기에서 가져오기' 탭과 추가된 쌍(BTC/USDT, BTC/BUSD)이 표시되어 자동 거래 봇을 위한 즐겨찾는 거래 쌍 가져오기 시연

7. 화이트리스트에서 쌍을 제거하려면 해당 옆의 [제거] 또는 [x]를 클릭하세요. 쌍 선택이 끝나면 [확인]을 클릭하세요.

Cryptohopper 설정 가이드: Binance 심볼 화이트리스트 관리 화면에 거래 쌍 제거 버튼과 'x' 삭제 옵션이 표시되고, 자동 거래 봇 설정을 위한 화이트리스트 변경 사항 저장을 위한 확인 버튼

8. 화이트리스트에 등록된 쌍을 검토하려면 [수정]을 다시 클릭하세요. 확인 후 [API 관리] 페이지에서 [저장]을 클릭하세요.

Cryptohopper API 설정 가이드: Binance API 관리 최종 설정 화면에 저장 버튼이 강조 표시되고, 자동 거래 봇 통합을 위한 심볼 화이트리스트 활성화 및 API 제한 사항 표시

9. 2FA로 요청을 확인하세요.

Cryptohopper 보안 설정: Binance API 관리 보안 확인 모달에 인증 앱 및 이메일 옵션(0/2 완료)이 표시된 2단계 인증 요구 사항 표시, 거래 봇 API 설정용

이제 [심볼 화이트리스트 활성화] 상자가 선택된 것을 볼 수 있습니다. 이 서브 계정은 이제 API를 통해 현물/마진 시장에서 선택된 쌍만 거래할 수 있습니다.

Cryptohopper 통합 완료: Binance API 관리 페이지에 심볼 화이트리스트 체크박스가 성공적으로 활성화되었으며 자동 거래 봇에 대한 거래 가능 항목이 제한됨을 표시하고, 현물 및 마진 거래 쌍 제한 사항을 확인

API 거래 심볼 화이트리스트 정보

API 거래 심볼 화이트리스트를 사용하면 서브 계정의 현물/마진 거래를 마스터 계정에서 선택한 쌍으로만 제한할 수 있습니다. 일반 서브 계정에 API가 설정된 마스터 계정에서 사용할 수 있습니다.

제공하는 기능은 다음과 같습니다:

  • 유연한 거래 관리 — 거래 팀은 서브 계정별로 화이트리스트를 설정하여 특정 거래자에게 특정 쌍을 할당할 수 있습니다.

  • 강화된 보안 — API 키가 손상되더라도 무단 당사자는 화이트리스트에 없는 쌍으로 거래할 수 없습니다.

  • 쉬운 설정 — 거래 팀은 거래 쌍을 쉽게 찾고 선택하여 화이트리스트에 추가할 수 있습니다. 각 서브 계정 API는 최대 30개의 쌍을 지원합니다.

참고: 화이트리스트는 API 거래에만 영향을 미칩니다. 서브 계정은 Binance 웹사이트에서 직접 모든 쌍을 거래할 수 있습니다. 이 기능은 현재 일반 및 관리형 서브 계정에 대해서만 현물/마진 거래에 사용할 수 있습니다.

더 많은 서브 계정 정보는 서브 계정 기능 관리 및 자주 묻는 질문을 참조하세요.

답변이 도움되었나요?