Today's Orders
GET/api/v1.0/sim-trade/{acc_id}/ordersGet today's order list.
Parameters
| Parameter | Type | Location | Required | Description |
|---|---|---|---|---|
acc_id | string | path | Yes | Business account ID |
market | int | query | Yes | Account market ID (the account's market_id from the account list, e.g. 1=HK stocks 100=US margin); must match the account of acc_id |
Request Example
bash
curl -s "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders?market=100" -H "Authorization: Bearer <AccessToken>" | jqResponse Fields
Returns data.orders[].
| Field | Type | Description |
|---|---|---|
order_id | string | Order ID |
side | int | Side: 1=buy 2=sell 3=sell short 4=buy back (as recorded by the server) |
market | int/null | Instrument market of the order (Market enum: 1=HK 2=US 3=US options 4=HK Connect); not the same numbering as account market_id. Stock and option orders of the US margin account are both 2; null when not returned |
symbol | string | Symbol without market prefix (e.g. AAPL, AAPL261120C275000, 00700) |
stock_name | string | Name |
order_type | int | Order type: 1=limit 3=market |
status | int | Order status: 1=pending new 2=submitted 3=partially filled 4=filled 5=cancelled 6=rejected 7=partially filled then cancelled |
qty | string | Order quantity |
cum_qty | string | Filled quantity |
price | string | Order price |
avg_fill_price | string | Average fill price |
aux_price | string/null | Stop-loss trigger price (null when absent) |
time_in_force | int/null | Time in force: 0=day 1=GTC (good till cancel); null when not returned |
order_trade_time_type | int/null | Trading session: 0=unset 1=regular only 2=include pre/post-market; null when not returned |
create_time | string | Creation time (Unix microseconds, string) |
update_time | string | Update time (Unix microseconds, string) |
text | string | Remark |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"orders": [
{
"order_id": "1294505",
"side": 1,
"market": 2,
"symbol": "AAPL",
"stock_name": "Apple",
"order_type": 1,
"status": 5,
"qty": "1",
"cum_qty": "0",
"price": "1",
"avg_fill_price": "0",
"aux_price": null,
"time_in_force": 0,
"order_trade_time_type": 1,
"create_time": "1794192328000000",
"update_time": "1794192328000000",
"text": ""
}
]
}
}Error response
HTTP status remains 200. A failed request returns ret_code != 0 and an error object.
json
{
"ret_code": -3,
"ret_msg": "invalid request",
"error": {"code": "invalid_parameter", "message": "invalid request"}
}