> ## Documentation Index > Fetch the complete documentation index at: https://docs.centosfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List Orders > List orders with optional filters. Returns a paginated list of orders across all accessible subaccounts, ordered by `created_at` descending. **Filters:** All filters are optional and can be combined. If no `subaccount_id` is specified, returns orders from all subaccounts the user has access to. **Order Statuses:** - `PENDING_SUBMISSION`: Order received, awaiting exchange submission. - `PROCESSING`: Being processed by the order consumer. - `RESTING`: Live on the exchange order book. - `PARTIALLY_FILLED`: Some quantity executed, remainder resting. - `EXECUTED`: Fully filled. - `CANCELLED`: Cancelled by user or system. - `REJECTED`: Rejected by exchange (see order details for reason). - `EXPIRED`: GTD order past expiry time. **Aggregated Fields:** Each order includes `traded_qty`, `average_price`, and `fees_paid` computed from fills. ## OpenAPI ````yaml /openapi.json get /v1/orders openapi: 3.1.0 info: title: Centos Finance API contact: name: Centos Finance url: https://centosfi.com/ license: name: Proprietary version: 1.0.0 servers: - url: https://api.centosfi.com security: [] tags: - name: markets description: Search and discover prediction markets across Kalshi and Polymarket. - name: subaccounts description: >- Manage trading subaccounts. Each subaccount can have its own exchange credentials and positions. - name: positions description: View current portfolio positions across all connected exchanges. - name: fills description: Retrieve trade execution history and fill details. - name: prices description: Get historical price data and candlesticks from exchanges. - name: orders description: Place and manage orders on prediction market exchanges. - name: complex-orders description: >- Manage complex orders: conditional orders (take-profit and stop-loss), TWAP, and other advanced order types. paths: /v1/orders: get: tags: - orders summary: List Orders description: >- List orders with optional filters. Returns a paginated list of orders across all accessible subaccounts, ordered by `created_at` descending. **Filters:** All filters are optional and can be combined. If no `subaccount_id` is specified, returns orders from all subaccounts the user has access to. **Order Statuses:** - `PENDING_SUBMISSION`: Order received, awaiting exchange submission. - `PROCESSING`: Being processed by the order consumer. - `RESTING`: Live on the exchange order book. - `PARTIALLY_FILLED`: Some quantity executed, remainder resting. - `EXECUTED`: Fully filled. - `CANCELLED`: Cancelled by user or system. - `REJECTED`: Rejected by exchange (see order details for reason). - `EXPIRED`: GTD order past expiry time. **Aggregated Fields:** Each order includes `traded_qty`, `average_price`, and `fees_paid` computed from fills. operationId: list_orders_v1_orders_get parameters: - name: status in: query required: false schema: anyOf: - type: string enum: - PENDING_SUBMISSION - RESTING - EXECUTED - CANCELLED - REJECTED - EXPIRED - PARTIALLY_FILLED - PROCESSING - type: 'null' description: Filter by order status title: Status description: Filter by order status - name: centos_id in: query required: false schema: anyOf: - type: integer - type: 'null' description: Filter by instrument ID title: Centos Id description: Filter by instrument ID - name: custom_asset_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter by custom asset ID title: Custom Asset Id description: Filter by custom asset ID - name: subaccount_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter to a specific subaccount title: Subaccount Id description: Filter to a specific subaccount - name: buy_flag in: query required: false schema: anyOf: - type: boolean - type: 'null' description: 'Filter by direction: true=buys, false=sells' title: Buy Flag description: 'Filter by direction: true=buys, false=sells' - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: Results per page (max 1000) default: 100 title: Limit description: Results per page (max 1000) - name: offset in: query required: false schema: type: integer minimum: 0 description: Pagination offset default: 0 title: Offset description: Pagination offset responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/OrderListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: OrderListResponse: properties: orders: items: $ref: '#/components/schemas/OrderResponse' type: array title: Orders description: List of orders matching the query count: type: integer title: Count description: Total count of matching orders (for pagination) type: object required: - orders - count title: OrderListResponse description: Schema for list of orders. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError OrderResponse: properties: centos_order_id: type: string format: uuid title: Centos Order Id description: Unique order identifier order_type: type: string title: Order Type description: 'Order type: LIMIT or MARKET' time_in_force: type: string title: Time In Force description: 'Time in force: FOK, GTC, GTD, or IOC' qty: type: number title: Qty description: Original order quantity price: anyOf: - type: number - type: 'null' title: Price description: Limit price (null for market orders) buy_flag: type: boolean title: Buy Flag description: 'Order direction: true=buy, false=sell' status: type: string title: Status description: >- Order status: PENDING_SUBMISSION, PROCESSING, RESTING, PARTIALLY_FILLED, EXECUTED, CANCELLED, REJECTED, or EXPIRED centos_id: anyOf: - type: integer - type: 'null' title: Centos Id description: Instrument ID custom_asset_id: anyOf: - type: string format: uuid - type: 'null' title: Custom Asset Id description: Custom asset basket UUID subaccount_id: type: string format: uuid title: Subaccount Id description: Subaccount the order belongs to expiry_ts_utc: anyOf: - type: string format: date-time - type: 'null' title: Expiry Ts Utc description: Expiry timestamp in UTC for GTD orders created_at: type: string format: date-time title: Created At description: Order creation timestamp (UTC) updated_at: type: string format: date-time title: Updated At description: Last update timestamp (UTC) traded_qty: type: number title: Traded Qty description: Total quantity filled default: 0 average_price: anyOf: - type: number - type: 'null' title: Average Price description: Volume-weighted average fill price fees_paid: type: number title: Fees Paid description: Total fees paid across all fills default: 0 complex_order_ids: additionalProperties: items: type: string format: uuid type: array type: object title: Complex Order Ids description: List of complex centos orders id reject_reason: anyOf: - type: string - type: 'null' title: Reject Reason description: Reason for rejection (if status is REJECTED) type: object required: - centos_order_id - order_type - time_in_force - qty - buy_flag - status - subaccount_id - created_at - updated_at - complex_order_ids title: OrderResponse description: Schema for order response, when user request information about an order. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````