> ## Documentation Index > Fetch the complete documentation index at: https://orderly.network/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get orders > **Limit: 10 requests per 1 second** `GET /v1/admin/orders` Note: This endpoint requires `trading` scope in orderly key. Supports two query modes: - **Per-user mode:** Provide either `user_account` or `user_address`. `start_t` and `end_t` are optional. - **Broker mode:** Omit both `user_account` and `user_address`. Both `start_t` and `end_t` are required, and the time range cannot exceed 180 days. ## OpenAPI ````yaml orderly.openapi get /v1/admin/orders openapi: 3.0.1 info: title: EVM description: '' version: 1.0.0 servers: - url: https://api.orderly.org description: Mainnet - url: https://testnet-api.orderly.org description: Testnet security: [] tags: - name: public - name: private paths: /v1/admin/orders: get: tags: - private summary: Get orders description: > **Limit: 10 requests per 1 second** `GET /v1/admin/orders` Note: This endpoint requires `trading` scope in orderly key. Supports two query modes: - **Per-user mode:** Provide either `user_account` or `user_address`. `start_t` and `end_t` are optional. - **Broker mode:** Omit both `user_account` and `user_address`. Both `start_t` and `end_t` are required, and the time range cannot exceed 180 days. parameters: - name: symbol in: query description: >- Filter results to a specific trading symbol, for example `PERP_ETH_USDC`. required: false example: PERP_ETH_USDC schema: type: string - name: side in: query description: '`BUY`/`SELL`' required: false example: '' schema: type: string - name: order_type in: query description: '`LIMIT`/`MARKET`/`IOC`/`POST_ONLY`/`FOK`/`ASK`/`BID`' required: false example: '' schema: type: string enum: - LIMIT - MARKET - IOC - POST_ONLY - FOK - ASK - BID - name: status in: query description: >- `NEW`/`CANCELLED`/`PARTIAL_FILLED`/`FILLED`/`REJECTED`/`INCOMPLETE`/`COMPLETED` required: false example: '' schema: type: string - name: order_tag in: query description: >- Filter by the full stored order tag, including a current-format `enum::` tag. required: false example: '' schema: type: string maxLength: 128 - name: start_t in: query description: >- Start of the query range as a 13-digit Unix timestamp in milliseconds. Required in broker mode and optional in per-user mode. The broker-mode range cannot exceed 180 days. required: false example: '' schema: type: number - name: end_t in: query description: >- End of the query range as a 13-digit Unix timestamp in milliseconds. Required in broker mode and optional in per-user mode. The broker-mode range cannot exceed 180 days. required: false example: '' schema: type: number - name: update_start_t in: query description: >- Filter orders updated at or after this 13-digit Unix timestamp in milliseconds. required: false schema: type: number - name: update_end_t in: query description: >- Filter orders updated at or before this 13-digit Unix timestamp in milliseconds. required: false schema: type: number - name: source_type in: query description: 'Filter orders by source type: `ORDINARY` or `ALL`.' required: false schema: type: string enum: - ORDINARY - ALL - name: page in: query description: the page you wish to query. start from 1 required: false example: '' schema: type: number - name: size in: query description: 'the page size you wish to query (max: 500)' required: false example: '' schema: type: number - name: sort_by in: query description: > If empty: Descending order by updated_time if user passed update_start_t or update_end_t; descending order by order_id if updated_time are the same; Otherwise descending order by created_time; descending order by order_id if created_time are the same; If not empty: If sort_by == `CREATED_TIME_DESC`, descending order by created_time. Descending order by order_id if created_time are same; If sort_by == `CREATED_TIME_ASC`, ascending order by created_time. Ascending order by order_id if created_time are same; If sort_by == `UPDATED_TIME_DESC`, descending order by updated_time. Descending order by order_id if updated_time are same; If sort_by == `UPDATED_TIME_ASC`, ascending order by updated_time. Ascending order by order_id if updated_time are same; schema: type: string - name: user_account in: query description: >- Target user account for per-user mode. Provide either `user_account` or `user_address`. Omit both to use broker mode, which requires `start_t` and `end_t`. required: false example: '' schema: type: string - name: user_address in: query description: >- Target user address for per-user mode. Provide either `user_address` or `user_account`. Omit both to use broker mode, which requires `start_t` and `end_t`. required: false example: '' schema: type: string - $ref: '#/components/parameters/orderly_timestamp' - $ref: '#/components/parameters/orderly_account_id' - $ref: '#/components/parameters/orderly_key' - $ref: '#/components/parameters/orderly_signature' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/AdminOrdersResponse' components: parameters: orderly_timestamp: name: orderly-timestamp in: header description: Timestamp of the signed request in milliseconds. required: true style: simple explode: false schema: type: string example: '1649920583000' orderly_account_id: name: orderly-account-id in: header description: Account ID of the authenticated account. required: true style: simple explode: false schema: type: string example: 6.858456565150415e+75 orderly_key: name: orderly-key in: header description: Public orderly key used to sign the request. required: true style: simple explode: false schema: type: string example: ed25519:8tm7dnKYkSc3FzgPuJaw1wztr79eeZpN35nHW5pL5XhX orderly_signature: name: orderly-signature in: header description: Signature of the request payload generated with the orderly key. required: true style: simple explode: false schema: type: string example: >- dG4bkKiqG0dUYLzViRZkvbI6Sy239JxAdNMIBxFZ4w030Jofr0ORV06GHtvXZkaZaWUXE+XAU3fnzKN/5fDeBQ== schemas: AdminOrdersResponse: allOf: - $ref: '#/components/schemas/BasicResponse' - type: object required: - data properties: data: type: object required: - meta - rows properties: meta: $ref: '#/components/schemas/PaginationMeta' rows: type: array items: $ref: '#/components/schemas/AdminOrder' BasicResponse: required: - success type: object properties: success: description: Indicates whether the request was successful. type: boolean example: true timestamp: description: Server timestamp in milliseconds. type: integer example: 1702989203989 PaginationMeta: required: - current_page - records_per_page - total type: object properties: total: type: integer example: 9 records_per_page: type: integer example: 25 current_page: type: integer example: 1 description: start from 1 AdminOrder: allOf: - $ref: '#/components/schemas/Order' - type: object properties: account_id: description: Account ID associated with the order. type: string example: >- 0x114f583aea808c5812e16109b6c087660285a26f0a31dcc0f9b54f1a6a0fefbd user_address: description: Wallet address associated with the order. type: string example: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619' Order: type: object required: - amount - average_executed_price - client_order_id - created_time - total_executed_quantity - fee_asset - order_id - price - quantity - side - status - symbol - total_fee - type - updated_time - user_id - visible_quantity - realized_pnl properties: order_id: type: number example: 78151 user_id: type: number example: 12345 price: type: number example: 0.67772 type: type: string example: LIMIT quantity: type: number example: 20 amount: type: number example: 10 nullable: true executed_quantity: type: number example: 20 total_executed_quantity: type: number example: 20 visible_quantity: type: number example: 1 visible: type: number example: 1 symbol: type: string example: PERP_WOO_USDC side: type: string example: BUY status: type: string example: FILLED description: NEW / FILLED / PARTIAL_FILLED / CANCELLED total_fee: type: number example: 0.5 description: >- Aggregate fee across executed trades, including any custom trading fees. Use trade-level fields for reconciliation; this value is not a builder or affiliate payout basis. fee_asset: type: string example: WOO client_order_id: type: number example: 1 nullable: true average_executed_price: type: number example: 0.67772 created_time: type: number example: 1653563963000 updated_time: type: number example: 1653564213000 realized_pnl: type: number example: 0 executed: type: number example: 20 reduce_only: type: boolean nullable: true example: null order_tag: type: string maxLength: 128 nullable: true example: enum:broker_b:GRID_PRO description: > Full tag stored on the order. Current custom-fee tags use `enum::`. Historical orders may contain a legacy `enum:` tag; do not rewrite it. margin_mode: type: string example: CROSS ````