> ## 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/orders`

Get orders by customized filters.

For filter by status, one can reference special bundled statuses below for ease of access of Open (ie `INCOMPLETE`) orders or `COMPLETED` orders.

- `INCOMPLETE` = `NEW` + `PARTIAL_FILLED`
- `COMPLETED` = `CANCELLED` + `FILLED`




## OpenAPI

````yaml orderly.openapi get /v1/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/orders:
    get:
      tags:
        - private
      summary: Get orders
      description: >
        **Limit: 10 requests per 1 second**


        `GET /v1/orders`


        Get orders by customized filters.


        For filter by status, one can reference special bundled statuses below
        for ease of access of Open (ie `INCOMPLETE`) orders or `COMPLETED`
        orders.


        - `INCOMPLETE` = `NEW` + `PARTIAL_FILLED`

        - `COMPLETED` = `CANCELLED` + `FILLED`
      parameters:
        - name: symbol
          in: query
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: side
          in: query
          description: '`BUY`/`SELL`'
          required: false
          example: ''
          schema:
            type: string
        - name: order_type
          in: query
          description: '`LIMIT`/`MARKET`'
          required: false
          example: ''
          schema:
            type: string
        - 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: ''
          required: false
          example: ''
          schema:
            type: string
        - name: start_t
          in: query
          description: >-
            start time range that wish to query, noted the time stamp is
            13-digits timestamp.
          required: false
          example: ''
          schema:
            type: number
        - name: end_t
          in: query
          description: >-
            end time range that wish to query, noted the time stamp is 13-digits
            timestamp.
          required: false
          example: ''
          schema:
            type: number
        - 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
        - $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/OrdersResponse'
      deprecated: false
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:
    OrdersResponse:
      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/Order'
    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
    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
        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
          nullable: true
          example: null
          description: >
            Optional tag for the order. Supports plain string (referral code) or
            `enum:<enum_id>` format.
        margin_mode:
          type: string
          example: CROSS

````