BitMart API 소개
BitMart 거래소는 2018년 8월 1일부터 애플리케이션 프로그래밍 인터페이스(API)를 일반에 공개하여, 사용자가 프로그래밍 방식으로 시장 데이터에 접근하고, 거래를 실행하며, 계정을 관리할 수 있도록 했습니다. BitMart API는 REST API 및 WebSocket 구독 서비스를 지원하며, 다양한 타사 거래 플랫폼 및 도구와 연동되어 고급 사용자와 개발자에게 유연한 거래 자동화 솔루션을 제공합니다.
BitMart API 키 생성 단계
- 계정 로그인: 먼저 웹 브라우저를 통해 BitMart 계정에 로그인하십시오. 현재 모바일 앱에서는 일반적으로 API 키 관리 기능을 지원하지 않으므로 유의하시기 바랍니다.
- API 관리 페이지로 이동: 로그인 후, 페이지 우측 상단의 계정 아이콘을 클릭하고 드롭다운 메뉴에서 “API 관리” 또는 “API Management” 옵션을 선택하십시오.
- API 키 생성:
API 관리 페이지에서 새 API 키 생성 옵션을 확인할 수 있습니다. 다음 정보를 입력해 주세요:
- Memo (비고): 이 API 키의 용도를 식별할 수 있도록 간단한 태그나 비고를 입력하세요. 특정 제3자 플랫폼에 연결할 때 이 비고가 “패스프레이즈(passphrase)”로 사용될 수 있습니다.
- 권한 설정 (Authority/Permissions): 구체적인 요구 사항에 따라 필요한 권한을 선택하십시오. 일반적으로 “Read Only”(읽기 전용) 권한은 기본적으로 활성화되어 있습니다. 그 밖의 일반적인 권한으로는 “Spot-Trade”(현물 거래), “Futures-Trade”(선물 거래) 및 “Margin-Trade”(마진 거래)가 있습니다.계정 보안을 위해 필요한 권한만 활성화할 것을 강력히 권장합니다.
- IP 주소 바인딩 (Binding IP Address): 이는 권장되는 보안 조치입니다. 하나 이상의 허용 IP 주소를 입력할 수 있으며, 해당 IP 주소만 이 API 키를 통해 귀하의 계정에 접근할 수 있습니다. 타사 거래 도구를 사용하는 경우, 해당 도구에서 서버 IP 주소를 확인해야 합니다. 빈칸으로 두면 모든 IP 주소에서 접근할 수 있지만 보안 수준이 낮아집니다.
입력을 완료한 후 “Add” 또는 “Submit” 버튼을 클릭하십시오.
- 보안 인증: 시스템에서 보안 인증을 요청합니다(예: 이메일 또는 구글 인증기를 통해 받은 인증 코드 입력). 인증을 완료해야 다음 단계로 진행할 수 있습니다.
- API 키 및 시크릿 키 복사: API 키 생성이 완료되면 페이지에 Access Key(API 키)와 Secret Key가 표시됩니다. Secret Key는 한 번만 표시되며 이후에는 다시 확인할 수 없으므로, 즉시 복사하여 안전하게 보관하시기 바랍니다.
- 확인 및 종료: “Confirm” 버튼을 클릭하여 API 키 생성 과정을 완료합니다.
API 키 사용 및 보안 안내
- 키 수량 제한: 각 BitMart 계정당 최대 5세트의 API 키를 생성할 수 있으며, 각 세트마다 다양한 사용 시나리오의 요구 사항을 충족하도록 서로 다른 권한 조합을 설정할 수 있습니다.
- 이력 데이터 조회: API를 통해 일반적으로 지난 3개월간의 현물 거래, 선물 거래 및 최근 100건의 출금 내역만 조회할 수 있습니다. 전체 이력 데이터가 필요한 경우, 정기적으로 수동으로 동기화하거나 내보내는 것을 권장합니다.
- 타사 통합: BitMart API는 Bitsgap, Cryptohopper, uTrading 등 다양한 타사 거래 도구 및 플랫폼과 통합되어 자동 거래 및 데이터 분석을 구현할 수 있습니다.
- 보안 모범 사례:
- API 키에는 해당 작업을 수행하는 데 필요한 최소한의 권한만 부여하십시오.
- 가능한 한 IP 주소 허용 목록 기능을 사용하여 API의 접속 출처를 제한하십시오.
- Secret Key를 계정 비밀번호와 동일하게 간주하여 안전하게 보관하고, 타인에게 절대 유출하지 마십시오.
- API 키를 정기적으로 검토 및 갱신하고, 더 이상 필요하지 않을 때는 즉시 삭제하십시오.
