Python Upbit : get_tickers (암호화폐 티커(ticker) 조회)

 

 

 

주식에서는 각 종목별로 고유한 닉네임같은 티커(ticker)라는 것이 있습니다.

 

암호화폐에서도 각 화폐별로 고유한 티머(ticker)가 존재합니다.

 

모든 암호화폐 거래는 ticker를 알아야만 합니다.

따라서 이번에는 ticker를 어떻게 얻어오는지 알아봅시다.

 

 

코인들의 Ticker를 얻어오려면 get_tickers method를 사용할 수 있습니다.

 

Syntax

pyupbit.get_tickers(fiat='KRW',
                    verbose=False,
                    is_details=False)

fiat = KRW, BTC, ETH, USDT -> 거래 기준 화폐

 

verbose = True/False -> 상세 내용 표시 여부 [ True = 상세내용 표시, False = 상세내용 표시 안함(default) ]

is_detail = True/False -> 유의 종목 flag 표시 여부 [ True = 상세내용 표시, False = 상세내용 표시 안함(default) ]

 

 

 

 

 

---

 

 

 

 

import pyupbit as ub

tickers = ub.get_tickers()
print(tickers)


-- Result
['KRW-BTC', 'KRW-ETH', 'BTC-ETH', 'BTC-LTC', 'BTC-XRP', ...생략... ]

pyupbit의 get_tikers method는 Upbit에서 거래되는 모든 코인들의 ticker를 list의 형태로 return해줍니다.

 

(코인의 종류가 너무 많기에 위 예시에서는 결과의 일부를 생략했습니다.)

 

이제 Ticker가 어떤식으로 이뤄져있는지 봅시다.

 

위 예시의 결과를 보면 다음과 같은 항목들이 보입니다.

 

KRW-BTC

KRW-ETH

BTC-ETH

BTC-XRP

등등

 

여기서 대쉬(-)를 기준으로 왼쪽에 있는 것은 코인이 거래되는 기준 통화입니다.

KRW는 원화이고 BTC는 비트코인입니다.

Upbit에서는 코인을 사고 팔 때 단순히 원화를 이용해서 코인을 사고파는 것 뿐 아니라 비트코인을 사용해서 다른 여러 코인을 사고 팔 수 있습니다.

 

그리고 대쉬(-)를 기준으로 오른쪽에 있는 것이 바로 각 코인별로 부여된 닉네임입니다.

BTC는 비트코인, ETH는 이더리움, XRP는 리플입니다.

 

결국 위 Ticker들의 의미를 다시 보면 아래와 같습니다.

KRW-BTC = 원화(KRW) 마켓에서 거래되는 비트코인(BTC)

KRW-ETH = 원화(KRW) 마켓에서 거래되는 이더리움(ETH)

BTC-ETH = 비트코인(BTC) 마켓에서 거래되는 이더리움(ETH)

BTC-XRP = 비트코인(BTC) 마켓에서 거래되는 리플(XRP)

 

 

 

 

 

---

 

 

 

 

import pyupbit as ub

tickers = ub.get_tickers(fiat='KRW')
print(tickers)


-- Result
['KRW-BTC', 'KRW-ETH', 'KRW-NEO', 'KRW-MTL', ...생략... ]

get_tickers method에 fiat 옵션은 기준 통화를 의미합니다.

위처럼 fiat='KRW'를 입력하면 원화(KRW) 마켓에서 거래되는 코인만을 return해줍니다.

fiat 옵션으로 전달할 수 있는 것은 다음과 같습니다.

KRW = 원화

BTC = 비트코인

ETH = 이더리움

USDT = 미국달러 테더화 (=1$)

 

 

 

 

 

---

 

 

 

 

 

import pyupbit as ub

tickers = ub.get_tickers(fiat='KRW', verbose=False)
print(tickers)


-- Result
['KRW-BTC', 'KRW-ETH', 'KRW-NEO', 'KRW-MTL', ...생략... ]

import pyupbit as ub

tickers = ub.get_tickers(fiat='KRW', verbose=True)
print(tickers)


-- Result
[{'market': 'KRW-BTC', 'korean_name': '비트코인', 'english_name': 'Bitcoin'}, {'market': 'KRW-ETH', 'korean_name': '이더리움', 'english_name': 'Ethereum'}, {'market': 'KRW-NEO', 'korean_name': '네오', 'english_name': 'NEO'}, ...생략... ]

get_tickers에는 verbose 옵션도 있습니다.

(프로그래밍에서 verbose라는 옵션은 대부분 어떤 대상의 상세정보를 표시할지 말지를 정하는 인자로서 사용됩니다. verbose가 True면 상세 정보를 표시하고, False면 상세 정보를 표시하지 않는다는 의미의 옵션으로 자주 쓰입니다.)

 

verbose=False -> 코인들의 상세 내용 표시 안함 (default)

verbose=True -> 코인들의 상세 내용 표시

 

verbose를 True로 설정할 경우 위 예시처럼 코인들의 상세 내용이 나옵니다.

그 중 하나를 보면 다음과 같습니다.

{'market': 'KRW-BTC', 'korean_name': '비트코인', 'english_name': 'Bitcoin'}

각 항목별 의미는 다음과 같습니다.

market = 코인의 Ticker

korean_name = 코인의 한글 이름

english_name = 코인의 영어 이름

 

 

 

 

 

---

 

 

 

 

 

import pyupbit as ub

tickers = ub.get_tickers(fiat='KRW', verbose=True, is_details=False)
print(tickers)


-- Result
[{'market': 'KRW-BTC', 'korean_name': '비트코인', 'english_name': 'Bitcoin'}, {'market': 'KRW-ETH', 'korean_name': '이더리움', 'english_name': 'Ethereum'}, {'market': 'KRW-NEO', 'korean_name': '네오', 'english_name': 'NEO'}, ...생략... ]

import pyupbit as ub

tickers = ub.get_tickers(fiat='KRW', verbose=True, is_details=True)
print(tickers)


-- Result
[{'market_warning': 'NONE', 'market': 'KRW-BTC', 'korean_name': '비트코인', 'english_name': 'Bitcoin'}, {'market_warning': 'NONE', 'market': 'KRW-ETH', 'korean_name': '이더리움', 'english_name': 'Ethereum'}, ...생략... ]

get_tickers method에는 is_detail이라는 옵션도 있습니다.

 

is_detail=False -> 각 코인 별 상세정보 표시안함. (default)

is_detail=True -> 각 코인 별 상세정보 표시함.

 

is_detail 옵션은 verbose=True일 때만 그 변화를 알 수 있습니다.

is_detail=True로 설정하면 그 결과에 market_warning이라는 내용이 추가되어서 return됩니다.

 

market_warning 값은 유의종목을 알려주는 flag입니다.

market_waring = 'None' -> 해당 사항 없음

market_waring = 'CAUTION -> 투자 유의

 

 

 

 

참고 자료

https://docs.upbit.com/reference/%EB%A7%88%EC%BC%93-%EC%BD%94%EB%93%9C-%EC%A1%B0%ED%9A%8C