# List user orders

Returns a paginated list of completed and failed orders with execution data for the authenticated user

Endpoint: GET /orders
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `limit` (integer)
    Maximum number of orders to return

  - `cursor` (string)
    RFC3339 timestamp cursor for pagination

  - `status` (string)
    Comma-separated list of order statuses to filter by
    Example: "pending,canceled"

## Response 200 fields (application/json):

  - `data` (array)
    List of orders

  - `data.order_id` (string)
    Unique order identifier

  - `data.base_asset` (string)
    Base asset identifier (e.g. , , )

  - `data.quote_asset` (string)
    Quote asset identifier (e.g. , )

  - `data.type` (string)
    The type of order to place.
*  — Execute immediately at the best available price. Buy orders require . Price must not be specified.
*  — Place an order at a specific price. Requires  and . Only supported on CeFi;  must not be specified.
    Enum: "market", "limit"

  - `data.side` (string)
    The side of the order.
*  — Purchase the base asset using the quote asset.
*  — Sell the base asset in exchange for the quote asset.
    Enum: "buy", "sell"

  - `data.price` (string)
    For limit orders, the limit price submitted. For market orders, the reference price at order creation.

  - `data.qty` (string)
    Original order quantity in the denomination specified by  at creation

  - `data.executed_qty` (string)
    Quantity of the base asset that has been filled so far

  - `data.leaves_qty` (string)
    Remaining base asset quantity yet to be filled. Zero when the order is complete.

  - `data.executed_vwap` (string)
    Volume-weighted average price across all fills for this order

  - `data.status` (string)
    The current status of the order.
*  — Order has been created but not yet submitted. For DeFi orders, the client must sign the returned payloads and call the execute endpoint. For CeFi buy orders with insufficient balance, a funding bridge is prepared first.
*  — Order has been submitted but is not yet confirmed by the CeFi exchange or on-chain.
*  — Order was accepted by the CeFi exchange and is open for trading. Applies to limit orders that are working in the order book.
*  — A cancellation request has been sent to the CeFi exchange and is awaiting confirmation.
*  — Order has been fully executed. For CeFi orders this means the CeFi exchange reported a fill; for DeFi orders the on-chain swap was confirmed.
*  — Order was successfully canceled via a cancel request or by exchange/market conditions.
*  — Order was rejected by the CeFi exchange or DeFi execution failed (e.g. on-chain transaction reverted, balance check failed).
    Enum: "initialized", "pending", "cancel_pending", "complete", "canceled", "active", "failed"

  - `data.created_at` (string)
    Timestamp when the order was created (RFC 3339)

  - `pagination` (object)
    Cursor-based pagination metadata

  - `pagination.next_cursor` (any)
    RFC3339 timestamp cursor for next page, null if no more data

  - `pagination.limit` (integer)
    Number of items per page

## Response 400 fields (application/json):

  - `message` (string)
    Error message

## Response 401 fields (application/json):

  - `message` (string)
    Error message

## Response 500 fields (application/json):

  - `message` (string)
    Error message