# Create order

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/account/orders:
    post:
      summary: Create order
      deprecated: false
      description: >-
        Submits a new order for execution. The order is processed asynchronously
        and the response returns the created order's identifier.
      operationId: postOrder
      tags:
        - API/Trading/Orders
        - Orders
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pair:
                  minLength: 1
                  pattern: ^[A-Za-z0-9]{1,10}-[A-Za-z0-9]{1,10}$
                  type: string
                  description: Trading pair identifier
                  examples:
                    - BTC-EUR
                side:
                  minLength: 1
                  type: string
                  description: The side of the order
                  enum:
                    - Buy
                    - Sell
                  examples:
                    - Buy
                type:
                  minLength: 1
                  type: string
                  description: The type of order
                  enum:
                    - Limit
                    - Market
                    - StopLimit
                    - StopMarket
                  examples:
                    - Limit
                quantity:
                  type: number
                  description: >-
                    Order size expressed in assets (e.g. `0.001` for a BTC-EUR
                    pair means 0.001 BTC). Use this field when you want to
                    specify how much of the asset to buy or sell. Exactly one of
                    `quantity` or `amount` must be provided.
                  examples:
                    - 0.1
                amount:
                  type: number
                  description: >-
                    Order size expressed in the quote currency (e.g. `100` for a
                    BTC-EUR pair means 100 EUR). Use this field when you want to
                    spend or receive a fixed amount in the quote currency.
                    Exactly one of `quantity` or `amount` must be provided.
                  examples:
                    - 100
                limitPrice:
                  type: number
                  description: >-
                    The limit price. Must be a positive number. Decimals are
                    allowed. Required if type is 'Limit' or 'StopLimit'
                  examples:
                    - 61250.55
                triggerPrice:
                  type: number
                  description: >-
                    The trigger limit price. Must be a positive number. Decimals
                    are allowed. Required if type is 'StopLimit' or 'StopMarket'
                  examples:
                    - 61250.55
                timeInForce:
                  type: string
                  description: >-
                    How long the order remains in effect. Defaults to GTC for
                    Limit/StopLimit, IOC for Market, FOK for StopMarket
                  enum:
                    - GTC
                    - GTD
                    - IOC
                    - FOK
                  examples:
                    - GTC
                endTime:
                  type: string
                  description: End date time. Required if timeinforce is 'GTD'
                  examples:
                    - '2025-09-30T15:42:10.123Z'
              x-apidog-orders:
                - pair
                - side
                - type
                - quantity
                - amount
                - limitPrice
                - triggerPrice
                - timeInForce
                - endTime
      responses:
        '202':
          description: Order accepted
          content:
            application/json:
              schema:
                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
          headers: {}
          x-apidog-name: ''
        '400':
          description: Invalid request body 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: Trading market not found
          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
              example:
                errors:
                  - code: SYMBOL_NOT_FOUND
                    status: 404
                    field: null
                    title: Trading market not found
          headers: {}
          x-apidog-name: ''
        '422':
          description: >-
            Order rejected by the exchange or invalid currency for the selected
            pair
          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
              example:
                errors:
                  - code: ORDER_CREATION_ERROR
                    status: 422
                    field: null
                    title: Order was rejected
          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: QkpYfbNpX7M4WqpddlJlq
                schemeIds:
                  - ApiKeyAuth
            required: true
            use:
              id: QkpYfbNpX7M4WqpddlJlq
            scopes:
              QkpYfbNpX7M4WqpddlJlq:
                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-4204526-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: []

```