> ## 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 algo orders (admin)

> **Limit: 5 requests per 1 second**

`GET /v1/admin/algo/orders`

Get algo order details by customized filters for admin usage.

Supports two query modes:
- **Per-user mode:** Provide either `user_account` or `user_address`. `created_time_start` and `created_time_end` are optional.
- **Broker mode:** Omit both `user_account` and `user_address`. Both `created_time_start` and `created_time_end` are required, and the time range cannot exceed 180 days.




## OpenAPI

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


        `GET /v1/admin/algo/orders`


        Get algo order details by customized filters for admin usage.


        Supports two query modes:

        - **Per-user mode:** Provide either `user_account` or `user_address`.
        `created_time_start` and `created_time_end` are optional.

        - **Broker mode:** Omit both `user_account` and `user_address`. Both
        `created_time_start` and `created_time_end` are required, and the time
        range cannot exceed 180 days.
      parameters:
        - name: symbol
          in: query
          description: ''
          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: >-
            Filter by the full stored order tag, including a current-format
            `enum:<owning_broker_id>:<enum_id>` tag.
          required: false
          example: ''
          schema:
            type: string
            maxLength: 128
        - name: created_time_start
          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: created_time_end
          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: 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: side
          in: query
          description: '`BUY`/`SELL`'
          required: false
          example: ''
          schema:
            type: string
        - name: algo_type
          in: query
          description: >-
            `STOP`/`TRAILING_STOP`/`TAKE_PROFIT`/`STOP_LOSS`/`TP_SL`/`POSITIONAL_TP_SL`/`BRACKET`
          required: false
          example: ''
          schema:
            type: string
            enum:
              - STOP
              - TRAILING_STOP
              - TAKE_PROFIT
              - STOP_LOSS
              - TP_SL
              - POSITIONAL_TP_SL
              - BRACKET
        - name: is_triggered
          in: query
          description: ''
          required: false
          example: ''
          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
            `created_time_start` and `created_time_end`.
          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
            `created_time_start` and `created_time_end`.
          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/AdminAlgoOrdersResponse'
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:
    AdminAlgoOrdersResponse:
      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:
                    type: object
                    properties:
                      algo_order_id:
                        type: number
                        example: 168400010
                      user_id:
                        type: number
                        example: 12345
                      account_id:
                        description: Account ID associated with the algo order.
                        type: string
                        example: >-
                          0x114f583aea808c5812e16109b6c087660285a26f0a31dcc0f9b54f1a6a0fefbd
                      user_address:
                        description: Wallet address associated with the algo order.
                        type: string
                        example: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619'
                      algo_status:
                        type: string
                        example: NEW
                      algo_type:
                        type: string
                        example: STOP
                      fee_asset:
                        type: string
                        example: USDC
                      is_triggered:
                        type: string
                        example: 'false'
                      order_tag:
                        type: string
                        maxLength: 128
                        example: enum:broker_b:GRID_PRO
                        description: >-
                          Full tag stored on the algo order. Current custom-fee
                          tags use `enum:<owning_broker_id>:<enum_id>`.
                          Historical orders may contain a legacy
                          `enum:<enum_id>` tag; do not rewrite it.
                      parent_algo_order_id:
                        type: number
                        example: 0
                      quantity:
                        type: number
                        example: 5.5
                      root_algo_order_id:
                        type: number
                        example: 168400010
                      root_algo_order_status:
                        type: string
                        example: NEW
                      side:
                        type: string
                        example: BUY
                      symbol:
                        type: string
                        example: PERP_NEAR_USDC
                      margin_mode:
                        type: string
                        enum:
                          - CROSS
                          - ISOLATED
                        example: CROSS
                      executed_quantity:
                        type: number
                        example: 0
                      total_executed_quantity:
                        type: number
                        example: 0
                      total_fee:
                        type: number
                        example: 0
                        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.
                      trigger_price:
                        type: number
                        example: 2.5
                      trigger_price_type:
                        type: string
                        example: MARK_PRICE
                      type:
                        type: string
                        example: MARKET
                      created_time:
                        type: number
                        example: 1702871974317
                      updated_time:
                        type: number
                        example: 1702871974317
                      visible_quantity:
                        type: number
                        example: 5.5
                      realized_pnl:
                        type: number
                        example: 0
                      child_orders:
                        type: array
                        items:
                          type: object
                        description: Array of algo orders
    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

````