바이비트와 파이썬을 이용한 자동매매 프로그램 - 1. Reference

---

 

목차

1. Bybit API Documents

2. Testnet

 

---

 

1. Bybit API Documents

 

모두 아시겠지만, 모든 API에는 관련 documents가 필수로 존재합니다. 어떤 함수가 존재하는지, 어떻게 쓰는 것인지, 쓴다면 output은 무엇인지, 여러가지 error 사항 등등 정말 유용하죠. Bybit API 역시 관련 문서가 존재합니다. 이걸 찾는데 정말 시간이 오래 걸렸었죠....(저만 그런가요 ㅠ) 아래 링크로 접속하면 Bybit 공식 문서가 나옵니다.

 

https://bybit-exchange.github.io/docs/inverse/#t-introduction

Bybit API Docs

 

그럼 이제부터 documents를 보는 법을 알려드려 혹시 코딩에서 막혔을 경우 어떻게 대처해야 하는지 보도록 하겠습니다. 처음 링크에 접속하면 다음과 같은 화면이 뜹니다.

 

Bybit Document

 

왼쪽 상단에는 Bybit 로고가 있고, 그 옆으로 메뉴바가 존재하는군요. 해당 글을 읽으시는 분들은 다양한 메뉴들 중 두가지만 보시면 됩니다. Inverse Perpetual와 USDT Perpetual 입니다. 개인 취향에 따라 갈리겠지만, 저는 USDT 거래를 하므로 USDT Perpetual 위주로 봤습니다. 원하는 거래 방식을 선택해 봅시다.

 

세부 메뉴가 존재한다.

 

원하는 거래 방식을 선택했다면, 왼쪽 사이드바(빨간 상자로 표시한 부분)에 세부 목록들이 있는 것을 확인 하실 수 있습니다. 이 중 꼭 알아야 하는 애들에 대해 설명한다면,

 

- Market Data Endpoints : 시세, 거래량, 거래 가능 코인 등 마켓 정보를 가져 올 수 있는 endpoint 입니다.

Market Data Endpoints
Order Book	특정 코인에 대해 현재 시세를 알 수 있습니다.
Query Kline	특정 코인에 대해 과거 데이터를 최대 200 row까지 가져옵니다.
Latest Information for Symbol	특정 코인에 대해 가장 최근 이루어진 데이터들을 가져옵니다.
Public Trading Records	특정 코인에 대해 가장 최근 이루어진 거래 데이터를 불러옵니다.

 

- Account Data Endpoints : 본인 계좌 관련 데이터를 불러옵니다. 내 포지션을 설정하고, 거래를 할 수 있게 해줍니다.

Account Data Endpoints
Active Orders	Place Active Order	매매 기능입니다. 즉, 거래소에서 거래하기 버튼이라고 보시면 됩니다.
	Get Active Order	매매 예약을 걸어둡니다
	Cancel Active Order	매매를 취소합니다. 이 기능을 청산 기능으로 오해할 수 있는데, 아닙니다.
	Cancel All Active Order	모든 매매를 취소합니다.
Position	My Position	현재 내 포지션 정보를 가져올 수 있습니다.
	Set Leverage	레버리지를 설정합니다. 1 ~ 100까지 가능합니다.
	Cross/Isolated Margin Switch	교차로 할지, 격리로 할지 설정합니다.

 

다음 항목들에 대해서만 알아도, 어느정도 코드를 짜는데 있어 불편함이 해소될 것입니다. 각각 함수들에 대해 더욱 자세한 Parameter 설정과 request, response 모양새는 문서에 아주 자세히 설명되어 있으므로, 참고해 주시면 됩니다. 각각을 어떻게 쓰는지에 대한 예시는 추후 코드 설명 글에서 다시 다루도록 하겠습니다.

 

---

 

2. Testnet

 

모든 인터넷 서비스에는 Mainnet과 Testnet이 구분되어 있습니다. Mainnet은 실제로 고객이 사용하고 있는 서비스로, 은행 결제창, 쇼핑몰 홈페이지 등등 우리가 볼 수 있는 모든 사이트라고 생각하시면 됩니다. Testnet은 실제 서비스는 아니지만, 서비스와 동일한 서버로 새로운 기능이나 업데이트를 테스트하는 서버라고 생각하시면 됩니다.

 

주식 단타매매 하시는 분들 보면 소액 거래를 하며 몇개월간 연습하시고는 하죠. 하지만 우리는 그 소액조차 투자할 필요가 없습니다. Bybit에서는 실제 환경과 완전하게 동일한 testnet을 제공하며, 계좌에 기본 금액을 넣어놨기 때문에 모의 투자를 할 수 있기 때문이죠.

 

우리는 앞으로 모든 테스트를 testnet에서 진행하도록 하겠습니다. 자동매매도 직접매매와 동일하게, testnet에서 한달간의 충분한 거래를 통해 성능을 입증하고 mainnet으로 넘어가길 권장드립니다. 백테스팅 만으로는 모든 변수를 잡을 수 없기 때문이죠. 그럼 다음 글에선 본격적으로 각 기능들을 어떻게 사용하는지 배워보도록 하겠습니다.