POST
https://dev.yimmit.com/api/v3/liquidity/ordersCreate Order
POST api/v3/liquidity/orders
Create a Sell/Buy order.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| market | STRING | YES | Market pair code (e.g., btcusdt, ethbtc). |
| side | STRING | YES | Order side: buy or sell. |
| price | NUMBER | YES | Price per unit of the base currency. |
| stop_price | NUMBER | NO | Trigger price for stop orders. |
| volume | NUMBER | NO | Quantity of base currency to trade. |
| total | NUMBER | NO | Total value of the order (price * volume). |
| ord_type | STRING | NO | Order type (e.g., limit, market, stop_loss_limit, take_profit_limit, stop_limit). |
| type | STRING | NO | Specific category or strategy of the order. |
| confirmed | BOOLEAN | NO | Flag to confirm the order immediately. |
Request Body
{
"market": "ethusdc",
"side": "buy",
"volume": "0.0066",
"ord_type": "limit",
"price": "1500",
"enabled": null,
"confirmed": false
}
Responses
Returns an order object with details about the created order.
Response Fields:
id: Unique order identifierbid: Bid currency codeask: Ask currency codeside: Order side (buyorsell)ord_type: Order type (e.g.,limit)quote_currency: Quote currency codestop_loss_type: Stop loss type or nullstop_price: Stop price as stringstop_loss_status: Stop loss status or nullprice: Price as stringavg_price: Average executed price as stringstate: Order state (e.g.,wait,done)market: Market pair codemaker_fee: Maker fee as stringtotal_fee: Total fee as stringorigin_volume: Original order volume as stringremaining_volume: Remaining volume as stringexecuted_volume: Executed volume as stringamount_precision: Amount precision (integer)price_precision: Price precision (integer)trades_count: Number of matched trades (integer)created_at: ISO 8601 creation timestampupdated_at: ISO 8601 update timestamp
Examples
- 200 Successful response
{
"id": 23308,
"bid": "usdc",
"ask": "eth",
"side": "buy",
"ord_type": "limit",
"quote_currency": "USDC",
"stop_loss_type": "limit",
"stop_price": "0.0",
"stop_loss_status": null,
"price": "1500.0",
"avg_price": "0.0",
"state": "wait",
"market": "ethusdc",
"maker_fee": "0.0015",
"total_fee": "0.0",
"origin_volume": "0.0066",
"remaining_volume": "0.0066",
"executed_volume": "0.0",
"amount_precision": 4,
"price_precision": 2,
"trades_count": 0,
"created_at": "2026-02-25T10:12:31Z",
"updated_at": "2026-02-25T10:12:31Z"
}