# Place a Market Order

Rate Limit: 50 requests per 1 minute

Creates a new Market order, which is an instruction to trade a security immediately at the next available price. 
- To place a buy order, use a positive quantity. 
- To place a sell order, use a negative quantity.

- extendedHours: Set to true to allow the order to be filled outside of the standard trading session.
- If placed when the market is closed, the order will be queued to execute when the market next opens.

Order Limitations
* Orders can be executed only in the main account currency
* Only Market Orders are supported for the live (real money) environment

Warning: Market orders can be subject to price slippage, where the final execution price may differ from the price at the time of order placement.

Important: In this beta version, this endpoint is not idempotent. Sending the same request multiple times may result in duplicate orders.

Endpoint: POST /api/v0/equity/orders/market
Version: v0
Security: authWithSecretKey

## Request fields (application/json):

  - `extendedHours` (boolean)
    If 'true', allows the order to be filled outside of regular trading hours. If the order is placed when the market is fully closed, it will be queued for the next market open.
    Example: true

  - `quantity` (number)
    The number of shares or units to trade. Use a positive number (e.g., 10.5) for a BUY order and a negative number (e.g., -10.5) for a SELL order. The value cannot be zero.
    Example: 0.1

  - `ticker` (string)
    The unique identifier for the instrument to trade. Retrieve from the /equity/metadata/instruments endpoint.
    Example: "AAPL_US_EQ"

## Response 200 fields (application/json):

  - `creationTime` (string)
    The ISO 8601 timestamp of when the order was created.

  - `extendedHours` (boolean)
    Indicates if the order is eligible for execution outside regular trading hours.

  - `filledQuantity` (number)
    The number of shares that have been successfully executed.

  - `filledValue` (number)
    The total monetary value of the executed portion of the order.

  - `id` (integer)
    A unique, system-generated identifier for the order.

  - `limitPrice` (number)
    The limit price for LIMIT and STOP_LIMIT orders.

  - `quantity` (number)
    The number of shares requested in the order. A negative number indicates a sell order. Applicable to orders placed by quantity.

  - `status` (string)
    The current state of the order in its lifecycle.
    Enum: "LOCAL", "UNCONFIRMED", "CONFIRMED", "NEW", "CANCELLING", "CANCELLED", "PARTIALLY_FILLED", "FILLED", "REJECTED", "REPLACING", "REPLACED"

  - `stopPrice` (number)
    The stop price for STOP and STOP_LIMIT orders.

  - `strategy` (string)
    The strategy used to place the order, either by QUANTITY or VALUE. The API currently only supports placing orders by QUANTITY.
    Enum: "QUANTITY", "VALUE"

  - `ticker` (string)
    Unique instrument identifier for the traded asset.
    Example: "AAPL_US_EQ"

  - `type` (string)
    The type of the order, which determines its execution logic.
    Enum: "LIMIT", "STOP", "MARKET", "STOP_LIMIT"

  - `value` (number)
    The monetary value of the order in your account's currency. Applicable to orders placed by value. Note: Placing orders by value is not currently supported via the API but can be done through other Trading 212 platforms.

## Response 400 fields (application/json):

  - `clarification` (string)

  - `code` (string)
    Enum: "SellingEquityNotOwned", "CantLegalyTradeException", "InsufficientResources", "InsufficientValueForStocksSell", "TargetPriceTooFar", "TargetPriceTooClose", "NotEligibleForISA", "ShareLendingAgreementNotAccepted", "InstrumentNotFound", "MaxEquityBuyQuantityExceeded", "MaxEquitySellQuantityExceeded", "LimitPriceMissing", "StopPriceMissing", "TickerMissing", "QuantityMissing", "MaxQuantityExceeded", "InvalidValue", "InsufficientFreeForStocksException", "MinValueExceeded", "MinQuantityExceeded", "PriceTooFar", "UNDEFINED", "NotAvailableForRealMoneyAccounts", "ExtendedHoursTradingNotAllowed", "UnfilledOrderCountExceeded"


## Response 401 fields

## Response 403 fields

## Response 408 fields

## Response 429 fields