Skip to Content
API ReferenceTradingOrder PlacementAsyncSingle Order
Open in GPTGPTOpen in ClaudeClaude

Single Order

This API allows you to place an order without waiting for the exchange response.

USE CASE

Place orders in quick bursts and get an immediate acknowledgement, then track each one on the General WebSocket or order book.

Note

stopLoss and takeProfit are not supported with async order placement.

Details

  • Same JSON attributes as synchronous Place order (/api/v3/orders/sync). POST to /api/v3/orders/async.
  • For /sync vs /async behavior, queuing, 10 OPS, id_fyers and hosts, see the Order Placement Guide.
  • Placing orders needs an app with the Order Placement permission. The request attributes are the same as the sync Single Order API.
  • An HTTP 200 response only means the request was queued. It does not mean the order was placed or accepted by the exchange.
  • The queue sends requests on at most 10 orders per second.
  • The response returns id_fyers and not id. Match id_fyers with the order updates on the General WebSocket, which carry both identifiers, or with the order book.
  • Price inputs must still be multiples of the symbol tick size, and quantity must follow the lot-size rules.
  • To change or cancel this order, use Modify Single Order or Cancel Single Order.
  • Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Response Attributes - Immediate (async)

AttributeData TypeDescription
sstringok / error
codeintResponse code (same semantics family as sync where applicable)
messagestringStatus message
id_fyersstringFyers queue/async operation id (use for WebSocket and GET correlation). id is not returned here.
Last updated on
AsyncMulti Order