Skip to content

Today's Orders ​

GET /api/v1.0/sim-trade/{acc_id}/orders

Get today's order list.

Parameters ​

ParameterTypeLocationRequiredDescription
acc_idstringpathYesBusiness account ID
marketintqueryYesAccount 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>" | jq

Response Fields ​

Returns data.orders[].

FieldTypeDescription
order_idstringOrder ID
sideintSide: 1=buy 2=sell 3=sell short 4=buy back (as recorded by the server)
marketint/nullInstrument 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
symbolstringSymbol without market prefix (e.g. AAPL, AAPL261120C275000, 00700)
stock_namestringName
order_typeintOrder type: 1=limit 3=market
statusintOrder status: 1=pending new 2=submitted 3=partially filled 4=filled 5=cancelled 6=rejected 7=partially filled then cancelled
qtystringOrder quantity
cum_qtystringFilled quantity
pricestringOrder price
avg_fill_pricestringAverage fill price
aux_pricestring/nullStop-loss trigger price (null when absent)
time_in_forceint/nullTime in force: 0=day 1=GTC (good till cancel); null when not returned
order_trade_time_typeint/nullTrading session: 0=unset 1=regular only 2=include pre/post-market; null when not returned
create_timestringCreation time (Unix microseconds, string)
update_timestringUpdate time (Unix microseconds, string)
textstringRemark

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"}
}