Place Order
Place Order
Descriptionâ
This interface is used to place stock/option orders.
HTTP Requestâ
- POST /api/v3/stockplus/trade/place-order
- Rate limit: 30 times/30s (UID), minimum interval 0.02 seconds
- Permission: Trade (read and write)
Request
curl "https://api.bitget.com/api/v3/stockplus/trade/place-order" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
-d '{"symbol":"AAPL.US","orderType":"LO","side":"Buy","submittedQuantity":"100","timeInForce":"Day","submittedPrice":"150.00","outsideRth":"RTHOnly"}'
Request Parametersâ
| Parameters | Type | Required | Description |
|---|---|---|---|
| symbol | String | Yes | Symbol, using ticker.region format, e.g. AAPL.US |
| orderType | String | Yes | Order type. See order type enumeration below |
| side | String | Yes | Order sideBuy - BuySell - Sell |
| submittedQuantity | String | Yes | Order quantity, e.g. 100 |
| timeInForce | String | Yes | Order validity typeDay - Valid for the dayGoodTilCanceled - Valid until cancelledGoodTilDate - Valid until expiry |
| submittedPrice | String | No | Order price, e.g. 388.5Required for LO / LIT orders |
| triggerPrice | String | No | Trigger price, e.g. 388.5Required for LIT / MIT orders |
| limitOffset | String | No | Specified spread, e.g. 1.2 means spread of 1.2 USD (for US stocks)Required for TSLPAMT / TSLPPCT orders when limitDepthLevel is 0 |
| trailingAmount | String | No | Trailing amount Required for TSLPAMT orders |
| trailingPercent | String | No | Trailing percentage, in percentage points, e.g. 2.5 means 2.5%Required for TSLPPCT orders |
| expireDate | String | No | Long-term order expiry date, format: YYYY-MM-DD, e.g. 2022-12-05Required when timeInForce is GoodTilDate |
| outsideRth | String | No | Whether to allow trading outside regular trading hours. Required for US stocksRTHOnly - Do not allow pre/post marketAnyTime - Allow pre/post marketOvernight - Overnight trading |
| limitDepthLevel | Number | No | Specified bid/ask level, range -5 to 5. Negative is bid level (e.g. -1 is best bid), positive is ask level (e.g. 1 is best ask). When 0, limitOffset takes effectValid for TSLPAMT / TSLPPCT orders |
| triggerCount | Number | No | Trigger count, range 0~3. The order is triggered after the condition is met this many times within 1 minute Valid for LIT / MIT / TSLPAMT / TSLPPCT orders |
| monitorPrice | String | No | Monitor price, the order starts monitoring only when the price reaches this level Valid for TSLPAMT / TSLPPCT orders |
| remark | String | No | Remark (max 64 characters) |
Response
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"orderId": "701276261045858304",
"clientOid": "myOrder001",
"symbol": "AAPL220429C150000.US"
}
}
Response Parametersâ
| Parameters | Type | Description |
|---|---|---|
| orderId | String | System order ID |
| clientOid | String | Client customized order ID. Returns empty string if not passed |
| symbol | String | Option contract symbol |
Supported Order Types
| Enum Value | Description |
|---|---|
| LO | Limit Order |
| MO | Market Order |
| LIT | Limit If Touched |
| MIT | Market If Touched |
| TSLPAMT | Trailing Stop Limit Order (Trailing Amount) |
| TSLPPCT | Trailing Stop Limit Order (Trailing Percentage) |