post
https://api.liquiditytech.com/api/v1/trading/order
Rate Limit: 1200 requests per 60 seconds
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Rate Limit: 1200 requests per 60 seconds
Submit a new order to the connected venue (spot / margin / perpetual). Using a unified sym identifier format across exchanges and business types.
Permission: Requires trading permission on the corresponding API key. Read-only keys cannot call this endpoint.
Request
| Field | Type | Necessary | Description |
|---|---|---|---|
clientOrderId | String | N | Client-defined order ID. Only supports lowercase letters (a-z) and digits (0-9). Recommended length ≤ 32 characters. If omitted, LTP will auto-generate an ID. |
sym | String | Y | Trading symbol unique identifier in the format Exchange_Business_Base_Counter. For example: BINANCE_SPOT_BTC_USDT (Binance spot BTC/USDT), BINANCE_PERP_BTC_USDT (Binance perpetual BTC/USDT), BINANCE_MARGIN_BTC_USDT (Binance margin BTC/USDT). Currently supports SPOT, MARGIN, PERPETUAL on BINANCE / OKX, and PERPETUAL on EDX. |
side | String | Y | Order side. Supported values: BUY, SELL. |
orderType | String | Y | Order type. Supported values: LIMIT, MARKET. |
timeInForce | String | N | Time-in-force policy. For LIMIT orders: default GTC, supports GTC, IOC, FOK, GTX (GTX = GTC + Post-only). For MARKET orders: do not send this field, default behavior is IOC. |
orderQty | String | N | Order quantity. Required unless the order is a spot market buy using quoteOrderQty. For spot, this is the base asset quantity (e.g. in ETH/BTC, orderQty is in ETH). For derivatives: on OKX it is the number of contracts; on Binance and EDX it is the base asset quantity. |
limitPrice | String | N | Limit order price. Mandatory when orderType = LIMIT. Ignored for market orders. |
quoteOrderQty | String | N | Order amount in the quote currency, only used for spot market buy orders. Limit orders must use orderQty; market sell orders must use orderQty; market buy (spot) orders must use quoteOrderQty. |
reduceOnly | String | N | Reduce-only flag for derivatives orders. Must be "TRUE" or "FALSE" (string). Usually ignored by spot venues. |
positionSide | String | N | Position side. Supported values: NONE, LONG, SHORT. In hedge mode (BOTH) this field is required, and must be LONG or SHORT. In one-way mode (NET) this field is optional; if omitted, it defaults to NONE. |
tpTriggerPrice | String | N | Take-profit trigger price. |
tpTriggerType | String | N | Take-profit trigger price type. Supported values: LAST_PRICE, MARK_PRICE. Default is LAST_PRICE. |
tpPrice | String | N | Take-profit order price. "0" indicates market price. Default "0". |
slTriggerPrice | String | N | Stop-loss trigger price. |
slTriggerType | String | N | Stop-loss trigger price type. Supported values: LAST_PRICE, MARK_PRICE. Default is LAST_PRICE. |
slPrice | String | N | Stop-loss order price. "0" indicates market price. Default "0". |
Response
| Field | Type | Description |
|---|---|---|
code | Integer | Business status code. 200000 indicates the request was processed successfully. |
message | String | Text description of the result, usually "Success" on success. |
data.orderId | String | LTP system-generated unique order ID. Used for later querying, cancelling, and order history. |
data.clientOrderId | String | Echo of the client-defined order ID from the request. Empty / omitted if clientOrderId was not provided. |
Example Request
{
"sym": "BINANCE_SPOT_ETH_USDT",
"side": "BUY",
"orderType": "LIMIT",
"orderQty": "0.5",
"limitPrice": "3100",
"timeInForce": "GTC",
"clientOrderId": "myorder001"
}
Example Response
{
"code": 200000,
"message": "Success",
"data": {
"orderId": "1234567890123456",
"clientOrderId": "10003232424324324243243201"
}
}