Sign in
Trading

Place Trade

Place a buy or sell order on a centralized exchange.

Submit a new order to buy or sell an asset through a configured account and connector. Supports spot trading (BUY/SELL) and perpetual futures trading with position actions (OPEN/CLOSE). For market orders, the price is fetched automatically from the market data feed. For limit orders, a price must be specified.

The order is submitted asynchronously to the exchange. The returned order_id can be used to track the order status via the /orders/active or /orders/search endpoints, or to cancel the order via the cancel endpoint.

post/trading/orders

Request body

account_namestring required

Name of the configured account to execute the trade. Must match an account in the configuration.

connector_namestring required

Name of the exchange connector (e.g., 'binance', 'binance_perpetual', 'kucoin', 'gate_io'). Use '_perpetual' suffix for futures trading.

trading_pairstring required

Trading pair in BASE-QUOTE format (e.g., 'BTC-USDT', 'ETH-USDC'). Must be a valid pair on the specified connector.

trade_type'BUY' | 'SELL' required

Order direction. 'BUY' to purchase base asset, 'SELL' to sell base asset.

order_type'LIMIT' | 'MARKET' | 'LIMIT_MAKER'

Order execution type. 'LIMIT' requires a price. 'MARKET' executes at best available price. 'LIMIT_MAKER' is a limit order that will be rejected if it would immediately match.

position_action'OPEN' | 'CLOSE'

Position action for perpetual futures trading. 'OPEN' to enter a new position or add to existing. 'CLOSE' to reduce or exit a position. For spot trading, this is typically 'OPEN'.

Response

Successful Response

order_idstring required

Client order ID assigned by the system. Use this ID to track, cancel, or query the order.

account_namestring required

Name of the account that placed the order.

connector_namestring required

Name of the exchange connector used for the order.

trading_pairstring required

Trading pair for the order (e.g., 'BTC-USDT').

trade_typestring required

Order direction: 'BUY' or 'SELL'.

amountstring required

Order quantity in base asset.

order_typestring required

Order type: 'LIMIT', 'MARKET', or 'LIMIT_MAKER'.

pricestring nullable required

Order price. Null for market orders.

statusstring

Initial order status. 'submitted' indicates the order was sent to the exchange. Query /orders/active or /orders/search for updated status.

Changes