下单
POST/api/v1.0/sim-trade/{acc_id}/orders模拟交易下单。数量和价格均为字符串;限价单必须传 price,市价单可不传。下单不幂等:超时或结果未知时先查今日订单,避免重复下单。服务端未建单时(如 market 与账户不符)返回 -5 backend_biz_error。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
acc_id | string | path | 是 | 业务账户 ID |
market | int | body | 是 | 账户市场ID(账户列表中该账户的 market_id,如 1=港股 100=美股融资融券),必须与 acc_id 对应账户一致 |
symbol | string | body | 是 | 证券代码,支持 MARKET.CODE(如 US.AAPL、US.AAPL261120C275000)或不带前缀的代码 |
order_type | int | body | 是 | 订单类型:1=限价 3=市价 |
order_side | int | body | 是 | 买卖方向:1=买入 2=卖出 |
qty | string | body | 是 | 数量 |
price | string | body | 否 | 委托价格(限价单必填;市价单可不传) |
text | string | body | 否 | 备注(≤100 字节) |
order_trade_time_type | int | body | 否 | 交易时段:0=未设置 1=仅盘中 2=含盘前盘后(美股融资融券账户支持) |
请求示例
bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders" \
-H "Authorization: Bearer <AccessToken>" \
-H "Content-Type: application/json" \
-d '{"market":100,"symbol":"US.AAPL","order_type":1,"order_side":1,"qty":"1","price":"1","order_trade_time_type":1}' | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
order_id | string | 订单 ID |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"order_id": "1294505"
}
}错误响应
HTTP 状态始终为 200。请求失败时返回非 0 的 ret_code 和 error 对象。
json
{
"ret_code": -3,
"ret_msg": "invalid request",
"error": {"code": "invalid_parameter", "message": "invalid request"}
}服务端未建单时(如 market 与账户不符)同样按失败返回:
json
{
"ret_code": -5,
"ret_msg": "backend business error",
"error": {"code": "backend_biz_error", "message": "backend business error"}
}