# Get orders

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/account/orders:
    get:
      summary: Get orders
      deprecated: false
      description: >-
        Returns the authenticated account's orders, filtered by the provided
        query parameters.
      operationId: getOrders
      tags:
        - API/Trading/Orders
        - Orders
      parameters:
        - name: status
          in: query
          description: >-
            Filter by status. Use aggregate values 'open'/'closed', or
            individual status values. Aggregate and individual values cannot be
            combined.
          required: false
          example: filled
          schema:
            type: array
            description: >-
              Filter by status. Use aggregate values 'open'/'closed', or
              individual status values. Aggregate and individual values cannot
              be combined.
            items:
              type: string
              description: >-
                Filter by status. Use aggregate values 'open'/'closed', or
                individual status values. Aggregate and individual values cannot
                be combined.
              enum:
                - open
                - closed
                - new
                - partially-filled
                - filled
                - canceled
                - filled-and-canceled
                - done-for-day
                - rejected
              examples:
                - filled
            enum:
              - open
              - closed
              - new
              - partially-filled
              - filled
              - canceled
              - filled-and-canceled
              - done-for-day
              - rejected
            examples:
              - filled
        - name: pair
          in: query
          description: Filter by pair, comma-separated.
          required: false
          example: BTC-EUR,ETH-USD
          schema:
            type: array
            description: Filter by pair, comma-separated.
            items:
              type: string
              description: Filter by pair, comma-separated.
              examples:
                - BTC-EUR,ETH-USD
            examples:
              - BTC-EUR,ETH-USD
        - name: startTime
          in: query
          description: Start of the time range as a unix timestamp in seconds
          required: false
          example: 1725926400
          schema:
            type: integer
            description: Start of the time range as a unix timestamp in seconds
            format: int64
            examples:
              - 1725926400
        - name: endTime
          in: query
          description: End of the time range as a unix timestamp in seconds
          required: false
          example: 1726012800
          schema:
            type: integer
            description: End of the time range as a unix timestamp in seconds
            format: int64
            examples:
              - 1726012800
        - name: limit
          in: query
          description: The maximum number of orders to return. Defaults to 100, max 1000.
          required: false
          example: 100
          schema:
            maximum: 1000
            type: integer
            description: The maximum number of orders to return. Defaults to 100, max 1000.
            format: int32
            default: 100
            examples:
              - 100
        - name: cursor
          in: query
          description: Cursor for pagination from the previous response
          required: false
          example: ''
          schema:
            type: string
            description: Cursor for pagination from the previous response
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique order identifier (UUID)
                          examples:
                            - a3bb189e-8bf9-3888-9912-ace4e6543002
                        pair:
                          type: string
                          description: Trading pair identifier
                          examples:
                            - BTC-EUR
                        side:
                          type: string
                          description: Order side
                          enum:
                            - Buy
                            - Sell
                          examples:
                            - Buy
                        type:
                          type: string
                          description: Order type
                          enum:
                            - Limit
                            - Market
                            - StopLimit
                            - StopMarket
                          examples:
                            - Limit
                        status:
                          type: string
                          description: Current order status
                          enum:
                            - new
                            - filled
                            - filled-and-canceled
                            - partially-filled
                            - canceled
                            - done-for-day
                            - rejected
                          examples:
                            - new
                        pricedIn:
                          type: string
                          description: Currency used to express the order quantity
                          examples:
                            - BTC
                        quantity:
                          type: string
                          description: >-
                            Order quantity in base currency; null if price is
                            unavailable
                          examples:
                            - '0.5'
                          nullable: true
                        amount:
                          type: string
                          description: >-
                            Order amount in quote currency; null if price is
                            unavailable
                          examples:
                            - '15000.0'
                          nullable: true
                        limitPrice:
                          type: string
                          description: >-
                            Limit price; only present for Limit and StopLimit
                            orders
                          examples:
                            - '30000.0'
                          nullable: true
                        triggerPrice:
                          type: string
                          description: >-
                            Trigger price; only present for StopLimit and
                            StopMarket orders
                          examples:
                            - '29500.0'
                          nullable: true
                        filledQuantity:
                          type: string
                          description: >-
                            Filled quantity in base currency; null until at
                            least one fill occurs
                          examples:
                            - '0.25'
                          nullable: true
                        filledAmount:
                          type: string
                          description: >-
                            Filled amount in quote currency; null until at least
                            one fill occurs
                          examples:
                            - '7500.0'
                          nullable: true
                        filledPercentage:
                          type: string
                          description: Percentage of the order that has been filled (0–100)
                          examples:
                            - '50.0'
                        filledAveragePrice:
                          type: string
                          description: >-
                            Average fill price; null until at least one fill
                            occurs
                          examples:
                            - '30000.0'
                          nullable: true
                        fee:
                          type: object
                          properties:
                            amount:
                              type: string
                              description: Fee amount as a decimal string
                              examples:
                                - '0.45'
                            currency:
                              type: string
                              description: Fee currency code
                              examples:
                                - EUR
                          description: >-
                            Fee charged on the order; null until the order
                            generates a fee
                          x-apidog-orders:
                            - amount
                            - currency
                          nullable: true
                        timeInForce:
                          type: string
                          description: Time-in-force policy
                          enum:
                            - GTC
                            - GTD
                            - IOC
                            - FOK
                          examples:
                            - GTC
                        updatedAt:
                          type: string
                          description: ISO 8601 timestamp of the last update (UTC)
                          examples:
                            - '2024-06-15T10:30:00.000Z'
                        createdAt:
                          type: string
                          description: >-
                            ISO 8601 timestamp when the order was submitted
                            (UTC)
                          examples:
                            - '2024-06-15T10:29:55.000Z'
                        executedAt:
                          type: string
                          description: >-
                            ISO 8601 timestamp when the order was executed; null
                            for open/pending orders
                          examples:
                            - '2024-06-15T10:30:01.000Z'
                          nullable: true
                        endTime:
                          type: string
                          description: >-
                            Expiry time for GTD orders; null for all other
                            time-in-force types
                          examples:
                            - '2024-06-16T00:00:00.000Z'
                          nullable: true
                      x-apidog-orders:
                        - id
                        - pair
                        - side
                        - type
                        - status
                        - pricedIn
                        - quantity
                        - amount
                        - limitPrice
                        - triggerPrice
                        - filledQuantity
                        - filledAmount
                        - filledPercentage
                        - filledAveragePrice
                        - fee
                        - timeInForce
                        - updatedAt
                        - createdAt
                        - executedAt
                        - endTime
                  meta:
                    type: object
                    properties:
                      limit:
                        type: integer
                        description: Maximum number of orders returned in this page
                        format: int32
                        examples:
                          - 100
                      hasNextPage:
                        type: boolean
                        description: >-
                          Whether there are more orders available beyond this
                          page
                        examples:
                          - true
                      nextCursor:
                        type: string
                        description: >-
                          Cursor for fetching the next page; null when
                          hasNextPage is false
                        nullable: true
                    x-apidog-orders:
                      - limit
                      - hasNextPage
                      - nextCursor
                x-apidog-orders:
                  - data
                  - meta
          headers: {}
          x-apidog-name: ''
        '400':
          description: Invalid query parameter or missing required header
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Machine-readable error code
                          examples:
                            - VALIDATION_ERROR
                        status:
                          type: integer
                          description: HTTP status code
                          format: int32
                          examples:
                            - 400
                        field:
                          type: string
                          description: >-
                            Field that caused the error; null for non-validation
                            errors
                          examples:
                            - limit
                          nullable: true
                        title:
                          type: string
                          description: Human-readable error message
                          examples:
                            - Invalid value for parameter 'limit'
                      x-apidog-orders:
                        - code
                        - status
                        - field
                        - title
                x-apidog-orders:
                  - errors
          headers: {}
          x-apidog-name: ''
        '404':
          description: Invalid cursor value
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Machine-readable error code
                          examples:
                            - VALIDATION_ERROR
                        status:
                          type: integer
                          description: HTTP status code
                          format: int32
                          examples:
                            - 400
                        field:
                          type: string
                          description: >-
                            Field that caused the error; null for non-validation
                            errors
                          examples:
                            - limit
                          nullable: true
                        title:
                          type: string
                          description: Human-readable error message
                          examples:
                            - Invalid value for parameter 'limit'
                      x-apidog-orders:
                        - code
                        - status
                        - field
                        - title
                x-apidog-orders:
                  - errors
          headers: {}
          x-apidog-name: ''
        '500':
          description: Unexpected server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                          description: Machine-readable error code
                          examples:
                            - VALIDATION_ERROR
                        status:
                          type: integer
                          description: HTTP status code
                          format: int32
                          examples:
                            - 400
                        field:
                          type: string
                          description: >-
                            Field that caused the error; null for non-validation
                            errors
                          examples:
                            - limit
                          nullable: true
                        title:
                          type: string
                          description: Human-readable error message
                          examples:
                            - Invalid value for parameter 'limit'
                      x-apidog-orders:
                        - code
                        - status
                        - field
                        - title
                x-apidog-orders:
                  - errors
          headers: {}
          x-apidog-name: ''
      security:
        - ApiKeyAuth: []
          x-apidog:
            schemeGroups:
              - id: LXHxeCZ9gkDCv5nkFNsBc
                schemeIds:
                  - ApiKeyAuth
            required: true
            use:
              id: LXHxeCZ9gkDCv5nkFNsBc
            scopes:
              LXHxeCZ9gkDCv5nkFNsBc:
                ApiKeyAuth: []
      x-apidog-folder: API/Trading/Orders
      x-apidog-status: released
      x-run-in-apidog: https://app.eu.apidog.com/web/project/363759/apis/api-4203921-run
components:
  schemas: {}
  securitySchemes:
    ApiKeyAuth:
      type: apikey
      description: API key for authentication. Issued by Bitpanda.
      name: x-api-key
      in: header
servers:
  - url: https://api.fusion.bitpanda.com
    description: Production
security: []

```