pybinbot 0.1.6__py3-none-any.whl → 0.4.15__py3-none-any.whl

pybinbot/apis/kucoin/orders.py

@@ -0,0 +1,663 @@
+import random
+import uuid
+import logging
+from time import sleep, time
+from pybinbot.apis.kucoin.market import KucoinMarket
+from kucoin_universal_sdk.generate.spot.order.model_add_order_sync_resp import (
+    AddOrderSyncResp,
+)
+from kucoin_universal_sdk.generate.spot.order.model_add_order_sync_req import (
+    AddOrderSyncReq,
+    AddOrderSyncReqBuilder,
+)
+from kucoin_universal_sdk.generate.spot.order.model_batch_add_orders_sync_req import (
+    BatchAddOrdersSyncReqBuilder,
+)
+from kucoin_universal_sdk.generate.spot.order.model_batch_add_orders_sync_order_list import (
+    BatchAddOrdersSyncOrderList,
+)
+from kucoin_universal_sdk.generate.spot.order.model_cancel_order_by_order_id_sync_req import (
+    CancelOrderByOrderIdSyncReqBuilder,
+)
+from kucoin_universal_sdk.generate.spot.order.model_get_order_by_order_id_req import (
+    GetOrderByOrderIdReqBuilder,
+)
+from kucoin_universal_sdk.generate.spot.order.model_get_open_orders_req import (
+    GetOpenOrdersReqBuilder,
+)
+from kucoin_universal_sdk.generate.margin.order.model_add_order_req import (
+    AddOrderReq,
+    AddOrderReqBuilder,
+)
+from kucoin_universal_sdk.generate.margin.order.model_cancel_order_by_order_id_req import (
+    CancelOrderByOrderIdReqBuilder,
+)
+from kucoin_universal_sdk.generate.margin.order.model_get_order_by_order_id_resp import (
+    GetOrderByOrderIdResp,
+)
+from kucoin_universal_sdk.generate.margin.debit.model_repay_req import (
+    RepayReqBuilder,
+)
+from kucoin_universal_sdk.generate.margin.debit.model_repay_resp import (
+    RepayResp,
+)
+from kucoin_universal_sdk.generate.margin.debit.model_borrow_req import (
+    BorrowReqBuilder,
+)
+from kucoin_universal_sdk.generate.margin.debit.model_borrow_resp import (
+    BorrowResp,
+)
+from kucoin_universal_sdk.generate.account.transfer.model_flex_transfer_req import (
+    FlexTransferReqBuilder,
+    FlexTransferReq,
+)
+from kucoin_universal_sdk.generate.account.transfer.model_flex_transfer_resp import (
+    FlexTransferResp,
+)
+from kucoin_universal_sdk.generate.spot.market import (
+    GetPartOrderBookReqBuilder,
+    GetFullOrderBookReqBuilder,
+)
+
+from pybinbot.shared.enums import KucoinKlineIntervals
+
+
+class KucoinOrders(KucoinMarket):
+    """
+    Convienience wrapper for Kucoin order operations.
+
+    - Kucoin transactions don't immediately return all order details so we need cooldown slee
+    """
+
+    TRANSACTION_COOLDOWN_SECONDS = 1
+
+    def __init__(self, key: str, secret: str, passphrase: str):
+        super().__init__(key=key, secret=secret, passphrase=passphrase)
+        self.client = self.setup_client()
+        self.spot_api = self.client.rest_service().get_spot_service().get_market_api()
+        self.order_api = self.client.rest_service().get_spot_service().get_order_api()
+        self.margin_order_api = (
+            self.client.rest_service().get_margin_service().get_order_api()
+        )
+        self.debit_api = self.client.rest_service().get_margin_service().get_debit_api()
+        self.transfer_api = (
+            self.client.rest_service().get_account_service().get_transfer_api()
+        )
+
+    def _get_order_with_retry(
+        self, symbol: str, order_id: str, max_retries: int = 10
+    ) -> GetOrderByOrderIdResp:
+        """
+        Get order by ID with exponential backoff retry.
+        KuCoin's order data is not immediately available after placement.
+
+        We only consider the order "ready" when:
+        - it is no longer active (order.active is False), and
+        - id, price and size are all populated.
+
+        Exponential backoff: 2 ** attempt number / 10 = 100ms, 200ms, ...
+        """
+        for attempt in range(max_retries):
+            logging.info(f"Attempt {attempt + 1} to get order {order_id}")
+            order = self.get_order_by_order_id(symbol=symbol, order_id=order_id)
+
+            if order:
+                # We require a minimum set of fields before downstream code can
+                # safely update deals:
+                # - id (order_id)
+                # - price
+                # - size (quantity)
+                # and the order must no longer be active.
+
+                is_active = getattr(order, "active", None)
+
+                if is_active:
+                    logging.info(
+                        "KuCoin order %s is still active on attempt %d; waiting for completion",
+                        order_id,
+                        attempt + 1,
+                    )
+                else:
+                    missing: list[str] = []
+                    if not getattr(order, "id", None):
+                        missing.append("id")
+                    if getattr(order, "price", None) is None:
+                        missing.append("price")
+                    if getattr(order, "size", None) is None:
+                        missing.append("size")
+
+                    if not missing:
+                        return order
+
+                    logging.info(
+                        "KuCoin order %s inactive but missing required fields %s on attempt %d; retrying",
+                        order_id,
+                        ",".join(missing),
+                        attempt + 1,
+                    )
+
+            sleep((2**attempt) / 10)
+
+        raise TimeoutError(f"Order {order_id} not ready after {max_retries} attempts")
+
+    def _get_margin_order_with_retry(
+        self, symbol: str, order_id: str, max_retries: int = 10
+    ) -> GetOrderByOrderIdResp:
+        """
+        Get margin order by ID with exponential backoff retry.
+        KuCoin's order data is not immediately available after placement.
+        """
+        for attempt in range(max_retries):
+            order = self.get_margin_order_by_order_id(symbol=symbol, order_id=order_id)
+            if order and order.order_id:
+                return order
+            # Exponential backoff: 100ms, 200ms, 400ms, 800ms...
+            sleep((2**attempt) / 10)
+
+        raise TimeoutError(
+            f"Margin order {order_id} not ready after {max_retries} attempts"
+        )
+
+    def get_part_order_book(self, symbol: str, size: int):
+        request = (
+            GetPartOrderBookReqBuilder().set_symbol(symbol).set_size(str(size)).build()
+        )
+        response = self.spot_api.get_part_order_book(request)
+        return response
+
+    def get_full_order_book(self, symbol: str, size: int):
+        request = GetFullOrderBookReqBuilder().set_symbol(symbol).build()
+        response = self.spot_api.get_full_order_book(request)
+        return response
+
+    def simulate_order(
+        self,
+        symbol: str,
+        side: AddOrderSyncReq.SideEnum,
+        order_type: AddOrderSyncReq.TypeEnum = AddOrderSyncReq.TypeEnum.LIMIT,
+        qty: float = 1,
+    ) -> GetOrderByOrderIdResp:
+        """
+        Fake synchronous order response shaped similarly to add_order_sync.
+        Returns a dict echoing inputs and a computed price when missing.
+        """
+        book_price = self.matching_engine(
+            symbol, order_side=(side == AddOrderSyncReq.SideEnum.SELL), qty=qty
+        )
+        # fake data
+        ts = int(time() * 1000)
+        order_id = str(random.randint(1000000000, 9999999999))
+
+        order = GetOrderByOrderIdResp.model_validate(
+            {
+                "id": order_id,
+                "symbol": symbol,
+                "op_type": "DEAL",
+                "type": order_type.value,
+                "side": side.value.lower(),
+                "price": str(book_price),
+                "size": str(qty),
+                "funds": str(float(book_price) * qty),
+                "deal_funds": str(float(book_price) * qty),
+                "deal_size": str(qty),
+                "fee": "0",
+                "fee_currency": symbol.split("-")[1],
+                "stp": "CN",
+                "stop": "",
+                "stop_price": "0",
+                "time_in_force": AddOrderSyncReq.TimeInForceEnum.GTC.value,
+                "post_only": False,
+                "hidden": False,
+                "iceberg": False,
+                "visible_size": "0",
+                "cancel_after": 0,
+                "channel": "API",
+                "client_oid": "",
+                "remark": "",
+                "tags": "",
+                "is_active": False,
+                "cancel_exist": False,
+                "created_at": ts,
+            }
+        )
+        return order
+
+    def simple_matching_engine(self, symbol: str, order_side: bool) -> float:
+        """
+        Get top of book price for immediate buy/sell
+        this is good for paper trading
+        or initial price estimates
+
+        @param: order_side -
+            Buy order = get bid prices = False
+            Sell order = get ask prices = True
+        """
+        # Part order book only returns top 1 level at time of writing
+        data = self.get_part_order_book(symbol, size=1)
+        price = data.bids[0][0] if order_side else data.asks[0][0]
+        return price
+
+    def matching_engine(self, symbol: str, order_side: bool, qty: float = 0) -> float:
+        """
+        Match quantity with available 100% fill order price,
+        so that order can immediately buy/sell
+
+        Only use this if we need to find optimal price for given qty
+
+        @param: order_side -
+            Buy order = get bid prices = False
+            Sell order = get ask prices = True
+        """
+        # --- Step 1: Get order book ---
+        data = self.get_full_order_book(symbol, size=10)
+
+        # top-of-book price and available qty
+        top_price = float(data.asks[0][0]) if order_side else float(data.bids[0][0])
+        top_qty = float(data.asks[0][1]) if order_side else float(data.bids[0][1])
+
+        # --- Step 2: Compute VWAP for last 5 candles ---
+        candles = self.get_ui_klines(
+            symbol, interval=KucoinKlineIntervals.FIFTEEN_MINUTES.value, limit=10
+        )
+        total_volume = sum(float(c[5]) for c in candles)
+        vwap = (
+            sum(float(c[4]) * float(c[5]) for c in candles) / total_volume
+        )  # c[4] = close
+
+        # --- Step 3: Determine safe price based on VWAP and top-of-book ---
+        safe_offset = 0.002  # 0.2%
+        if order_side:  # sell
+            # Never above top ask, slightly above VWAP
+            safe_price = min(top_price, vwap * (1 + safe_offset))
+        else:  # buy
+            # Never below top bid, slightly below VWAP
+            safe_price = max(top_price, vwap * (1 - safe_offset))
+
+        # --- Step 4: Ensure top-of-book has enough liquidity for qty ---
+        # qty here is in quote currency, convert to base qty
+        base_qty_needed = float(qty) / safe_price
+        if base_qty_needed > top_qty:
+            # Not enough at top level; fallback to top-of-book price to guarantee execution
+            safe_price = top_price
+
+        return safe_price
+
+    def buy_order(
+        self,
+        symbol: str,
+        qty: float,
+        order_type: AddOrderSyncReq.TypeEnum = AddOrderSyncReq.TypeEnum.LIMIT,
+    ) -> GetOrderByOrderIdResp:
+        """
+        Wrapper for Kucoin add order for convenience and consistency with other exchanges.
+
+        Price is not provided so LIMIT orders can be filled immediately using matching engine.
+
+        Because add_order_sync doesn't return enough info for our orders,
+        we need to retrieve the order by order id after placing it.
+        And because retrieving it is not immediate, we need to sleep delay
+        """
+        book_price = self.matching_engine(symbol, order_side=False, qty=qty)
+        builder = (
+            AddOrderSyncReqBuilder()
+            .set_symbol(symbol)
+            .set_side(AddOrderSyncReq.SideEnum.BUY)
+            .set_type(order_type)
+            .set_size(str(qty))
+            .set_price(str(book_price))
+        )
+
+        req = builder.build()
+        order_response = self.order_api.add_order_sync(req)
+        # order_response returns incomplete info, retry with backoff
+        order = self._get_order_with_retry(
+            symbol=symbol, order_id=order_response.order_id
+        )
+        logging.error(f"Buy order status active? {order.active}")
+        return order
+
+    def sell_order(
+        self,
+        symbol: str,
+        qty: float,
+        order_type: AddOrderSyncReq.TypeEnum = AddOrderSyncReq.TypeEnum.LIMIT,
+    ) -> GetOrderByOrderIdResp:
+        """
+        Wrapper for Kucoin add order for convenience and consistent interface with other exchanges.
+
+        Price is not provided so LIMIT orders can be filled immediately using matching engine.
+
+        Because add_order_sync doesn't return enough info for our orders,
+        we need to retrieve the order by order id after placing it.
+        And because retrieving it is not immediate, we need to sleep delay
+        """
+        book_price = self.matching_engine(symbol, order_side=True, qty=qty)
+        builder = (
+            AddOrderSyncReqBuilder()
+            .set_symbol(symbol)
+            .set_side(AddOrderSyncReq.SideEnum.SELL)
+            .set_type(order_type)
+            .set_size(str(qty))
+            .set_price(str(book_price))
+        )
+
+        req = builder.build()
+        order_response = self.order_api.add_order_sync(req)
+        # order_response returns incomplete info, retry with backoff
+        order = self._get_order_with_retry(
+            symbol=symbol, order_id=order_response.order_id
+        )
+        return order
+
+    def batch_add_orders_sync(self, orders: list[dict]) -> AddOrderSyncResp:
+        """
+        Batch place up to 5 limit orders for the same symbol.
+        Each dict in `orders` should contain: symbol, side, type, size, price (for limit), optional fields as per SDK.
+
+        Not usable at the time of writing due to inconsistency with other exchange's interfaces (other exchanges might not support batch orders).
+        """
+        order_list: list[BatchAddOrdersSyncOrderList] = []
+        for o in orders:
+            item = BatchAddOrdersSyncOrderList(
+                client_oid=o.get("clientOid"),
+                symbol=o["symbol"],
+                side=(
+                    BatchAddOrdersSyncOrderList.SideEnum.BUY
+                    if str(o["side"]).lower() == "buy"
+                    else BatchAddOrdersSyncOrderList.SideEnum.SELL
+                ),
+                type=BatchAddOrdersSyncOrderList.TypeEnum.LIMIT,
+                size=str(o["size"]),
+                price=str(o["price"]) if "price" in o else None,
+                time_in_force=BatchAddOrdersSyncOrderList.TimeInForceEnum.GTC,
+            )
+            order_list.append(item)
+
+        req = BatchAddOrdersSyncReqBuilder().set_order_list(order_list).build()
+        return self.order_api.batch_add_orders_sync(req)
+
+    def cancel_order_by_order_id_sync(self, symbol: str, order_id: str):
+        req = (
+            CancelOrderByOrderIdSyncReqBuilder()
+            .set_symbol(symbol)
+            .set_order_id(order_id)
+            .build()
+        )
+        return self.order_api.cancel_order_by_order_id_sync(req)
+
+    def get_order_by_order_id(
+        self, symbol: str, order_id: str
+    ) -> GetOrderByOrderIdResp:
+        req = (
+            GetOrderByOrderIdReqBuilder()
+            .set_symbol(symbol)
+            .set_order_id(order_id)
+            .build()
+        )
+        return self.order_api.get_order_by_order_id(req)
+
+    def get_open_orders(self, symbol: str):
+        req = GetOpenOrdersReqBuilder().set_symbol(symbol).build()
+        return self.order_api.get_open_orders(req)
+
+    # --- Margin (Isolated) operations ---
+    def buy_margin_order(
+        self,
+        symbol: str,
+        qty: float,
+        order_type: AddOrderReq.TypeEnum = AddOrderReq.TypeEnum.LIMIT,
+        price: float = 0,
+        time_in_force: AddOrderReq.TimeInForceEnum = AddOrderReq.TimeInForceEnum.GTC,
+        client_oid: str | None = None,
+        auto_borrow: bool = False,
+        auto_repay: bool = False,
+    ) -> GetOrderByOrderIdResp:
+        builder = (
+            AddOrderReqBuilder()
+            .set_symbol(symbol)
+            .set_side(AddOrderReq.SideEnum.BUY)
+            .set_type(order_type)
+            .set_size(str(qty))
+            .set_time_in_force(time_in_force)
+            .set_is_isolated(True)
+        )
+        if client_oid:
+            builder = builder.set_client_oid(client_oid)
+        if order_type == AddOrderReq.TypeEnum.LIMIT and price > 0:
+            builder = builder.set_price(str(price))
+        if auto_borrow:
+            builder = builder.set_auto_borrow(True)
+        if auto_repay:
+            builder = builder.set_auto_repay(True)
+
+        req = builder.build()
+        order_response = self.margin_order_api.add_order(req)
+        # order_response returns incomplete info, retry with backoff
+        order = self._get_margin_order_with_retry(
+            symbol=symbol, order_id=order_response.order_id
+        )
+        return order
+
+    def sell_margin_order(
+        self,
+        symbol: str,
+        qty: float,
+        order_type: AddOrderReq.TypeEnum = AddOrderReq.TypeEnum.LIMIT,
+        price: float = 0,
+        time_in_force: AddOrderReq.TimeInForceEnum = AddOrderReq.TimeInForceEnum.GTC,
+        client_oid: str | None = None,
+        auto_borrow: bool = False,
+        auto_repay: bool = False,
+    ) -> GetOrderByOrderIdResp:
+        builder = (
+            AddOrderReqBuilder()
+            .set_symbol(symbol)
+            .set_side(AddOrderReq.SideEnum.SELL)
+            .set_type(order_type)
+            .set_size(str(qty))
+            .set_time_in_force(time_in_force)
+            .set_is_isolated(True)
+        )
+        if client_oid:
+            builder = builder.set_client_oid(client_oid)
+        if order_type == AddOrderReq.TypeEnum.LIMIT and price > 0:
+            builder = builder.set_price(str(price))
+        if auto_borrow:
+            builder = builder.set_auto_borrow(True)
+        if auto_repay:
+            builder = builder.set_auto_repay(True)
+
+        req = builder.build()
+        order_response = self.margin_order_api.add_order(req)
+        # order_response returns incomplete info, retry with backoff
+        order = self._get_margin_order_with_retry(
+            symbol=symbol, order_id=order_response.order_id
+        )
+        return order
+
+    def cancel_margin_order_by_order_id(self, symbol: str, order_id: str):
+        # Margin API uses cancel by order id req builder from margin.order
+        req_cancel = (
+            CancelOrderByOrderIdReqBuilder()
+            .set_symbol(symbol)
+            .set_order_id(order_id)
+            .build()
+        )
+        return self.margin_order_api.cancel_order_by_order_id(req_cancel)
+
+    def get_margin_order_by_order_id(
+        self, symbol: str, order_id: str
+    ) -> GetOrderByOrderIdResp:
+        req = (
+            GetOrderByOrderIdReqBuilder()
+            .set_symbol(symbol)
+            .set_order_id(order_id)
+            .build()
+        )
+        return self.margin_order_api.get_order_by_order_id(req)
+
+    def get_margin_open_orders(self, symbol: str):
+        req = GetOpenOrdersReqBuilder().set_symbol(symbol).build()
+        return self.margin_order_api.get_open_orders(req)
+
+    def simulate_margin_order(
+        self,
+        symbol: str,
+        side: AddOrderReq.SideEnum,
+        order_type: AddOrderReq.TypeEnum = AddOrderReq.TypeEnum.LIMIT,
+        qty: float = 1,
+    ) -> GetOrderByOrderIdResp:
+        """
+        Fake isolated margin order response echoing inputs.
+        """
+        book_price = self.matching_engine(
+            symbol, order_side=(side == AddOrderReq.SideEnum.SELL), qty=qty
+        )
+        ts = int(time() * 1000)
+        order_id = str(random.randint(1000000000, 9999999999))
+        order = GetOrderByOrderIdResp.model_validate(
+            {
+                "id": order_id,
+                "symbol": symbol,
+                "op_type": "DEAL",
+                "type": order_type.value,
+                "side": side.value.lower(),
+                "price": str(book_price),
+                "size": str(qty),
+                "funds": str(float(book_price) * qty),
+                "deal_funds": str(float(book_price) * qty),
+                "deal_size": str(qty),
+                "fee": "0",
+                "fee_currency": symbol.split("-")[1],
+                "stp": "CN",
+                "stop": "",
+                "stop_price": "0",
+                "time_in_force": AddOrderSyncReq.TimeInForceEnum.GTC.value,
+                "post_only": False,
+                "hidden": False,
+                "iceberg": False,
+                "visible_size": "0",
+                "cancel_after": 0,
+                "channel": "API",
+                "client_oid": "",
+                "remark": "",
+                "tags": "",
+                "is_active": False,
+                "cancel_exist": False,
+                "created_at": ts,
+            }
+        )
+        return order
+
+    def repay_margin_loan(
+        self,
+        asset: str,
+        symbol: str,
+        amount: float,
+    ) -> RepayResp:
+        req = (
+            RepayReqBuilder()
+            .set_currency(asset)
+            .set_symbol(symbol)
+            .set_size(str(amount))
+            .set_is_isolated(True)
+            .build()
+        )
+        return self.debit_api.repay(req)
+
+    def transfer_isolated_margin_to_spot(
+        self, asset: str, symbol: str, amount: float
+    ) -> FlexTransferResp:
+        """
+        Transfer funds from isolated margin to spot (main) account.
+        `symbol` is the isolated pair like "BTC-USDT".
+        """
+        client_oid = str(uuid.uuid4())
+        req = (
+            FlexTransferReqBuilder()
+            .set_client_oid(client_oid)
+            .set_currency(asset)
+            .set_amount(str(amount))
+            .set_type(FlexTransferReq.TypeEnum.INTERNAL)
+            .set_from_account_type(FlexTransferReq.FromAccountTypeEnum.ISOLATED)
+            .set_from_account_tag(symbol)
+            .set_to_account_type(FlexTransferReq.ToAccountTypeEnum.MAIN)
+            .build()
+        )
+        return self.transfer_api.flex_transfer(req)
+
+    def transfer_spot_to_isolated_margin(
+        self, asset: str, symbol: str, amount: float
+    ) -> FlexTransferResp:
+        """
+        Transfer funds from spot (main) account to isolated margin account.
+        `symbol` must be the isolated pair like "BTC-USDT".
+        """
+        client_oid = str(uuid.uuid4())
+        req = (
+            FlexTransferReqBuilder()
+            .set_client_oid(client_oid)
+            .set_currency(asset)
+            .set_amount(str(amount))
+            .set_type(FlexTransferReq.TypeEnum.INTERNAL)
+            .set_from_account_type(FlexTransferReq.FromAccountTypeEnum.MAIN)
+            .set_to_account_type(FlexTransferReq.ToAccountTypeEnum.ISOLATED)
+            .set_to_account_tag(symbol)
+            .build()
+        )
+        return self.transfer_api.flex_transfer(req)
+
+    def transfer_main_to_trade(self, asset: str, amount: float) -> FlexTransferResp:
+        """
+        Transfer funds from main to trade (spot) account.
+        """
+        client_oid = str(uuid.uuid4())
+        req = (
+            FlexTransferReqBuilder()
+            .set_client_oid(client_oid)
+            .set_currency(asset)
+            .set_amount(str(amount))
+            .set_type(FlexTransferReq.TypeEnum.INTERNAL)
+            .set_from_account_type(FlexTransferReq.FromAccountTypeEnum.MAIN)
+            .set_to_account_type(FlexTransferReq.ToAccountTypeEnum.TRADE)
+            .build()
+        )
+        return self.transfer_api.flex_transfer(req)
+
+    def transfer_trade_to_main(self, asset: str, amount: float) -> FlexTransferResp:
+        """
+        Transfer funds from trade (spot) account to main.
+        """
+        client_oid = str(uuid.uuid4())
+        req = (
+            FlexTransferReqBuilder()
+            .set_client_oid(client_oid)
+            .set_currency(asset)
+            .set_amount(str(amount))
+            .set_type(FlexTransferReq.TypeEnum.INTERNAL)
+            .set_from_account_type(FlexTransferReq.FromAccountTypeEnum.TRADE)
+            .set_to_account_type(FlexTransferReq.ToAccountTypeEnum.MAIN)
+            .build()
+        )
+        return self.transfer_api.flex_transfer(req)
+
+    def create_margin_loan(
+        self,
+        asset: str,
+        symbol: str,
+        amount: float,
+        is_isolated: bool = True,
+    ) -> BorrowResp:
+        """
+        Create a margin loan (borrow) on KuCoin.
+        For isolated margin, pass the trading pair in `symbol` (e.g., "BTC-USDT") and set `is_isolated=True`.
+        """
+        req = (
+            BorrowReqBuilder()
+            .set_currency(asset)
+            .set_symbol(symbol)
+            .set_size(str(amount))
+            .set_is_isolated(is_isolated)
+            .build()
+        )
+        return self.debit_api.borrow(req)

pybinbot/apis/kucoin/rest.py

@@ -0,0 +1,33 @@
+from kucoin_universal_sdk.api import DefaultClient
+from kucoin_universal_sdk.model import TransportOptionBuilder
+from kucoin_universal_sdk.model import ClientOptionBuilder
+from kucoin_universal_sdk.model import (
+    GLOBAL_API_ENDPOINT,
+)
+
+
+class KucoinRest:
+    def __init__(self, key: str, secret: str, passphrase: str):
+        self.key = key
+        self.secret = secret
+        self.passphrase = passphrase
+
+    def setup_client(self) -> DefaultClient:
+        http_transport_option = (
+            TransportOptionBuilder()
+            .set_keep_alive(True)
+            .set_max_pool_size(10)
+            .set_max_connection_per_pool(10)
+            .build()
+        )
+        client_option = (
+            ClientOptionBuilder()
+            .set_key(self.key)
+            .set_secret(self.secret)
+            .set_passphrase(self.passphrase)
+            .set_spot_endpoint(GLOBAL_API_ENDPOINT)
+            .set_transport_option(http_transport_option)
+            .build()
+        )
+        self.client = DefaultClient(client_option)
+        return self.client