Skip to content

Commit 4ba98f7

Browse files
designmemedesignmeme
committed
feat: 초 캔들 조회 메서드 get_candles_second 추가 (upbit api v1.5.4)
1 parent f2e2dca commit 4ba98f7

File tree

2 files changed

+83
-36
lines changed

2 files changed

+83
-36
lines changed

‎README.md‎

Lines changed: 37 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -63,43 +63,44 @@ data = res.json()
6363
[업비트 REST API][upbit docs api]를 `Upbit` 클래스의 메서드로 제공합니다.
6464
자세한 내용은 [upbit.py](https://github.com/designmeme/python-upbit-api/blob/main/upbit/upbit.py) 파일 내 docstring 참조.
6565

66-
| | | 메서드명 |
67-
|----|:------------|:---------------------------|
68-
| 자산 | 전체 계좌 조회 | get_accounts |
69-
| 주문 | 주문 가능 정보 | get_order_chance |
70-
| | 개별 주문 조회 | get_order |
71-
| | 주문 리스트 조회 | get_orders |
72-
| | id로 주문리스트 조회 | get_orders_by_id |
73-
| | 체결 대기 주문 (Open Order) 조회 | get_open_orders |
74-
| | 종료된 주문 (Closed Order) 조회 | get_closed_orders |
75-
| | 주문 취소 접수 | delete_order |
76-
| | 주문하기 | create_order |
77-
| 출금 | 출금 리스트 조회 | get_withdraws |
78-
| | 개별 출금 조회 | get_withdraw |
79-
| | 출금 가능 정보 | get_withdraw_chance |
80-
| | 디지털 자산 출금하기 | create_withdraw_coin |
81-
| | 원화 출금하기 | create_withdraw_krw |
82-
| | 출금 허용 주소 리스트 조회 | get_withdraw_addresses |
83-
| 입금 | 입금 리스트 조회 | get_deposits |
84-
| | 개별 입금 조회 | get_deposit |
85-
| | 입금 주소 생성 요청 | create_coin_address |
86-
| | 전체 입금 주소 조회 | get_coin_addresses |
87-
| | 개별 입금 주소 조회 | get_coin_address |
88-
| | 원화 입금하기 | create_deposit_krw |
66+
| | | 메서드명 |
67+
|----|:-----------------------------|:---------------------------|
68+
| 자산 | 전체 계좌 조회 | get_accounts |
69+
| 주문 | 주문 가능 정보 | get_order_chance |
70+
| | 개별 주문 조회 | get_order |
71+
| | 주문 리스트 조회 | get_orders |
72+
| | id로 주문리스트 조회 | get_orders_by_id |
73+
| | 체결 대기 주문 (Open Order) 조회 | get_open_orders |
74+
| | 종료된 주문 (Closed Order) 조회 | get_closed_orders |
75+
| | 주문 취소 접수 | delete_order |
76+
| | 주문하기 | create_order |
77+
| 출금 | 출금 리스트 조회 | get_withdraws |
78+
| | 개별 출금 조회 | get_withdraw |
79+
| | 출금 가능 정보 | get_withdraw_chance |
80+
| | 디지털 자산 출금하기 | create_withdraw_coin |
81+
| | 원화 출금하기 | create_withdraw_krw |
82+
| | 출금 허용 주소 리스트 조회 | get_withdraw_addresses |
83+
| 입금 | 입금 리스트 조회 | get_deposits |
84+
| | 개별 입금 조회 | get_deposit |
85+
| | 입금 주소 생성 요청 | create_coin_address |
86+
| | 전체 입금 주소 조회 | get_coin_addresses |
87+
| | 개별 입금 주소 조회 | get_coin_address |
88+
| | 원화 입금하기 | create_deposit_krw |
8989
| | 계정주 확인(트래블룰 검증)가능 거래소 리스트 조회 | get_vasps |
90-
| | 입금 UUID로 트래블룰 검증하기 | verify_travel_rule_by_uuid |
91-
| | 입금 TxID로 트래블룰 검증하기 | verify_travel_rule_by_txid |
92-
| 서비스 정보 | 입출금 현황 | get_wallet_status |
93-
| | API 키 리스트 조회 | get_api_keys |
94-
| 시세 종목 조회 | 마켓 코드 조회 | get_markets |
95-
| 시세 캔들 조회 | 분(Minute) 캔들 | get_candles_minute |
96-
| | 일(Day) 캔들 | get_candles_day |
97-
| | 주(Week) 캔들 | get_candles_week |
98-
| | 월(Month) 캔들 | get_candles_month |
99-
| 시세 체결 조회 | 최근 체결 내역 | get_trades_ticks |
100-
| 시세 현재가 조회 | 현재가 정보 | get_ticker |
101-
| 시세 현재가 조회 | 마켓 단위 현재가 정보 | get_tickers_by_quote |
102-
| 시세 호가 조회 | 호가 정보 | get_orderbook |
90+
| | 입금 UUID로 트래블룰 검증하기 | verify_travel_rule_by_uuid |
91+
| | 입금 TxID로 트래블룰 검증하기 | verify_travel_rule_by_txid |
92+
| 서비스 정보 | 입출금 현황 | get_wallet_status |
93+
| | API 키 리스트 조회 | get_api_keys |
94+
| 시세 종목 조회 | 마켓 코드 조회 | get_markets |
95+
| 시세 캔들 조회 | 초(Second) 캔들 | get_candles_second |
96+
| | 분(Minute) 캔들 | get_candles_minute |
97+
| | 일(Day) 캔들 | get_candles_day |
98+
| | 주(Week) 캔들 | get_candles_week |
99+
| | 월(Month) 캔들 | get_candles_month |
100+
| 시세 체결 조회 | 최근 체결 내역 | get_trades_ticks |
101+
| 시세 현재가 조회 | 현재가 정보 | get_ticker |
102+
| 시세 현재가 조회 | 마켓 단위 현재가 정보 | get_tickers_by_quote |
103+
| 시세 호가 조회 | 호가 정보 | get_orderbook |
103104

104105
### Requests 사용
105106
[Requests][requests] 라이브러리를 사용합니다.

‎upbit/upbit.py‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1701,6 +1701,52 @@ def get_candles_minute(self,
17011701

17021702
return self._request('get', url, params=params, **kwargs)
17031703

1704+
def get_candles_second(self,
1705+
market: str,
1706+
*,
1707+
to: Optional[str] = None,
1708+
count: Optional[int] = None,
1709+
**kwargs) -> Response:
1710+
"""초(Second) 캔들 조회
1711+
1712+
API 요청 및 응답에 대한 자세한 정보는 공식 문서 참고:
1713+
`Upbit API Doc <https://docs.upbit.com/reference/%EC%B4%88second-%EC%BA%94%EB%93%A4>`_
1714+
1715+
:param market: 마켓 코드 (ex. KRW-BTC)
1716+
:param to: 마지막 캔들 시각 (exclusive). 포맷 : yyyy-MM-dd'T'HH:mm:ss'Z' or yyyy-MM-dd HH:mm:ss. 비워서 요청시 가장 최근 캔들
1717+
:param count: 캔들 개수. 최대 200
1718+
:param kwargs: `requests.Session.request` 호출에 사용할 파라미터
1719+
1720+
:return: API 서버 응답
1721+
1722+
Usage::
1723+
1724+
upbit = Upbit()
1725+
res = upbit.get_candles_second('KRW-BTC')
1726+
print(res.json())
1727+
1728+
[{
1729+
"market": "KRW-BTC",
1730+
"candle_date_time_utc": "2024-07-30T09:32:41",
1731+
"candle_date_time_kst": "2024-07-30T18:32:41",
1732+
"opening_price": 93557000,
1733+
"high_price": 93557000,
1734+
"low_price": 93551000,
1735+
"trade_price": 93551000,
1736+
"timestamp": 1722331961297,
1737+
"candle_acc_trade_price": 485957.73742,
1738+
"candle_acc_trade_volume": 0.0051944
1739+
}, ...]
1740+
"""
1741+
url = self._endpoint + "/candles/seconds/"
1742+
params = {
1743+
"market": market,
1744+
"to": to,
1745+
"count": count,
1746+
}
1747+
1748+
return self._request('get', url, params=params, **kwargs)
1749+
17041750
def get_candles_day(self,
17051751
market: str,
17061752
*,

0 commit comments

Comments
 (0)