Skip to main content
Version: 1.1.1
POSThttps://dev.yimmit.com/api/v3/liquidity/orders
Auth required — send X-Auth-Apikey, X-Auth-Signature and X-Auth-Nonce. How to sign a request

Create Order

POST api/v3/liquidity/orders

Create a Sell/Buy order.

Parameters

NameTypeMandatoryDescription
marketSTRINGYESMarket pair code (e.g., btcusdt, ethbtc).
sideSTRINGYESOrder side: buy or sell.
priceNUMBERYESPrice per unit of the base currency.
stop_priceNUMBERNOTrigger price for stop orders.
volumeNUMBERNOQuantity of base currency to trade.
totalNUMBERNOTotal value of the order (price * volume).
ord_typeSTRINGNOOrder type (e.g., limit, market, stop_loss_limit, take_profit_limit, stop_limit).
typeSTRINGNOSpecific category or strategy of the order.
confirmedBOOLEANNOFlag 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 identifier
  • bid: Bid currency code
  • ask: Ask currency code
  • side: Order side (buy or sell)
  • ord_type: Order type (e.g., limit)
  • quote_currency: Quote currency code
  • stop_loss_type: Stop loss type or null
  • stop_price: Stop price as string
  • stop_loss_status: Stop loss status or null
  • price: Price as string
  • avg_price: Average executed price as string
  • state: Order state (e.g., wait, done)
  • market: Market pair code
  • maker_fee: Maker fee as string
  • total_fee: Total fee as string
  • origin_volume: Original order volume as string
  • remaining_volume: Remaining volume as string
  • executed_volume: Executed volume as string
  • amount_precision: Amount precision (integer)
  • price_precision: Price precision (integer)
  • trades_count: Number of matched trades (integer)
  • created_at: ISO 8601 creation timestamp
  • updated_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"
}