> ## Documentation Index > Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt > Use this file to discover all available pages before exploring further. # Create an order > This endpoint allows traders to place an order. Leverage, stop-loss, and take-profit settings can be applied. Order size must use exactly one of amount, units, or contracts. A unique X-Request-Id header (GUID) is required for idempotency. Currently only orders to open a position are supported. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v2/trading/execution/orders openapi: 3.0.1 info: title: eToro Api version: v1.206.0 description: >- eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications. For more details on integrating with eToro's public WebSocket service, please refer to the dedicated [WebSocket documentation](./websocket/websocket-doc.html). servers: - url: https://public-api.etoro.com description: eToro Public API security: [] tags: - name: Agent Portfolios - name: Watchlists - name: Feeds - name: Asset Explorer - name: Market Data - name: Identity - name: Notifications - name: PI Data - name: Comments - name: Trading Demo - name: Trading Real - name: Users Info - name: Deprecated paths: /api/v2/trading/execution/orders: post: tags: - Trading Real summary: Create an order description: >- This endpoint allows traders to place an order. Leverage, stop-loss, and take-profit settings can be applied. Order size must use exactly one of amount, units, or contracts. A unique X-Request-Id header (GUID) is required for idempotency. Currently only orders to open a position are supported. operationId: createRealOrder parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 736ca1b7-06ce-4448-b1a5-2c0a0466d1a5 description: A unique request identifier. - name: x-api-key in: header required: true schema: type: string format: password example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663 description: API key for authentication. - name: x-user-key in: header required: true schema: type: string format: password example: >- eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_ description: User-specific authentication key. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UnifiedOrderRequestForRealCreateOrderDocs' example: action: open transaction: buy symbol: AAPL instrumentId: 101 orderType: mkt triggerRate: null leverage: 2 amount: 1000 orderCurrency: usd units: null contracts: null stopLossRate: 1.2 takeProfitRate: 1.5 stopLossType: fixed additionalMargin: null positionIds: null responses: '200': description: Order submitted successfully. Returns the created order details. content: application/json: schema: $ref: '#/components/schemas/UnifiedOrderResponse' example: token: 066faaee-e1e9-49d2-a568-c6e1cc336ad8 orderId: 13902598 referenceId: 1c94300c-90aa-4303-9d00-dec376d74efb '400': description: Invalid request. Validation failed. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Unauthorized. Invalid or missing authentication. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: Internal server error. security: - bearerAuth: [] components: schemas: UnifiedOrderRequestForRealCreateOrderDocs: type: object description: Request payload for creating an order to open or close a position. required: - action - transaction properties: action: type: string description: 'The order action type. Possible values: open, close.' enum: - open - close example: open transaction: type: string description: >- The transaction direction. Possible values: buy, sell, sellShort, buyToCover. enum: - buy - sell - sellShort - buyToCover example: buy symbol: type: string description: The asset ticker symbol. Required for open orders. nullable: true example: AAPL instrumentId: type: integer format: int32 description: The eToro instrument identifier. Required for open orders. nullable: true example: 101 orderType: type: string description: >- The order execution type. Possible values: mkt (market), mit (market if touched). enum: - mkt - mit example: mkt triggerRate: type: number format: double nullable: true description: The trigger rate for mit orders. Required for mit orders. leverage: type: integer format: int32 description: The leverage multiplier to apply. Required for open orders. nullable: true example: 2 amount: type: number format: double nullable: true description: >- The monetary amount to invest in the order currency. Mutually exclusive with units and contracts. example: 1000 orderCurrency: type: string description: The currency for the order amount. Typically usd. nullable: true example: usd units: type: number format: double nullable: true description: >- The number of units to trade. Mutually exclusive with amount and contracts. contracts: type: number format: double nullable: true description: >- The number of contracts to trade. Mutually exclusive with amount and units. stopLossRate: type: number format: double nullable: true description: The stop-loss rate at which the position will automatically close. example: 1.2 takeProfitRate: type: number format: double nullable: true description: The take-profit rate at which the position will automatically close. example: 1.5 stopLossType: type: string nullable: true description: 'The stop-loss type. Possible values: fixed, trailing.' enum: - fixed - trailing example: fixed additionalMargin: type: number format: double nullable: true description: Additional margin to allocate to the position. positionIds: type: array items: type: integer format: int64 nullable: true description: List of position IDs to close. Required for close orders. UnifiedOrderResponse: type: object description: Response payload after successfully submitting an order. properties: token: type: string format: uuid description: >- A tracking token for the order request, used for correlation and debugging. example: 066faaee-e1e9-49d2-a568-c6e1cc336ad8 orderId: type: integer format: int64 description: The unique identifier of the created order. example: 13902598 referenceId: type: string format: uuid description: >- The client reference identifier for the order, matching the X-Request-Id header if provided. example: 1c94300c-90aa-4303-9d00-dec376d74efb ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} ````