> ## Documentation Index
> Fetch the complete documentation index at: https://docs.phoenix.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Get order history

> Handles `GET /v1/trader/{authority}/order-history` via `get.v1.trader.by_authority.order_history`.



## OpenAPI

````yaml /openapi/phoenix-public-api.json get /v1/trader/{authority}/order-history
openapi: 3.1.0
info:
  title: Phoenix Eternal API
  description: >-
    RESTful API for accessing Phoenix Eternal perpetual trading data. Provides
    real-time orderbook levels, asset information, and market metadata.
  termsOfService: https://www.phoenix.trade/terms-of-service
  contact:
    name: Phoenix Development Team
    url: https://github.com/Ellipsis-Labs/phoenix
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://perp-api.phoenix.trade
    description: Phoenix Eternal Perp API
security: []
tags:
  - name: Auth
    description: Wallet and session authentication.
  - name: Exchange
    description: Exchange, market, candle, and no-referral register-instruction workflows.
  - name: Invite
    description: Invite validation, referral activation, and wallet allowlist checks.
  - name: Notifications
    description: Trader notification reads and acknowledgement helpers.
  - name: Trader
    description: Trader state, account history, and transaction builders.
externalDocs:
  url: https://docs.phoenix.trade
  description: Phoenix developer documentation
paths:
  /v1/trader/{authority}/order-history:
    get:
      tags:
        - Trader
      summary: Get order history
      description: >-
        Handles `GET /v1/trader/{authority}/order-history` via
        `get.v1.trader.by_authority.order_history`.
      operationId: get.v1.trader.by_authority.order_history
      parameters:
        - name: authority
          in: path
          description: Authority pubkey
          required: true
          schema:
            type: string
        - name: traderPdaIndex
          in: query
          required: false
          schema:
            type: integer
            format: int32
            minimum: 0
        - name: marketSymbol
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: true
          schema:
            type: integer
            format: int64
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: privyId
          in: query
          required: false
          schema:
            type: string
        - name: orderStatus
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Order history
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedResponse_Vec_OrderHistoryItem'
      security:
        - PhoenixBearerAuth: []
components:
  schemas:
    PaginatedResponse_Vec_OrderHistoryItem:
      type: object
      description: >-
        Generic paginated response wrapper with bidirectional cursor support.


        The cursor system supports both forward (newer) and backward (older)

        pagination:

        - `prev_cursor`: Use this cursor to poll for new items (items newer than
        the
          current result set)
        - `next_cursor`: Use this cursor to load more items (items older than
        the
          current result set)

        The direction is embedded in the cursor itself, so clients just need to
        pass

        the appropriate cursor to the `cursor` parameter.
      required:
        - data
        - hasMore
      properties:
        data:
          type: array
          items:
            type: object
            description: Individual order in order history
            required:
              - orderSequenceNumber
              - marketSymbol
              - status
              - side
              - isReduceOnly
              - price
              - baseQty
              - remainingBaseQty
              - filledBaseQty
            properties:
              baseQty:
                type: string
                description: Base quantity (human-readable, decimal format)
              completedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                description: Timestamp when the order was completed (ISO 8601)
              filledBaseQty:
                type: string
                description: Total filled base quantity (human-readable, decimal format)
              isConditionalOrder:
                type: boolean
                description: >-
                  Indicates whether the order originated from a conditional
                  trigger
              isReduceOnly:
                type: boolean
                description: >-
                  Indicates whether the order was marked reduce-only at
                  placement time
              isStopLoss:
                type: boolean
                description: >-
                  Indicates whether the order originated from a stop loss
                  trigger
              isStopLossDirection:
                type: boolean
                description: Indicates whether the TP/SL trigger used stop-loss direction
              marketSymbol:
                type: string
                description: Market symbol (e.g., "SOL-PERP")
              orderSequenceNumber:
                type: string
                description: Order sequence number
              placedAt:
                type:
                  - string
                  - 'null'
                format: date-time
                description: Timestamp when the order was placed (ISO 8601)
              price:
                type: string
                description: Order price (human-readable, decimal format)
              remainingBaseQty:
                type: string
                description: Remaining base quantity (human-readable, decimal format)
              side:
                $ref: '#/components/schemas/Side'
                description: Order side ("buy" or "sell")
              status:
                $ref: '#/components/schemas/OrderStatus'
                description: Order status
        hasMore:
          type: boolean
          description: Whether there are more results available after this page
        nextCursor:
          type:
            - string
            - 'null'
          description: >-
            Opaque cursor for fetching the next page of older results.

            Pass this value as the `cursor` parameter in the next request to
            load

            more.
        prevCursor:
          type:
            - string
            - 'null'
          description: >-
            Opaque cursor for fetching newer items (for polling).

            Pass this value as the `cursor` parameter to get items newer than
            the

            first item in data.
    Side:
      type: string
      enum:
        - bid
        - ask
    OrderStatus:
      type: string
      enum:
        - active
        - cancelled
        - filled
  securitySchemes:
    PhoenixBearerAuth:
      type: http
      scheme: bearer
      description: Bearer access token issued by `/v1/auth/*` login endpoints.

````