Bitget API 연동 가이드
이 문서는 Bitget에서 API Key를 만들고 UFOX에 안전하게 연결하는 방법을 안내합니다. API를 연결하면 자금을 직접 이동하지 않고도 자동 거래, 전략 실행, 계정 데이터 동기화를 사용할 수 있습니다.
⚠️ 시작 전 중요 안내
- API Key는 출금 권한을 허용하지 않도록 설정하세요.
- API Key와 Secret Key를 다른 사람에게 공유하지 마세요.
- 가능하면 IP 접근 제한 또는 화이트리스트를 사용하세요.
- API 거래 전용 서브 계정 사용을 권장합니다.
Step 1: Bitget에 로그인
- Bitget 공식 웹사이트 또는 앱에 접속합니다.
- 계정 정보로 로그인합니다.
- 계정 보안을 위해 2FA가 활성화되어 있는지 확인합니다.
Step 2: API 관리 메뉴로 이동
- 프로필, 계정, 보안 또는 API Management 메뉴를 엽니다.
- API Key, API Management, API Keys와 같은 항목을 선택합니다.
- 새 API를 만들 수 있는 화면으로 이동합니다.
Step 3: 새 API Key 생성
- API 이름 또는 라벨에 UFOX처럼 식별하기 쉬운 이름을 입력합니다.
- 거래소가 요구하는 이메일 인증, 2FA 인증, 보안 인증을 완료합니다.
- 생성된 API Key와 Secret Key를 안전한 곳에 저장합니다.
- Secret Key는 한 번만 표시되는 경우가 많으므로 화면을 닫기 전에 반드시 확인하세요.
Step 4: API 권한 설정
필요한 권한만 켜고 위험한 권한은 끄는 것이 가장 중요합니다.
✅ 필요한 권한
- 읽기 권한 또는 계정 조회 권한
- 현물 전략을 사용할 경우 Spot Trading 권한
- Futures 전략을 사용할 경우 Futures Trading 권한
❌ 반드시 비활성화할 권한
- 출금 권한
- 내부 이체 또는 Universal Transfer 권한
- 사용하지 않는 과도한 관리 권한
Step 5: IP 접근 제한 설정
- UFOX에서 제공하는 공식 IP가 있다면 화이트리스트에 추가합니다.
- 아직 IP 정보를 받지 못했다면 임시로 제한 없이 연결한 뒤, 이후 반드시 제한 설정을 업데이트하세요.
- IP 제한 오류가 발생하면 거래소 API 설정과 UFOX 입력 정보를 다시 확인합니다.
Step 6: UFOX에서 API 연결
- UFOX 홈 화면에서 API 또는 거래소 연결 메뉴로 이동합니다.
- 거래소 목록에서 Bitget를 선택합니다.
- API Key, Secret Key를 입력합니다.
- 사용할 거래 범위(Spot, Futures 또는 Both)를 선택합니다.
- Bind, Connect, Import 버튼을 눌러 연결을 완료합니다.
Step 7: 연결 상태 확인
연결이 성공하면 다음 상태를 확인할 수 있습니다.
- API 상태가 Connected 또는 연결됨으로 표시됩니다.
- 계정 잔고와 거래 가능 정보가 동기화됩니다.
- 사용할 수 있는 Bot과 전략이 활성화됩니다.
일반 오류 및 해결 방법
❌ API Key 또는 Secret 오류
- 앞뒤 공백이 들어가지 않았는지 확인합니다.
- Secret Key가 정확한지 확인합니다.
- 값을 잃어버렸다면 기존 API를 삭제하고 새로 생성하세요.
❌ 권한 부족
- 거래 권한이 켜져 있는지 확인합니다.
- Futures Bot은 Futures 권한이 필요합니다.
- Spot Bot은 Spot 거래 권한이 필요합니다.
❌ IP 화이트리스트 오류
- UFOX 공식 IP가 거래소 화이트리스트에 추가되어 있는지 확인합니다.
- 테스트 중이라면 IP 제한을 임시 해제한 뒤 다시 연결할 수 있습니다.
보안 모범 사례
- API 거래 전용 서브 계정을 사용하세요.
- API Key를 정기적으로 교체하세요.
- 거래소의 API 활동 로그를 확인하세요.
- 이상 활동이 발견되면 즉시 API를 삭제하세요.
FAQ
UFOX가 내 자금을 출금할 수 있나요?
아니요. 출금 권한은 반드시 비활성화해야 하며, UFOX는 거래 실행과 데이터 동기화에 필요한 권한만 사용합니다.
하나의 API Key를 여러 플랫폼에 연결해도 되나요?
권장하지 않습니다. 보안을 위해 플랫폼마다 별도의 API Key를 사용하는 것이 좋습니다.
나중에 API 권한을 수정할 수 있나요?
네. 대부분의 거래소에서 API 관리 화면을 통해 권한과 IP 제한을 수정할 수 있습니다.
🎯 완료
Bitget 계정이 UFOX에 연결되었습니다. 이제 자동 거래와 전략 실행을 더 안전하게 시작할 수 있습니다.
화면 예시
