Method create_order

python/ccxt/async_support/gate.py:4086–4217

Create an order on the exchange https://www.gate.com/docs/developers/apiv4/en/#create-an-order https://www.gate.com/docs/developers/apiv4/en/#create-price-triggered-order https://www.gate.com/docs/developers/apiv4/en/#place-futures-order https://www.gate.com

(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={})

        }

    async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}):
        """
        Create an order on the exchange

        https://www.gate.com/docs/developers/apiv4/en/#create-an-order
        https://www.gate.com/docs/developers/apiv4/en/#create-price-triggered-order
        https://www.gate.com/docs/developers/apiv4/en/#place-futures-order
        https://www.gate.com/docs/developers/apiv4/en/#create-price-triggered-order-2
        https://www.gate.com/docs/developers/apiv4/en/#place-futures-order-2
        https://www.gate.com/docs/developers/apiv4/en/#create-price-triggered-order-3
        https://www.gate.com/docs/developers/apiv4/en/#create-an-options-order

        :param str symbol: Unified CCXT market symbol
        :param str type: 'limit' or 'market' *"market" is contract only*
        :param str side: 'buy' or 'sell'
        :param float amount: the amount of currency to trade
        :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
        :param dict [params]:  extra parameters specific to the exchange API endpoint
        :param float [params.triggerPrice]: The price at which a trigger order is triggered at
        :param str [params.timeInForce]: "GTC", "IOC", or "PO"
        :param float [params.stopLossPrice]: The price at which a stop loss order is triggered at
        :param float [params.takeProfitPrice]: The price at which a take profit order is triggered at
        :param str [params.marginMode]: 'cross' or 'isolated' - marginMode for margin trading if not provided self.options['defaultMarginMode'] is used
        :param int [params.iceberg]: Amount to display for the iceberg order, Null or 0 for normal orders, Set to -1 to hide the order completely
        :param str [params.text]: User defined information
        :param str [params.account]: *spot and margin only* "spot", "margin" or "cross_margin"
        :param bool [params.auto_borrow]: *margin only* Used in margin or cross margin trading to allow automatic loan of insufficient amount if balance is not enough
        :param str [params.settle]: *contract only* Unified Currency Code for settle currency
        :param bool [params.reduceOnly]: *contract only* Indicates if self order is to reduce the size of a position
        :param bool [params.close]: *contract only* Set to close the position, with size set to 0
        :param bool [params.auto_size]: *contract only* Set side to close dual-mode position, close_long closes the long side, while close_short the short one, size also needs to be set to 0
        :param int [params.price_type]: *contract only* 0 latest deal price, 1 mark price, 2 index price
        :param float [params.cost]: *spot market buy only* the quote quantity that can be used alternative for the amount
        :param bool [params.unifiedAccount]: set to True for creating an order in the unified account
        :param str [params.clientOrderId]: the clientOrderId of the order
        :returns dict|None: `An order structure <https://docs.ccxt.com/?id=order-structure>`
        """
        await self.load_markets()
        await self.load_unified_status()
        market = self.market(symbol)
        trigger = self.safe_value(params, 'trigger')
        triggerPrice = self.safe_value_2(params, 'triggerPrice', 'stopPrice')
        stopLossPrice = self.safe_value(params, 'stopLossPrice', triggerPrice)
        takeProfitPrice = self.safe_value(params, 'takeProfitPrice')
        isStopLossOrder = stopLossPrice is not None
        isTakeProfitOrder = takeProfitPrice is not None
        isTpsl = isStopLossOrder or isTakeProfitOrder
        nonTriggerOrder = not isTpsl and (trigger is None)
        orderRequest = self.create_order_request(symbol, type, side, amount, price, params)
        response: dict
        if market['spot'] or market['margin']:
            if nonTriggerOrder:
                response = await self.privateSpotPostOrders(orderRequest)
            else:
                response = await self.privateSpotPostPriceOrders(orderRequest)
        elif market['swap']:
            if nonTriggerOrder:
                response = await self.privateFuturesPostSettleOrders(orderRequest)