v1

latestOpenAPI 3.1.0UNLICENSED2026-07-26216788.0 KB

Orders

GetOrder

Returns the current stored state of one order, identified by the composite key order_id + market + reduce_only. Order IDs are not globally unique: the same numeric ID can exist as both a position-opening order and a reduce-only order in the same market, so reduce_only must match the kind of order you're looking up.

post/order_service.v1.OrderService/GetOrder

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol. If omitted, use 1.

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

orderIdstring int64 required

On-chain order identifier to look up. Required; must be combined with market and reduce_only to uniquely identify the order.

reduceOnlyboolean

Whether to look up a reduce-only order (true) or a position-opening order (false) for this order_id. Defaults to false when omitted.

Response

Success

Example response

{
  "order": {
    "timestamp": "2023-01-15T01:30:15.01Z"
  }
}