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

Get Order By ID

GET api/v3/liquidity/orders/:id

Get information of specified order.

Parameters:

NameTypeMandatoryDescription
marketSTRINGYESMarket pair code (e.g., btcusdt, ethbtc)

Responses

  • 200 Successful response

Returns information for the specified order. Each order includes execution, fee and precision details.

Response Fields (for the order):

  • id: Order identifier
  • bid: Base currency (lowercase)
  • ask: Quote currency (lowercase)
  • side: buy or sell
  • ord_type: Order type. Possible values: market, limit, stop_loss_limit, take_profit_limit, stop_loss_market, take_profit_market, stop_limit.
  • quote_currency: Quote currency (uppercase)
  • stop_loss_type: Stop order type. Possible values: stop_loss_limit, take_profit_limit, stop_limit, or null if not applicable.
  • stop_price: Trigger price for stop orders
  • stop_loss_status: Status of stop order or null
  • price: Limit price (null for market orders)
  • avg_price: Average executed price
  • state: Order state. Possible values: pending, wait, done, cancel, reject, under_review, in_review.
  • market: Market code (e.g., ethusdc)
  • maker_fee: Maker fee rate applied to the order
  • total_fee: Total fee charged for the order
  • origin_volume: Original order volume
  • remaining_volume: Unfilled volume remaining
  • executed_volume: Volume already executed
  • amount_precision: Decimal precision for amount
  • price_precision: Decimal precision for price
  • trades_count: Number of trades executed for this order
  • trades: Array of trade objects (may be empty)
  • created_at: ISO timestamp when order was created
  • updated_at: ISO timestamp when order was last updated
  • ...: Other optional fields may be present
{
"id": 182,
"bid": "usdc",
"ask": "eth",
"side": "buy",
"ord_type": "market",
"quote_currency": "USDC",
"stop_loss_type": "market",
"stop_price": "0.0",
"stop_loss_status": null,
"price": null,
"avg_price": "3003.16",
"state": "done",
"market": "ethusdc",
"maker_fee": "0.0015",
"total_fee": "0.0000032775",
"origin_volume": "0.0023",
"remaining_volume": "0.0",
"executed_volume": "0.0023",
"amount_precision": 4,
"price_precision": 2,
"trades_count": 1,
"trades": [
{
"id": 62,
"price": "3003.16",
"amount": "0.0023",
"market": "ethusdc",
"quote_currency": "usdc",
"taker_type": "buy",
"side": "buy",
"ask_order": "eth",
"bid_order": "usdc",
"created_at": "2025-12-22T19:06:59Z"
}
],
"created_at": "2025-12-22T19:06:59Z",
"updated_at": "2025-12-22T19:06:59Z"
}