Gate.io를 ZeroLoss에 연결하는 방법: API 키 설정
ZeroLoss는 이용자 본인의 Gate.io 계정에서 Gate.io USDT 무기한 선물을 거래합니다. 비밀번호가 아니라 Gate.io에서 직접 만든 API 키로 연결하며, 이 키에는 계정 조회와 선물 거래 권한만 있으면 됩니다. 자금은 처음부터 끝까지 Gate.io에 그대로 있습니다. 이 가이드에서는 키를 만들고, 제한을 설정하고, ZeroLoss에 연결하는 방법을 안내합니다. 약 5분이면 됩니다.
무언가를 연결하기 전에 봇이 거래하는 모습을 먼저 보고 싶으신가요? 무료 7일 모의 테스트는 거래소가 전혀 필요 없습니다.
시작하기 전에
- 계정 인증을 완료하고, 자금 비밀번호를 설정하고, 2단계 인증을 켠 Gate.io 계정. Gate는 키를 만들 때 이 세 가지를 모두 요구합니다.
- USDT 무기한 선물 계정에 최소 100 USDT. 웹: Assets → Futures Account → Transfer에서 증거금 통화로 USDT를 선택합니다. 앱: 선물 페이지의 Funds Transfer(자금 이체) 아이콘. 계정이 Gate의 통합 계정(Unified Account) 모드라면 이체가 필요 없습니다.
- ZeroLoss 계정. 무료 모의 테스트로 먼저 시작하고 나중에 연결해도 됩니다.
1단계: Gate.io에서 API 키 만들기
- Gate.io 웹사이트에 로그인하고 오른쪽 상단의 프로필 아이콘에 마우스를 올린 뒤 API Management를 여세요.
- API v4 Key 생성을 선택하세요. API v2 키는 현물 전용이므로 사용하지 마세요.
- 실거래용으로 Classic Account(클래식 계정) 유형을 선택하세요. Testnet 키는 Gate의 테스트 사이트에서만 작동합니다.
- 키 이름을 정하고, 권한(2단계)과 IP 화이트리스트(3단계)를 설정하세요.
- 위험 안내에 동의하고, 자금 비밀번호와 2FA 코드를 입력한 뒤 확인하세요.
- API Key와 Secret Key를 복사해 안전한 곳에 보관하세요.
2단계: 권한 선택하기
Gate는 각 권한 그룹을 비활성, 읽기 전용, 읽기-쓰기 중 하나로 설정합니다.
- 무기한 계약(Perpetual contract): 읽기-쓰기. ZeroLoss가 선물 계정을 조회하고 주문을 넣고 취소할 수 있게 합니다.
- 출금(Withdrawal): 비활성.
- 지갑(Wallet): 비활성 또는 읽기 전용. 지갑에 읽기-쓰기 권한을 주면 자금 이체가 가능해지며, ZeroLoss는 이 권한이 전혀 필요하지 않습니다.
- 현물/마진 및 인도형 계약은 비활성으로 두어도 됩니다.
3단계: 키를 ZeroLoss IP 주소로 제한하기
키를 몇 개의 IP 주소로 제한하면, 누군가 키를 복사하더라도 해당 서버에서만 작동합니다. ZeroLoss 앱에서 거래소 연결(거래소 연결)를 여세요. 당사 IP 추가(IP 화이트리스트) 단계에 ZeroLoss 서버 주소 목록과 모두 복사(모두 복사) 버튼이 있습니다. 이를 Gate.io의 IP 제한 입력란에 붙여 넣으세요.
Gate는 키당 최대 20개의 IPv4 주소를 허용합니다(대역은 불가). 생각보다 중요한 부분입니다. IP 화이트리스트가 없는 Gate v4 키는 90일 후 비활성화되며, 90일 동안 사용하지 않은 키는 삭제됩니다. ZeroLoss 주소를 연결하면 첫 번째 문제를 피할 수 있습니다.
4단계: ZeroLoss에서 키 연결하기
- ZeroLoss에 로그인하고 거래소 연결(거래소 연결)를 여세요.
- 1 · Pick your exchange(거래소 선택)에서 Gate.io를 선택하세요.
- 2 · Paste your API key(API 키 붙여 넣기)에 API 키와 시크릿 키를 붙여 넣으세요.
- Verify & connect(확인 및 연결)를 클릭하세요. ZeroLoss가 키를 확인하고 선물 잔고를 읽어 옵니다. 연결하려면 Gate.io USDT 선물 계정에 최소 100 USDT가 있어야 합니다.
키가 안전한지 확인하기
Gate.io의 API 관리 페이지를 열고 만든 키를 확인하세요. 읽기와 선물 거래가 허용되어 있고 출금은 꺼져 있어야 합니다. 언제든 ZeroLoss를 멈추려면 Gate.io에서 키를 삭제하세요. 저희 쪽 조치 없이도 해당 키를 통한 거래가 즉시 종료됩니다. 이 설정이 중요한 이유는 거래 전용 API 키 가이드에서 설명합니다.
자주 발생하는 문제
- 약 3개월 후 키가 작동을 멈춤: 키에 IP 화이트리스트가 없어 Gate가 90일 후 비활성화했습니다. ZeroLoss IP를 연결하거나, IP를 넣어 새 키를 만드세요.
- 방금 만든 키가 전혀 작동하지 않음: v2 키나 Testnet 키가 아니라 Classic Account의 v4 키인지 확인하세요.
- “Invalid API Key or Secret”(잘못된 API 키 또는 시크릿): 복사할 때 문자가 빠졌습니다. 둘 다 다시 복사하세요. 시크릿을 저장하지 않았다면 키를 삭제하고 새로 만드세요.
- “API key missing required permissions”(API 키에 필요한 권한 없음): 키에 선물 거래 또는 읽기가 체크되어 있지 않습니다. 키를 편집하거나 두 권한을 모두 갖춘 새 키를 만드세요.
- “API IP restriction issue”(API IP 제한 문제): 키가 제한되어 있지만 ZeroLoss 주소 전체로 제한되지는 않았습니다. 앱에서 모두 복사(모두 복사)을 사용해 전체 목록을 다시 붙여 넣으세요.
- “Minimum 100 USDT required in Futures wallet”(선물 지갑에 최소 100 USDT 필요): USDT가 현물 계정이나 BTC 증거금 선물 계정에 있습니다. USDT 무기한 선물 계정으로 이체한 뒤 다시 시도하세요.
암호화폐 선물 거래는 손실 위험이 높으며, 자동매매가 그 위험을 없애 주지는 않습니다. 거래소 화면은 수시로 바뀝니다. 메뉴가 다르게 보이면 위의 권한 이름을 찾으세요. 이 페이지는 일반 정보이며 투자 조언이 아닙니다. 위험 & 책임 고지를 참고하세요.