ksxt 0.0.7__py3-none-any.whl → 0.0.9__py3-none-any.whl

ksxt/models/token.py

@@ -0,0 +1,14 @@
+from datetime import datetime
+from pydantic import BaseModel
+from ksxt.models.common import GeneralResponse
+
+
+class TokenInfo(BaseModel):
+    access_token: str
+    token_type: str
+    remain_time_second: float
+    expired_datetime: datetime
+
+
+class KsxtTokenResponse(GeneralResponse[TokenInfo]):
+    pass

ksxt/models/transaction.py

@@ -0,0 +1,79 @@
+from datetime import datetime
+from typing import List, Optional
+from pydantic import BaseModel
+
+from ksxt.models.common import GeneralResponse
+
+
+class TransactionInfo(BaseModel):
+    # 주문 고유 아이디
+    uuid: str
+    # 주문 종류 (ask, bid, deposit, withdrawal)
+    type: str
+
+    # 금액
+    amount: float
+    # 수수료
+    fee: Optional[float] = 0
+
+    # 계좌 번호
+    account_id: Optional[str] = None
+    # 화폐 통화 정보
+    currency: Optional[str] = None
+
+    # 주문 생성 시간
+    created_at: datetime
+
+
+class OpenedOrderInfo(TransactionInfo):
+    # 종목 정보
+    symbol: str
+    # 가격
+    price: float
+    # 수량
+    qty: float
+    # 주문 방식
+    order_type: Optional[str]
+
+
+class ClosedOrderInfo(TransactionInfo):
+    # 종목 정보
+    symbol: str
+    # 가격
+    price: float
+    # 수량
+    qty: float
+    # 주문 방식
+    order_type: Optional[str]
+
+
+class WithdrawalHistory(BaseModel):
+    history: List[TransactionInfo]
+
+
+class DepositHistory(BaseModel):
+    history: List[TransactionInfo]
+
+
+class OpenedOrderHistory(BaseModel):
+    history: List[OpenedOrderInfo]
+
+
+class ClosedOrderHistory(BaseModel):
+    history: List[ClosedOrderInfo]
+
+
+class KsxtWithdrawalHistoryResponse(GeneralResponse[WithdrawalHistory]):
+    pass
+
+
+class KsxtDepositHistoryResponse(GeneralResponse[DepositHistory]):
+    pass
+
+
+class KsxtOpenOrderResponse(GeneralResponse[OpenedOrderHistory]):
+    pass
+
+
+class KsxtClosedOrderResponse(GeneralResponse[ClosedOrderHistory]):
+    pass

ksxt/parser/bithumb.py

@@ -0,0 +1,300 @@
+from datetime import datetime
+from operator import attrgetter
+from typing import Dict, List
+
+from ksxt.models.transaction import (
+    ClosedOrderHistory,
+    ClosedOrderInfo,
+    DepositHistory,
+    OpenedOrderHistory,
+    OpenedOrderInfo,
+    TransactionInfo,
+    WithdrawalHistory,
+)
+from ksxt.models.balance import BalanceData, BalanceInfo
+from ksxt.models.cash import CashInfo
+from ksxt.models.historical import HistoricalDataInfo, OHLCVData
+from ksxt.models.market import MarketInfo, SecurityData, TradeFeeInfo
+from ksxt.models.order import CancelOrderResponse, CreateOrderResponse
+from ksxt.models.orderbook import MultiSymbolOrderBookInfos, OrderBookData, OrderBookInfo
+from ksxt.models.ticker import MultiSymbolTickerInfo, TickerInfo
+from ksxt.parser.parser import BaseParser
+from ksxt.utils import safer, sorter
+
+
+class BithumbParser(BaseParser):
+    def safe_symbol(self, base_market: str, security: str) -> str:
+        return f"{base_market}-{security}"
+
+    def parse_markets(self, response: List[Dict], base_market: str = "KRW") -> MarketInfo:
+        securities = {}
+        for market in response:
+            market_base = market["market"].split("-")[0]
+            if market_base != base_market:
+                continue
+
+            security_data = self._parse_market(market)
+            securities[security_data.symbol] = security_data
+
+        return MarketInfo(market_id=base_market, securities=securities)
+
+    def _parse_market(self, market: Dict) -> SecurityData:
+        return SecurityData(
+            symbol=safer.safe_string(market, "market"),
+            name=safer.safe_string(market, "korean_name"),
+            type="crypto",
+            warning_code=False if safer.safe_string(market, "market_warning") == "NONE" else True,
+        )
+
+    def parse_historical_data(self, response: dict, symbol: str, base_market: str = "KRW") -> HistoricalDataInfo:
+        ohlcv = [self._parse_ohlcva(_, base_market) for _ in response]
+        sorted_ohlcv = sorter.sort_by(ohlcv, key="datetime")
+
+        security_name = symbol
+
+        result = HistoricalDataInfo(
+            symbol=self.safe_symbol(base_market, security_name), security_name=security_name, history=sorted_ohlcv
+        )
+
+        return result
+
+    def _parse_ohlcva(self, ohlcva: dict, base_market: str = "KRW") -> OHLCVData:
+        fmt = "%Y-%m-%dT%H:%M:%S"
+        return OHLCVData(
+            datetime=datetime.strptime(safer.safe_string(ohlcva, "candle_date_time_kst"), fmt),
+            open_price=safer.safe_number(ohlcva, "opening_price"),
+            high_price=safer.safe_number(ohlcva, "high_price"),
+            low_price=safer.safe_number(ohlcva, "low_price"),
+            close_price=safer.safe_number(ohlcva, "trade_price"),
+            acml_volume=safer.safe_number(ohlcva, "candle_acc_trade_volume"),
+            acml_amount=safer.safe_number(ohlcva, "candle_acc_trade_price"),
+        )
+
+    def parse_ticker(self, response: List[Dict], base_market: str = "KRW") -> TickerInfo:
+        ticker_info = self._parse_ticker(response[0], base_market=base_market)
+        return ticker_info
+
+    def parse_tickers(self, response: List[Dict], base_market: str = "KRW") -> MultiSymbolTickerInfo:
+        tickers_info = {}
+
+        for ticker_data in response:
+            symbol = safer.safe_string(ticker_data, "market")
+            ticker_info = self._parse_ticker(ticker_data, base_market)
+            tickers_info[symbol] = ticker_info
+
+        return MultiSymbolTickerInfo(tickers=tickers_info)
+
+    def _parse_ticker(self, response: dict, base_market: str) -> TickerInfo:
+        timestamp_ms = safer.safe_number(response, "timestamp")
+        timestamp_s = timestamp_ms / 1000.0
+
+        return TickerInfo(
+            symbol=safer.safe_string(response, "market"),
+            price=safer.safe_number(response, "trade_price"),
+            ts=datetime.fromtimestamp(timestamp_s),
+        )
+
+    def parse_orderbook(self, response: List[Dict], base_market: str = "KRW") -> OrderBookInfo:
+        ask_list = []
+        bid_list = []
+
+        for item in response:
+            for index, data in enumerate(item["orderbook_units"]):
+                ask_data, bid_data = self._parse_orderbook(data, index, base_market)
+                ask_list.append(ask_data)
+                bid_list.append(bid_data)
+
+        return OrderBookInfo(
+            total_asks_qty=safer.safe_string(response[0], "total_ask_size"),
+            total_bids_qty=safer.safe_string(response[0], "total_bid_size"),
+            asks=ask_list,
+            bids=bid_list,
+        )
+
+    def parse_orderbooks(self, response: dict, base_market: str) -> MultiSymbolOrderBookInfos:
+        order_books = {}
+
+        # response에서 'order_books' 항목이 리스트 형태로 되어 있다고 가정
+        for symbol_info in response:
+            symbol = symbol_info["market"]  # 각 종목의 심볼 추출
+            orderbook_units = symbol_info["orderbook_units"]  # 호가 정보 추출
+
+            ask_list = []
+            bid_list = []
+
+            for index, data in enumerate(orderbook_units):
+                ask_data, bid_data = self._parse_orderbook(data, index, base_market)
+                ask_list.append(ask_data)
+                bid_list.append(bid_data)
+
+            # OrderBookInfo 객체 생성
+            order_book_info = OrderBookInfo(
+                total_asks_qty=safer.safe_number(symbol_info, "total_ask_size"),
+                total_bids_qty=safer.safe_number(symbol_info, "total_bid_size"),
+                asks=ask_list,
+                bids=bid_list,
+            )
+
+            # 심볼과 함께 OrderBookInfo를 딕셔너리에 추가
+            order_books[symbol] = order_book_info
+
+        # MultiSymbolOrderBookInfo 객체 반환
+        return MultiSymbolOrderBookInfos(order_books=order_books)
+
+    def _parse_orderbook(
+        self, orderbook: dict, index: int, base_market: str = "KRW"
+    ) -> tuple[OrderBookData, OrderBookData]:
+        ask_data = OrderBookData(
+            side="ask",
+            ob_num=index,
+            ob_price=safer.safe_number(orderbook, "ask_price"),
+            ob_qty=safer.safe_number(orderbook, "ask_size"),
+        )
+
+        bid_data = OrderBookData(
+            side="bid",
+            ob_num=index,
+            ob_price=safer.safe_number(orderbook, "bid_price"),
+            ob_qty=safer.safe_number(orderbook, "bid_size"),
+        )
+
+        return ask_data, bid_data
+
+    def parse_balance(self, response: List[Dict], base_market: str = "KRW") -> BalanceInfo:
+        # currency가 'KRW'가 아닌 항목만 필터링
+        filtered_data = [data for data in response if data["currency"] != base_market]
+
+        # Initialize balance list
+        balances = [self._parse_balance(data, base_market) for data in filtered_data]
+
+        # 총 매입금액
+        total_amount = sum(bal.price * bal.qty for bal in balances)
+        total_evaluation_amount = sum(bal.evaluation_price * bal.qty for bal in balances)
+        total_pnl_amount = total_evaluation_amount - total_amount
+        total_pnl_ratio = (total_pnl_amount / total_amount * 100) if total_amount != 0 else 0
+
+        return BalanceInfo(
+            currency=base_market,
+            total_amount=total_amount,
+            total_evaluation_amount=total_amount,
+            total_pnl_amount=total_pnl_amount,
+            total_pnl_ratio=total_pnl_ratio,
+            balances=balances,
+        )
+
+    def _parse_balance(self, data: Dict, base_market: str = "KRW") -> BalanceData:
+        return BalanceData(
+            symbol=self.safe_symbol(base_market, safer.safe_string(data, "currency")),
+            name=self.safe_symbol(base_market, safer.safe_string(data, "currency")),
+            evaluation_price=0,  # 필요에 따라 적절히 설정
+            price=safer.safe_number(data, "avg_buy_price"),
+            pnl_amount=0,  # 필요에 따라 적절히 설정
+            pnl_ratio=0,  # 필요에 따라 적절히 설정
+            qty=safer.safe_number(data, "balance"),
+            free_qty=safer.safe_number(data, "balance") - safer.safe_number(data, "locked"),
+            used_qty=safer.safe_number(data, "locked"),
+        )
+
+    def parse_cash(self, response: List[Dict], base_market: str = "KRW") -> CashInfo:
+        # currency가 'KRW'인 항목만 필터링
+        filtered_data = [data for data in response if data["currency"] == base_market]
+
+        # 필터링된 데이터가 없으면 기본값으로 CashInfo 반환
+        if not filtered_data:
+            return CashInfo(currency=base_market, cash=0.0, cash_d1=0.0, cash_d2=0.0)
+
+        # 필터링된 첫 번째 항목을 가져와서 CashInfo 생성
+        data = filtered_data[0]
+
+        return CashInfo(
+            currency=base_market,
+            cash=safer.safe_number(data, "balance"),
+            cash_d1=safer.safe_number(data, "balance"),  # 데이터를 가정하여 같은 값 사용
+            cash_d2=safer.safe_number(data, "balance"),  # 데이터를 가정하여 같은 값 사용
+        )
+
+    def parse_security(self, response: dict, base_market: str = "KRW") -> SecurityData:
+        market_info = response.get("market", {})
+
+        return SecurityData(
+            symbol=safer.safe_string(market_info, "id"),
+            name=safer.safe_string(market_info, "name"),
+            type="crypto",
+            bid_qty_unit=safer.safe_number(market_info["bid"], "price_unit"),
+            ask_qty_unit=safer.safe_number(market_info["ask"], "price_unit"),
+            bid_min_qty=safer.safe_number(market_info["bid"], "min_total"),
+            ask_min_qty=safer.safe_number(market_info["ask"], "min_total"),
+            bid_max_qty=safer.safe_number(market_info, "max_total"),
+            ask_max_qty=safer.safe_number(market_info, "max_total"),
+            bid_min_amount=safer.safe_number(market_info["bid"], "min_total"),
+            ask_min_amount=safer.safe_number(market_info["ask"], "min_total"),
+            bid_max_amount=safer.safe_number(market_info, "max_total"),
+            ask_max_amount=safer.safe_number(market_info, "max_total"),
+            warning_code=safer.safe_string(market_info, "state") != "active",
+        )
+
+    def parse_trade_fee(self, response: dict, base_market: str = "KRW") -> TradeFeeInfo:
+        return TradeFeeInfo(
+            limit_bid_fee=safer.safe_number(response, "bid_fee"),
+            limit_ask_fee=safer.safe_number(response, "ask_fee"),
+            market_bid_fee=safer.safe_number(response, "maker_bid_fee"),
+            market_ask_fee=safer.safe_number(response, "maker_ask_fee"),
+        )
+
+    def parse_open_order_history(self, response: dict, base_market: str = "KRW") -> OpenedOrderHistory:
+        orders = [self._parse_open_order_info(order, base_market) for order in response]
+        return OpenedOrderHistory(history=orders)
+
+    def _parse_open_order_info(self, order: dict, base_market: str = "KRW") -> OpenedOrderInfo:
+        return OpenedOrderInfo(
+            uuid=safer.safe_string(order, "uuid"),
+            type=safer.safe_string(order, "side"),
+            symbol=self.safe_symbol(base_market, safer.safe_string(order, "market")),
+            price=safer.safe_number(order, "price"),
+            qty=safer.safe_number(order, "volume"),
+            amount=safer.safe_number(order, "price") * safer.safe_number(order, "volume"),
+            fee=safer.safe_number(order, "reserved_fee"),
+            created_at=datetime.fromisoformat(safer.safe_string(order, "created_at")),
+            order_type=safer.safe_string(order, "ord_type"),
+        )
+
+    def parse_closed_order_history(self, response: dict, base_market: str = "KRW") -> ClosedOrderHistory:
+        orders = [self._parse_closed_order_info(order, base_market) for order in response]
+        return ClosedOrderHistory(history=orders)
+
+    def _parse_closed_order_info(self, order: dict, base_market: str = "KRW") -> ClosedOrderInfo:
+        return ClosedOrderInfo(
+            uuid=safer.safe_string(order, "uuid"),
+            type=safer.safe_string(order, "side"),
+            symbol=safer.safe_string(order, "market"),
+            price=safer.safe_number(order, "price"),
+            qty=safer.safe_number(order, "volume"),
+            amount=safer.safe_number(order, "price") * safer.safe_number(order, "volume"),
+            fee=safer.safe_number(order, "reserved_fee"),
+            created_at=datetime.fromisoformat(safer.safe_string(order, "created_at")),
+            order_type=safer.safe_string(order, "ord_type"),
+        )
+
+    def parse_cancel_order(self, response: dict, base_market: str = "KRW") -> CancelOrderResponse:
+        return CancelOrderResponse(order_datetime=datetime.now(), order_id=safer.safe_string(response, "uuid"))
+
+    def parse_create_order(self, response: dict, base_market: str = "KRW") -> CreateOrderResponse:
+        return CreateOrderResponse(order_datetime=datetime.now(), order_id=safer.safe_string(response, "uuid"))
+
+    def parse_withdrawal_history(self, response: List[Dict], base_market: str = "KRW") -> WithdrawalHistory:
+        parsed_items = [self._parse_transaction_history_item(item, base_market) for item in response]
+        return WithdrawalHistory(history=parsed_items)
+
+    def parse_deposit_history(self, response: List[Dict], base_market: str = "KRW") -> DepositHistory:
+        parsed_items = [self._parse_transaction_history_item(item, base_market) for item in response]
+        return DepositHistory(history=parsed_items)
+
+    def _parse_transaction_history_item(self, item: Dict, base_market: str = "KRW") -> TransactionInfo:
+        return TransactionInfo(
+            uuid=safer.safe_string(item, "uuid"),
+            type=safer.safe_string(item, "type"),
+            amount=safer.safe_number(item, "amount"),
+            fee=safer.safe_number(item, "fee"),
+            currency=safer.safe_string(item, "currency"),
+            created_at=datetime.fromisoformat(safer.safe_string(item, "created_at")),
+        )