创建订单
创建订单
描述
该接口用于委托下单。
HTTP请求
- POST /api/v3/stockplus/trade/place-order
- 限频规则: 30秒内累计不超过30次调用,且每两次调用之间间隔不小于0.02秒
- 权限: 统一账户交易读写权限
请求示例
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:zh-CN" \
-H "Content-Type: application/json" \
-d '{"symbol":"AAPL.US","orderType":"LO","side":"Buy","submittedQuantity":"100","timeInForce":"Day","submittedPrice":"150.00","outsideRth":"RTHOnly"}'
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | String | 是 | 股票代码,使用 ticker.region 格式,例如:AAPL.US |
| orderType | String | 是 | 订单类型。见下方订单类型枚举 |
| side | String | 是 | 买卖方向Buy - 买入Sell - 卖出 |
| submittedQuantity | String | 是 | 下单数量,例如:100 |
| timeInForce | String | 是 | 订单有效期类型Day - 当日有效GoodTilCanceled - 撤单前有效GoodTilDate - 到期前有效 |
| submittedPrice | String | 否 | 下单价格,例如:388.5LO / LIT 订单必填 |
| triggerPrice | String | 否 | 触发价格,例如:388.5LIT / MIT 订单必填 |
| limitOffset | String | 否 | 指定价差,例如 1.2 表示价差 1.2 USD(如果是美股)TSLPAMT / TSLPPCT 订单在 limitDepthLevel 为 0 时必填 |
| trailingAmount | String | 否 | 跟踪金额TSLPAMT 订单必填 |
| trailingPercent | String | 否 | 跟踪涨跌幅,单位为百分比,例如 2.5 表示 2.5%TSLPPCT 订单必填 |
| expireDate | String | 否 | 长期单过期时间,格式为 YYYY-MM-DD,例如:2022-12-05timeInForce 为 GoodTilDate 时必填 |
| outsideRth | String | 否 | 是否允许盘前盘后,美股必填RTHOnly - 不允许盘前盘后AnyTime - 允许盘前盘后Overnight - 夜盘 |
| limitDepthLevel | Number | 否 | 指定买卖档位,取值范围为 -5 ~ 0 ~ 5,负数代表买盘档位(如 -1 表示买一),正数代表卖盘档位(如 1 表示卖一),为 0 时 limitOffset 参数生效TSLPAMT / TSLPPCT 订单有效 |
| triggerCount | Number | 否 | 触发次数,取值范围 0 ~ 3,表示在 1 分钟内触发多次才会触发订单LIT / MIT / TSLPAMT / TSLPPCT 订单有效 |
| monitorPrice | String | 否 | 监控价格,需要达到该价格才会开始监控,更新参考价TSLPAMT / TSLPPCT 订单有效 |
| remark | String | 否 | 备注(最大 64 字符) |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1740000000000,
"data": {
"orderId": "701276261045858304",
"clientOid": "myOrder001",
"symbol": "AAPL220429C150000.US"
}
}
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| orderId | String | 系统订单 ID |
| clientOid | String | 客户端自定义订单 ID,未传则返回空字符串 |
| symbol | String | 期权合约代码 |
支持的订单类型
| 枚举值 | 描述 |
|---|---|
| LO | 限价单 |
| MO | 市价单 |
| LIT | 触价限价单 |
| MIT | 触价市价单 |
| TSLPAMT | 跟踪止损限价单(跟踪金额) |
| TSLPPCT | 跟踪止损限价单(跟踪涨跌幅) |