# Place Order

Place a new order, this endpoint is used for all supported order types

Endpoint: POST /trading/api/v3/Orders
Version: 1.5.0
Security: api-key, nonce, timestamp, version, signature

## Header parameters:

  - `customer-number` (string, required)
    Defines which customer the request is executed for. If you manage multiple customers, this is how you switch between them. Use the _Customer Management_ API endpoints to get the customer data. Example: 'BTCS-CUS-123456'

## Request fields (application/json-patch+json):

  - `symbol` (string, required)
    The instrument symbol, example: 'BTC/CHF'

  - `currency` (string, required)
    The currency to trade, example: 'BTC'

  - `transactionTime` (string, required)
    Current timestamp (UTC), if the timestamp is too old when the request reaches the server, the order is rejected

  - `orderType` (string, required)
    Enum: "Market", "Limit", "Stop", "PreviouslyQuoted"

  - `timeInForce` (string, required)
    Enum: "GoodTillCancel", "FillOrKill"

  - `fromAccount` (integer, required)
    The account id to be debited

  - `clientOrderId` (string,null)
    A custom id for this order, can be used to get or cancel the order after creation. Must be unique for each order.

  - `quoteId` (integer)
    Provide a quote id to execute a quote that was created using the quote request endpoint, required for OrderType 'PreviouslyQuoted'

  - `side` (string, required)
    The direction of the trade, related to the Symbol
    Enum: "Buy", "Sell"

  - `quantity` (number, required)
    The amount to trade in the provided Currency

  - `limitPrice` (number)
    Required for OrderType 'Limit'

  - `stopPrice` (number)
    Required for OrderType 'Stop'

  - `expireTime` (string)
    The timestamp when the order is automatically cancelled (UTC), only applicable for TimeInForce 'GoodTillCancel'

  - `toAccount` (integer)
    The account where the proceeds of the trade will be booked to, automatically determined if not provided

  - `isCommissionIncluded` (boolean)
    Set to 'true' to deduct the trading fees from the Quantity, otherwise the fees are added on top

  - `targetStrategy` (string)
    Required for OrderType 'Market' and TimeInForce 'GoodTillCancel'
    Enum: "None", "Smart"

## Response 200 fields (application/json):

  - `account` (integer)

  - `clientOrderId` (string,null)

  - `orderId` (integer)

  - `quoteId` (integer)

  - `side` (string)
    Enum: "Unknown", "Buy", "Sell"

  - `orderType` (string)
    Enum: "Unknown", "Market", "Limit", "Stop", "StopLimit", "PreviouslyQuoted", "BestExecution"

  - `symbol` (string,null)

  - `currency` (string,null)

  - `quantity` (number)

  - `price` (number)

  - `stopPrice` (number)

  - `timeInForce` (string)
    Enum: "Unknown", "GoodTillCancel", "ImmediateOrCancel", "FillOrKill", "GoodTilDate"

  - `transactionTime` (string)

  - `expireTime` (string)

  - `createdAt` (string)

  - `toAccount` (integer)

  - `executionId` (string,null)

  - `executionType` (string)
    Enum: "Unknown", "New", "Cancelled", "Replaced", "PendingCancel", "Rejected", "Expired", "Trade", "Void", "OrderStatus"

  - `indicativePrice` (number)

  - `status` (string)
    Enum: "Unknown", "New", "PartiallyFilled", "Filled", "Cancelled", "PendingCancel", "Rejected", "PendingNew", "Expired", "Draft", "Error", "Submitted", "Void", "Cancelling", "CancelError"

  - `lastPrice` (number)

  - `lastQuantity` (number)

  - `cumulativeQuantity` (number)

  - `leavesQuantity` (number)

  - `rejectionCode` (integer)

  - `text` (string,null)

  - `availableToTrade` (number)

  - `commissionCurrency` (string,null)

  - `commission` (number)

  - `settlementDate` (string)

  - `venueId` (integer)

  - `tenor` (string)
    Enum: "Unknown", "Spot", "Instantly"

  - `prosecoFuseco` (boolean)

  - `isTwap` (boolean)

  - `isCommissionIncluded` (boolean)

  - `legPrice` (number)

  - `legSymbol` (string,null)

  - `settlementAmount` (number)

  - `fromAmount` (number)

  - `toAmount` (number)

  - `isSettled` (boolean)

  - `appliedCommissionPct` (number)

  - `targetStrategy` (string)
    Enum: "None", "Smart", "TWAP", "Scheduled", "DCA"

  - `durationUnit` (string)
    Enum: "Unknown", "Day", "Hour", "Month", "Minute", "Week"

  - `duration` (integer)

  - `pegOffsetType` (string)
    Enum: "None", "BasisPoints"

  - `pegOffsetValue` (integer)

  - `effectiveTime` (string)

  - `parentClientOrderId` (integer)

  - `source` (integer)

  - `isMinimumCommissionApplied` (boolean)

  - `legs` (array, required)

  - `legs.isFiatToFiat` (boolean)

  - `legs.rate` (number)

  - `legs.baseQuantity` (number)

  - `legs.venue` (string,null)

## Response 400 fields (application/json):

  - `account` (integer)

  - `clientOrderId` (string,null)

  - `orderId` (integer)

  - `quoteId` (integer)

  - `side` (string)
    Enum: "Unknown", "Buy", "Sell"

  - `orderType` (string)
    Enum: "Unknown", "Market", "Limit", "Stop", "StopLimit", "PreviouslyQuoted", "BestExecution"

  - `symbol` (string,null)

  - `currency` (string,null)

  - `quantity` (number)

  - `price` (number)

  - `stopPrice` (number)

  - `timeInForce` (string)
    Enum: "Unknown", "GoodTillCancel", "ImmediateOrCancel", "FillOrKill", "GoodTilDate"

  - `transactionTime` (string)

  - `expireTime` (string)

  - `createdAt` (string)

  - `toAccount` (integer)

  - `executionId` (string,null)

  - `executionType` (string)
    Enum: "Unknown", "New", "Cancelled", "Replaced", "PendingCancel", "Rejected", "Expired", "Trade", "Void", "OrderStatus"

  - `indicativePrice` (number)

  - `status` (string)
    Enum: "Unknown", "New", "PartiallyFilled", "Filled", "Cancelled", "PendingCancel", "Rejected", "PendingNew", "Expired", "Draft", "Error", "Submitted", "Void", "Cancelling", "CancelError"

  - `lastPrice` (number)

  - `lastQuantity` (number)

  - `cumulativeQuantity` (number)

  - `leavesQuantity` (number)

  - `rejectionCode` (integer)

  - `text` (string,null)

  - `availableToTrade` (number)

  - `commissionCurrency` (string,null)

  - `commission` (number)

  - `settlementDate` (string)

  - `venueId` (integer)

  - `tenor` (string)
    Enum: "Unknown", "Spot", "Instantly"

  - `prosecoFuseco` (boolean)

  - `isTwap` (boolean)

  - `isCommissionIncluded` (boolean)

  - `legPrice` (number)

  - `legSymbol` (string,null)

  - `settlementAmount` (number)

  - `fromAmount` (number)

  - `toAmount` (number)

  - `isSettled` (boolean)

  - `appliedCommissionPct` (number)

  - `targetStrategy` (string)
    Enum: "None", "Smart", "TWAP", "Scheduled", "DCA"

  - `durationUnit` (string)
    Enum: "Unknown", "Day", "Hour", "Month", "Minute", "Week"

  - `duration` (integer)

  - `pegOffsetType` (string)
    Enum: "None", "BasisPoints"

  - `pegOffsetValue` (integer)

  - `effectiveTime` (string)

  - `parentClientOrderId` (integer)

  - `source` (integer)

  - `isMinimumCommissionApplied` (boolean)

  - `legs` (array, required)

  - `legs.isFiatToFiat` (boolean)

  - `legs.rate` (number)

  - `legs.baseQuantity` (number)

  - `legs.venue` (string,null)