> ## Documentation Index
> Fetch the complete documentation index at: https://readme.amana-dev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Place a pending limit order that triggers at a specified price

> Creates a pending order that only executes when the market reaches the specified price. Use this when the user wants to enter at a specific price rather than immediately. Amount is always in USD. The order stays pending until triggered or cancelled with cancelOrder.



## OpenAPI

````yaml /openapi-readme.json post /trading/positions/limit
openapi: 3.1.0
info:
  title: Amana API
  version: 1.0.0
  description: API documentation for Amana platform
servers:
  - url: https://gateway.amana.io
    description: Amana app
security: []
tags:
  - name: onboarding
    description: Endpoints related to user onboarding, KYC processes, and account setup.
  - name: auth
    description: Endpoints for user authentication, token management, and session handling.
  - name: trading
    description: >-
      Endpoints related to trading operations, account management, and market
      data retrieval.
  - name: charting
    description: >-
      Endpoints for retrieving historical price data, technical indicators, and
      other charting-related information.
  - name: uaepass
    description: Endpoints for UAE Pass authentication and identity verification.
  - name: alerts
  - name: cms
  - name: dw
  - name: events
  - name: geo-location
  - name: high-leverage
  - name: kyc
  - name: mt
  - name: nafath
  - name: payments
  - name: promo-codes
  - name: smart-money
  - name: support
  - name: symbols
  - name: trading-accounts
  - name: transactions
  - name: user
  - name: watchlists
paths:
  /trading/positions/limit:
    post:
      tags:
        - trading
      summary: Place a pending limit order that triggers at a specified price
      description: >-
        Creates a pending order that only executes when the market reaches the
        specified price. Use this when the user wants to enter at a specific
        price rather than immediately. Amount is always in USD. The order stays
        pending until triggered or cancelled with cancelOrder.
      operationId: openLimitOrder
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                symbol:
                  type: string
                  description: Trading symbol, for example XAUUSD, EURUSD, or AAPL.
                side:
                  type: string
                  enum:
                    - buy
                    - sell
                  description: Trade direction. Use 'buy' to go long, 'sell' to go short.
                amount:
                  type: number
                  minimum: 0
                  description: >-
                    Trade size in account currency (USD). For example, 1000
                    means $1,000 worth of the instrument.
                price:
                  type: number
                  minimum: 0
                  description: >-
                    Price at which the order should trigger. The order stays
                    pending until the market reaches this level.
                sl:
                  type: number
                  minimum: 0
                  description: >-
                    Optional stop loss price level. The position closes
                    automatically if the market hits this price.
                tp:
                  type: number
                  minimum: 0
                  description: >-
                    Optional take profit price level. The position closes
                    automatically in profit if the market hits this price.
                comment:
                  type: string
                  description: Optional comment or note for the order.
              required:
                - symbol
                - side
                - amount
                - price
              additionalProperties: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  orderId:
                    type: string
                  err:
                    type: string
                  message:
                    type: string
                required:
                  - success
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  orderId:
                    type: string
                  err:
                    type: string
                  message:
                    type: string
                required:
                  - success
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token obtained from authentication endpoints

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.