Skip to main content
POST
Place a new order

Authorizations

Authorization
string
header
required

Bearer token used for protected REST API requests.

Path Parameters

refOrderID
string
required

Client-generated order reference used for tracking and duplicate detection.

accountID
string
required

Trading account identifier. The authenticated user must be allowed to access this account.

symbol
string
required

Trading symbol or product code such as FPT or VN30F1M.

orderSide
string
required

Order side. Accepted values: B for buy, S for sell.

price
number
required

Order price. For market-style orders, backend interpretation depends on orderType.

qty
integer<int64>
required

Order quantity in shares/contracts/lots accepted by the broker.

orderType
string
required

Order type. Common accepted values include LO, MTL, ATO, and ATC.

Response

Normal order placement result.

Normal order placement response.

isSuccess
boolean
required

Whether service.orderapi accepted the request and submitted the order to the broker.

detail
string
required

Result message. On success this is usually "Order placed successfully"; on failure it contains the reject or validation reason.

data
string
required

System order id generated by service.orderapi for the newly created order. Use this id with cancel APIs, execution reports, and order streams. This is not the external broker order id and not the client-supplied refOrderID.

Pattern: ^ORDER-
Example:

"ORDER-V1StGXR8_Z5jdHi6B-myT"