[목차]
1. pyupbit 모듈 설치
2. 암호화폐 목록 얻기
3. 암호화폐 현재가 얻기
4. 암호화폐 과거 데이터 조회
5. 암호화폐 호가 조회
6. 잔고 조회
7. 지정가 매수/매도
8. 시장가 매수/매도
9. 주문 취소/조회
1. pyupbit 모듈 설치
pyupbit 모듈이란, 업비트 API를 파이썬에서 쉽게 사용하기 위해서 저자들이 개발한 모듈이다. 굳이 API를 호출할 필요 없이 pyupbit 모듈을 이용하면 간편한 경우가 많다.
pyupbit github 와 wikidocs.net/31063 를 참고하여 작성하였다.
먼저 pyupbit 모듈을 설치해보자. 프롬프트 창에 "pip install pyupbit"를 입력한다.
그 후, 다음 코드를 실행했을 때 오류가 발생하지 않는다면 pyupbit 모듈이 잘 설치가 된 것이다.
import pyupbit
print(pyupbit.Upbit) # <class 'pyupbit.exchange_api.Upbit'>
이제, pyupbit를 이용할 수 있는 대표적인 기능 몇 가지를 알아보자.
2. 암호화폐 목록 얻기
암호화폐를 거래하기 위해서는 각 화폐별 ticker가 필요하다. get_tickers 함수를 이용하면 업비트에서 거래할 수 있는 모든 암호화폐의 문자열 ticker를 리스트로 반환해준다.
import pyupbit
print(pyupbit.get_tickers())
# OUTPUT
['KRW-BTC', 'KRW-ETH', 'BTC-ETH', 'BTC-LTC', 'BTC-XRP', 'BTC-ETC', ...]
업비트에서는 원화(KRW)뿐만 아니라 BTC, USDT 마켓 또한 지원하므로 주로 이용하는 원화 마켓의 암호화폐를 선별하고 싶다면 다음과 같이 옵션을 추가해주어야 한다.
import pyupbit
print(pyupbit.get_tickers(fiat="KRW"))
# OUTPUT
['KRW-BTC', 'KRW-ETH', 'KRW-NEO', 'KRW-MTL', 'KRW-LTC', 'KRW-XRP', ...]
fiat은 우리가 사용하는 종이 화폐, 즉 명목화폐(fiat money)에서 나온 말이다. 동일한 방법으로 BTC / USDT 마켓의 암호화폐도 골라낼 수 있다.
3. 암호화폐 현재가 얻기
get_current_price 함수를 이용하면 암호화폐의 마지막 체결 가격, 즉 현재가를 얻을 수 있다. 인자에 암호화폐의 ticker를 넣어주면 float형으로 값을 반환한다.
import pyupbit
print(pyupbit.get_current_price("KRW-BTC"))
# OUTPUT
64069000.0
만약 여러 암호화폐를 한 번에 조회하고 싶다면, ticker들을 담은 리스트를 인자로 넘겨주면 된다. 이 경우에는 반환 값으로 {key : value}가 {ticker : 현재가}인 딕셔너리가 반환된다.
import pyupbit
print(pyupbit.get_current_price(["KRW-BTC", "KRW-ETH", "KRW-XRP"]))
# OUTPUT
{'KRW-BTC': 63984000.0, 'KRW-ETH': 5020000.0, 'KRW-XRP': 1695.0}
몇 분 사이에 값이 비트코인 가격이 소폭 하락한 것을 볼 수 있다. get_current_price 함수는 한 번에 최대 100개의 암호화폐를 조회할 수 있다.
4. 암호화폐 과거 데이터 조회
get_ohlcv 함수를 이용하여 인자에 ticker를 넘겨주면 해당 암호화폐의 OHLCV 데이터를 pandas DataFrame으로 반환한다.
시가 / 고가 / 저가 / 종가 / 거래량 / 거래금액 을 구할 수 있다.
import pyupbit
print(pyupbit.get_ohlcv(ticker="KRW-BTC"))
# OUTPUT
open high low close volume value
2020-10-26 09:00:00 14687000.0 14920000.0 14358000.0 14764000.0 3031.758804 4.461594e+10
2020-10-27 09:00:00 14772000.0 15457000.0 14683000.0 15312000.0 3964.125320 5.957730e+10
2020-10-28 09:00:00 15300000.0 15557000.0 14635000.0 15060000.0 5752.669847 8.715575e+10
2020-10-29 09:00:00 15060000.0 15379000.0 14703000.0 15207000.0 3516.504745 5.284074e+10
2020-10-30 09:00:00 15207000.0 15460000.0 14899000.0 15340000.0 3753.488127 5.689144e+10
... ... ... ... ... ... ...
2021-05-09 09:00:00 71728000.0 73129000.0 70147000.0 71505000.0 11786.596492 8.435439e+11
2021-05-10 09:00:00 71506000.0 72460000.0 70175000.0 70902000.0 13095.617952 9.373196e+11
2021-05-11 09:00:00 70902000.0 71750000.0 67597000.0 69741000.0 11913.277828 8.271176e+11
2021-05-12 09:00:00 69714000.0 70499000.0 60854000.0 62257000.0 22173.238069 1.505872e+12
2021-05-13 09:00:00 62380000.0 64987000.0 60200000.0 64445000.0 5088.587170 3.218080e+11
get_ohlcv 함수는 다음과 같이 구성되어 있다.
get_ohlcv(ticker='KRW-BTC', interval='day', count=200, to=None, period=0.1) -> Union[DataFrame, None]
매개변수로 ticker, interval, count, to, period가 존재하며, 반환 값으로 Union[DataFrame, None]을 갖는다.
interval 변수는 조회 단위를 나타낸다. 분(1/3/5/10/15/30/60/240), 일, 주, 월별 데이터를 구할 수 있으며 인자로 넘길 땐 다음과 같다.
[ day / minute1 / minute3 / minute5 / minute10 / minute15 / minute30 / minute60 / minute240 / week / month ]
만약 interval을 지정하지 않는다면 기본값은 day이다.
count 변수는 조회 개수를 나타낸다. 최근 영업일부터 이전 count만큼의 영업일까지의 데이터를 가져오게 된다.
count를 지정하지 않는다면 기본값은 200이다.
to 변수는 입력된 시점의 이전까지의 데이터를 얻을 수 있다. 예를 들어 to="20210101"이라고 하면, 2020년 12월 31일부터 이전 count만큼의 영업일까지의 데이터를 가져온다. 즉, 2020-06-15~2020-12-31의 데이터를 가져온다.
to를 지정하지 않는다면 기본값은 None이며, 이는 현재 일부터 가져오게 된다.
period는 데이터를 수집하는 주기를 말한다. count가 200 이하라면 period 옵션은 무시되며, count가 200보다 큰 경우 다른 API와 함께 사용한다면 조회 주기를 늘려주어야 한다.
import pyupbit
print(pyupbit.get_ohlcv(ticker="KRW-BTC", interval="minute3", count=20))
# OUTPUT
open high low close volume value
2021-05-13 10:36:00 64072000.0 64109000.0 63900000.0 63918000.0 58.438715 3.741627e+09
2021-05-13 10:39:00 63900000.0 63919000.0 63802000.0 63875000.0 73.630070 4.702404e+09
2021-05-13 10:42:00 63865000.0 64147000.0 63862000.0 64019000.0 60.718397 3.887090e+09
2021-05-13 10:45:00 64014000.0 64182000.0 63987000.0 64152000.0 36.676134 2.349825e+09
2021-05-13 10:48:00 64158000.0 64448000.0 64110000.0 64445000.0 63.697727 4.096094e+09
2021-05-13 10:51:00 64425000.0 64498000.0 64366000.0 64497000.0 78.271995 5.046166e+09
2021-05-13 10:54:00 64480000.0 64800000.0 64468000.0 64786000.0 99.956416 6.458304e+09
2021-05-13 10:57:00 64727000.0 64994000.0 64726000.0 64993000.0 92.597657 6.010476e+09
2021-05-13 11:00:00 64993000.0 64998000.0 64468000.0 64480000.0 110.172045 7.133575e+09
2021-05-13 11:03:00 64490000.0 64950000.0 64468000.0 64577000.0 93.156690 6.030081e+09
2021-05-13 11:06:00 64562000.0 64670000.0 64500000.0 64613000.0 66.252347 4.278387e+09
2021-05-13 11:09:00 64635000.0 64786000.0 64547000.0 64770000.0 57.174851 3.695290e+09
2021-05-13 11:12:00 64750000.0 64993000.0 64700000.0 64993000.0 91.189028 5.915082e+09
2021-05-13 11:15:00 64992000.0 65300000.0 64975000.0 65300000.0 134.847742 8.781921e+09
2021-05-13 11:18:00 65286000.0 65472000.0 64952000.0 64955000.0 117.236921 7.657944e+09
2021-05-13 11:21:00 64952000.0 65182000.0 64952000.0 65060000.0 75.174626 4.891415e+09
2021-05-13 11:24:00 65060000.0 65126000.0 64600000.0 64693000.0 86.530141 5.611444e+09
2021-05-13 11:27:00 64669000.0 64959000.0 64634000.0 64833000.0 72.705191 4.712628e+09
2021-05-13 11:30:00 64833000.0 64863000.0 64499000.0 64650000.0 99.585294 6.435314e+09
2021-05-13 11:33:00 64650000.0 64700000.0 64449000.0 64460000.0 70.165524 4.532421e+09
일봉을 구하는 경우 기준 시간을 직접 지정할 수 있다.
get_daily_ohlcv_from_base 함수를 이용하여 base에 원하는 시간을 입력하면 해당 시간을 기준으로 하루가 계산된다.
import pyupbit
print(pyupbit.get_daily_ohlcv_from_base(ticker="KRW-BTC", base=13))
# OUTPUT
open high low close volume
2021-05-04 13:00:00 68030000.0 69751000.0 66500000.0 69124000.0 4311.390464
2021-05-05 13:00:00 69023000.0 70007000.0 67040000.0 68935000.0 11311.231399
2021-05-06 13:00:00 68910000.0 70853000.0 67186000.0 67498000.0 13871.493052
2021-05-07 13:00:00 67500000.0 69729000.0 66900000.0 69087000.0 10614.771277
2021-05-08 13:00:00 69100000.0 72500000.0 68993000.0 72402000.0 13002.555370
2021-05-09 13:00:00 72455000.0 73129000.0 70147000.0 72099000.0 11998.092245
2021-05-10 13:00:00 72098000.0 72460000.0 68500000.0 69552000.0 13981.115840
2021-05-11 13:00:00 69552000.0 70499000.0 67597000.0 70144000.0 10589.004324
2021-05-12 13:00:00 70170000.0 70499000.0 60200000.0 64451000.0 26736.304001
5. 암호화폐 호가 조회
암호화폐의 매수/매도 호가 조회는 get_orderbook 함수를 이용한다. 인자로 ticker를 넘겨주고 반환 값으로 딕셔너리로 구성된 리스트를 반환한다.
import pyupbit
print(pyupbit.get_orderbook(tickers="KRW-BTC"))
# OUTPUT
[{'market': 'KRW-BTC', 'timestamp': 1620874024245, 'total_ask_size': 3.97732861, 'total_bid_size': 2.52959603,
'orderbook_units':
[{'ask_price': 64090000.0, 'bid_price': 64070000.0, 'ask_size': 0.00031294, 'bid_size': 0.06156758},
{'ask_price': 64093000.0, 'bid_price': 64066000.0, 'ask_size': 0.26436965, 'bid_size': 0.08471909},
{'ask_price': 64094000.0, 'bid_price': 64065000.0, 'ask_size': 0.06992863, 'bid_size': 0.16189154},
{'ask_price': 64096000.0, 'bid_price': 64064000.0, 'ask_size': 1.98105323, 'bid_size': 0.00156093},
{'ask_price': 64098000.0, 'bid_price': 64061000.0, 'ask_size': 0.00204766, 'bid_size': 0.06961012},
{'ask_price': 64107000.0, 'bid_price': 64060000.0, 'ask_size': 0.06455513, 'bid_size': 1.16250019},
{'ask_price': 64125000.0, 'bid_price': 64029000.0, 'ask_size': 0.00549689, 'bid_size': 0.02838788},
{'ask_price': 64127000.0, 'bid_price': 64028000.0, 'ask_size': 0.01021383, 'bid_size': 0.03123633},
{'ask_price': 64128000.0, 'bid_price': 64019000.0, 'ask_size': 0.00069257, 'bid_size': 0.00447529},
{'ask_price': 64135000.0, 'bid_price': 64018000.0, 'ask_size': 0.19030409, 'bid_size': 0.00234309},
{'ask_price': 64138000.0, 'bid_price': 64005000.0, 'ask_size': 0.05639289, 'bid_size': 0.23895895},
{'ask_price': 64153000.0, 'bid_price': 64000000.0, 'ask_size': 0.1938, 'bid_size': 0.45682086},
{'ask_price': 64156000.0, 'bid_price': 63998000.0, 'ask_size': 1.00601281, 'bid_size': 0.06531679},
{'ask_price': 64173000.0, 'bid_price': 63997000.0, 'ask_size': 0.0187122, 'bid_size': 0.02281961},
{'ask_price': 64174000.0, 'bid_price': 63982000.0, 'ask_size': 0.11343609, 'bid_size': 0.13738778}]
}]
market은 ticker이고 timestamp는 조회시간(단위 : ms)이며, total_ask_size, total_bid_size는 총 매도/매수 크기를 말한다.
orderbook_units는 딕셔너리가 원소인 리스트이며, ask_price는 매도 호가, bid_price는 매수 호가, ask_size는 매도 호가 수량, bid_size는 매수 호가 수량을 의미한다.
get_orderbook에 여러 ticker를 넘겨주면 마찬가지로 한 번에 여러 암호화폐에 대한 호가를 구할 수 있다.
6. 잔고 조회
잔고를 조회하기 위해서는 API 사용 신청을 한 후 발급받았던 access key와 secret key가 필요하다. 이를 이용하여 Upbit 클래스의 인스턴스를 생성한 후, get_balances 함수를 이용하면 잔고를 조회할 수 있다.
import pyupbit
access = "User access key" # access key 직접 입력
secret = "User secret key" # secret key 직접 입력
upbit = pyupbit.Upbit(access, secret)
print(upbit.get_balances())
# OUTPUT
[{'currency': 'KRW', 'balance': '0.68421149', 'locked': '0.0', 'avg_buy_price': '0', 'avg_buy_price_modified': True, 'unit_currency': 'KRW'},
{'currency': 'XRP', 'balance': '0.00000081', 'locked': '0.0', 'avg_buy_price': '1815', 'avg_buy_price_modified': False, 'unit_currency': 'KRW'}]
코인을 하고 남은 흔적들이 있다. 현재 원화가 0.68원 정도, 아주 소량의 리플이 존재하는 것을 볼 수 있다.
avg_buy_price는 평균 매수가를 의미하고, avg_buy_price_modified는 평균 매수가가 수정되었는지 여부를 나타낸다.
get_balances 함수는 실제로 get_balances(contain_req=False) -> Union[tuple, None] 로 이루어져 있다.
만약 get_balances에 True를 넣어주면, API를 호출할 수 있는 빈도의 제한을 추가로 반환한다.
import pyupbit
access = "User access key" # access key 직접 입력
secret = "User secret key" # secret key 직접 입력
upbit = pyupbit.Upbit(access, secret)
print(upbit.get_balances())
# OUTPUT
([{'currency': 'KRW', 'balance': '0.68421149', 'locked': '0.0', 'avg_buy_price': '0', 'avg_buy_price_modified': True, 'unit_currency': 'KRW'},
{'currency': 'XRP', 'balance': '0.00000081', 'locked': '0.0', 'avg_buy_price': '1815', 'avg_buy_price_modified': False, 'unit_currency': 'KRW'}],
{'group': 'default', 'min': 899, 'sec': 29})
API는 각 API마다 어떤 그룹에 속해있고, 그룹 단위로 호출을 제한한다. 위의 결과는 1분에 최대 899번, 1초당 최대 29번 API를 호출할 수 있다는 의미이다.
만약 특정 암호화폐나 원화에 대해서 잔고가 궁금하다면 get_balance 함수를 이용하면 된다.
인자로는 ticker를 넘겨준다.
import pyupbit
access = "User access key" # access key 직접 입력
secret = "User secret key" # secret key 직접 입력
upbit = pyupbit.Upbit(access, secret)
print(upbit.get_balance("KRW"))
# OUTPUT
0.68421149
print(upbit.get_balance("KRW-XRP"))
# OUTPUT
8.1e-07
7. 지정가 매수/매도
지정한 가격에 매도할 때에는 sell_limit_order 함수를, 매수할 때에는 buy_limit_order 함수를 이용한다.
마찬가지로 Upbit 클래스의 인스턴스를 통해서 호출할 수 있다.
import pyupbit
access = "User access key" # access key 직접 입력
secret = "User secret key" # secret key 직접 입력
upbit = pyupbit.Upbit(access, secret)
ret = upbit.buy_limit_order("KRW-BTC", 1000000, 1)
print(ret)
# OUTPUT
{'error': {'message': '주문가능한 금액(KRW)이 부족합니다.', 'name': 'insufficient_funds_bid'}}
buy_limit_order 함수와 sell_limit_order 함수는 다음과 같이 구성되어 있다.
buy_limit_order(ticker, price, volume, contain_req=False) -> Union[tuple, None]
sell_limit_order(ticker, price, volume, contain_req=False) -> Union[tuple, None]
price에 원하는 매수/매도가를 넣고, volume에 매수/매도할 코인 개수를 넣는다.
위의 예시에서는 비트코인을 100만 원에 1개 매수하려는 코드이다. 잔고가 부족하여 에러가 발생했지만, 만약 잔고가 충분하다면 주문 정보는 딕셔너리로 반환된다. (아래 참고)
주문을 통해 반환된 딕셔너리에서 uuid는 주문에 대한 고윳값으로, 이 값을 이용해서 주문을 다시 취소하거나 정정할 수 있다.
8. 시장가 매수/매도
시장가 매수/매도는 최우선 매도/매수 호가에 즉시 주문한다.
시장가 매수는 buy_market_order 함수, 매도는 sell_market_order 함수를 이용한다.
buy_market_order(ticker, price, contain_req=False) -> Union[tuple, None]
sell_market_order(ticker, volume, contain_req=False) -> Union[tuple, None]
시장가 매수를 하는 경우에는 매수할 금액을 넣어준다. 수수료가 제외된 금액이므로 만약 10000원 치를 구매한다면 실제로는 수수료 0.05%가 추가된 10005원의 현금을 가지고 있어야 한다.
시장가 매도를 하는 경우에는 매도할 개수를 넣어준다.
9. 주문 취소/조회
주문 취소를 하기 위해선 이전에 주문했던 정보의 uuid를 이용한다. 이 uuid 값을 cancel_order라는 함수의 인자로 넘겨주면 주문이 취소된다.
cancel_order(uuid, contain_req=False) -> Union[tuple, None]
주문을 조회하기 위해서는 get_order함수를 이용한다. 형태는 아래와 같다.
get_order(ticker_or_uuid, state='wait', kind='normal', contain_req=False) -> Union[tuple, None]
import pyupbit
access = "User access key" # access key 직접 입력
secret = "User secret key" # secret key 직접 입력
upbit = pyupbit.Upbit(access, secret)
ret = upbit.get_order("KRW-BTC") # 미체결 주문
ret = upbit.get_order("KRW-BTC", state="done") # 완료된 주문
ret = upbit.get_order("UUID") # 특정 주문 상세 조회
기본적으로 get_order 함수에 ticker만 넣으면 해당 암호화폐에 대한 미체결 주문 정보가 반환된다.
만약 state를 done으로 할당해주면 완료된 주문 정보가 반환된다.
get_order 함수에 주문의 고유 정보인 uuid를 넣으면 해당 주문에 대한 상세 정보가 반환된다. 이 경우 다른 매개변수들은 무시된다.
'[Toy Project] 자동매매' 카테고리의 다른 글
| [Toy Project] 자동매매 프로그램 만들기 - 6. openpyxl 모듈 알아보기 (0) | 2021.05.26 |
|---|---|
| [Toy Project] 자동매매 프로그램 만들기 - 5. RSI 지표 이용하여 매매하기 (17) | 2021.05.22 |
| [Toy Project] 자동매매 프로그램 만들기 - 4. RSI 지표 계산하기 (9) | 2021.05.17 |
| [Toy Project] 자동매매 프로그램 만들기 - 2. 업비트 API 가이드 (4) | 2021.05.13 |
| [Toy Project] 자동매매 프로그램 만들기 - 1. 업비트 API 사용 신청 (2) | 2021.05.12 |
