---
title: "Get one order"
method: GET
path: "/v1/orders/by-id/{order_id}"
tags: ["Orders"]
---

# Get one order

`GET /v1/orders/by-id/{order_id}`

Fetch a single order by composite order ID. Faster than GET /v1/orders for one-order lookups.

## Path parameters

- `order_id` string, required

## Query parameters

- `market_id` string, int64

## Response `200`

A successful response.

- ApiGetOrderResponse
  - `order` ApiOrder
    - `id` string — The order ID.
    - `price` string — The original price (in quote unit) of the order.
    - `size` string — The original size (in base unit) of the order.
    - `market_id` string, int64 — The market ID of the order.
    - `side` 'BUY' | 'SELL'
    - `type` 'MARKET' | 'LIMIT'
    - `time_in_force` 'GTC' | 'GTT' | 'FOK' | 'IOC'
    - `expiry` string, int64 — Order expiry timestamp in nanoseconds (0 = no expiry).
    - `post_only` boolean — Post-only means the order will only be placed as a maker order.
    - `reduce_only` boolean — Indicates if the order is reduce-only.
    - `cancel_reason` string — The cancel reason (if exists).
    - `block_number` string, int64 — The block number when the order was last updated.
    - `log_index` string, int64 — The log index within the block.
    - `stp_mode` 'EXPIRE_MAKER' | 'EXPIRE_TAKER' | 'EXPIRE_BOTH'
    - `filled_size` string — The total filled size (in base unit) of the order.
    - `status` 'ORDER_STATUS_NONE' | 'ORDER_STATUS_OPEN' | 'ORDER_STATUS_FILLED' | 'ORDER_STATUS_CANCELLED'
    - `sender` string — The owner address of the order.
    - `fee_bps` string — Taker fee rate. NOTE: despite the field name, the denominator is 1,000,000 (pips), not 10,000 (bps). Actual rate = fee_bps / 1_000_000 (e.g. "300" = 0.03%). Field name kept for backward compatibility.
    - `avg_price` string — The average price (in quote unit) of the order.
    - `cancel_requested` boolean — Indicates if the order is cancel requested.
    - `created_at` string, int64 — The created at timestamp in nanosecond.
    - `tx_hash` string — The transaction hash.
    - `cancel_requested_at` string, int64 — Timestamp (in nanosecond) when order is cancel requested.
    - `cancel_tx_hash` string — The transaction hash of the cancel request.
    - `client_order_id` string — Client-provided order identifier (string-encoded uint64, empty if not set).
    - `stop_type` 'TAKE_PROFIT' | 'STOP_LOSS' | 'STOP_TYPE_NONE'
    - `stop_price` string — Stop price (empty if not a stop order).
    - `stop_price_option` 'LAST_TRADED_PRICE' | 'MARK_PRICE' | 'PRICE_OPTION_NONE'
    - `is_liquidation` boolean — Whether this order was filled as part of a liquidation (taker side only).
    - `wide_order_id` string, uint64 — Wide order ID from contract (uint64).
    - `resting_order_id` string, uint64 — Resting order ID (WideOrderId >> 1).

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/versions/194af8339c0d/schema)