交易
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
该接口用于港美股,窝轮,期权的委托下单。
longbridge order buy TSLA.US 100 --price 250.00
longbridge order sell TSLA.US 100 --price 260.00
请求
请求体
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 必填 | 股票代码,使用 `ticker.region` 格式,例如:`AAPL.US` |
order_type | string | 必填 | 订单类型。可选值:`LO`、`ELO`、`MO`、`AO`、`ALO`、`ODD`、`LIT`、`MIT`、`TSLPAMT`、`TSLPPCT`、`SLO`。 |
submitted_price | string | 可选 | 下单价格,例如:`388.5`. `LO` / `ELO` / `ALO` / `ODD` / `LIT` 订单必填 |
submitted_quantity | string | 必填 | 下单数量,例如:`100`。美股支持碎股数量,例如 `0.05`。美股碎股订单必须将 `outside_rth` 设为 `RTH_ONLY`,否则会被拒单,返回错误码 `603200`。 |
trigger_price | string | 可选 | 触发价格,例如:`388.5`. `LIT` / `MIT` 订单必填 |
limit_offset | string | 可选 | 指定价差,例如 "1.2" 表示价差 1.2 USD (如果是美股). `TSLPAMT` / `TSLPPCT` 订单在 `limit_depth_level` 为 0 时必填 |
trailing_amount | string | 可选 | 跟踪金额。`TSLPAMT` 订单必填 |
trailing_percent | string | 可选 | 跟踪涨跌幅,单位为百分比,例如 "2.5" 表示 "2.5%". `TSLPPCT` 订单必填 |
expire_date | string | 可选 | 长期单过期时间,格式为 `YYYY-MM-DD`, 例如:`2022-12-05`. time_in_force 为 `GTD` 时必填 |
side | string | 必填 | 买卖方向。**可选值:**, `Buy` - 买入,`Sell` - 卖出 |
outside_rth | string | 可选 | 是否允许盘前盘后,美股必填。**可选值:**, `RTH_ONLY` - 不允许盘前盘后,`ANY_TIME` - 允许盘前盘后,`OVERNIGHT` - 夜盘,`OPTION_PRE_MARKET` - 夜盘期权 |
time_in_force | string | 必填 | 订单有效期类型。**可选值:**, `Day` - 当日有效,`GTC` - 撤单前有效,`GTD` - 到期前有效 |
remark | string | 可选 | 备注 (最大 64 字符) |
limit_depth_level | integer | 可选 | 指定买卖档位,取值范围为 -5 ~ 0 ~ 5,负数代表买盘档位(如 -1 表示买一),, 正数代表卖盘档位(如 1 表示卖一),为 0 时 limit_offset 参数生效,`TSLPAMT` / `TSLPPCT` 订单有效 |
monitor_price | string | 可选 | 监控价格,需要达到该价格才会开始监控,更新参考价,`TSLPAMT` / `TSLPPCT` 订单有效 |
trigger_count | integer | 可选 | 触发次数,取值范围 0 ~ 3, 表示在 1 分钟内触发多次才会触发订单,`LIT` / `MIT` / `TSLPAMT` / `TSLPPCT` 订单有效 |
client_request_id | string | 可选 | 幂等性请求 ID,用于防止重复下单。服务器会缓存该请求 ID 10 分钟。在此期间内如果收到相同 ID 的请求,将返回原始响应而不创建重复订单。必须是唯一标识符(如 UUID)。 |
attached_params | object | 可选 | 附加单参数(止盈止损) |
attached_params.attached_order_type | string | 可选 | 附加单订单类型。**可选值:**, `PROFIT_TAKER` - 止盈,`STOP_LOSS` - 止损,`BRACKET` - 括号单 |
attached_params.profit_taker_price | string | 可选 | 止盈触发价格 |
attached_params.stop_loss_price | string | 可选 | 止损触发价格 |
attached_params.time_in_force | string | 可选 | 附加单有效期类型。**可选值:**, `Day` - 当日有效,`GTC` - 撤单前有效,`GTD` - 到期前有效(此时继承主单 expire_date) |
attached_params.expire_time | integer | 可选 | 到期时间(Unix 时间戳,单位秒) |
attached_params.activate_order_type | string | 可选 | 触发后提交的订单类型,例如 `LIT`(限价单)或 `MIT`(市价单) |
attached_params.profit_taker_submit_price | string | 可选 | 止盈限价委托价格,`activate_order_type` 为 `LIT` 时必填 |
attached_params.stop_loss_submit_price | string | 可选 | 止损限价委托价格,`activate_order_type` 为 `LIT` 时必填 |
attached_params.activate_rth | string | 可选 | 触发后提交的订单是否允许盘前盘后。**可选值:**, `RTH_ONLY` - 不允许盘前盘后,`ANY_TIME` - 允许盘前盘后 |
attached_params.profit_taker_depth_level | integer | 可选 | 止盈限价委托价格的买卖档位,`activate_order_type` 为 `LIT` 时有效 |
attached_params.stop_loss_depth_level | integer | 可选 | 止损限价委托价格的买卖档位,`activate_order_type` 为 `LIT` 时有效 |
响应
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"order_id": 683615454870679600
}
}错误码
参见错误码文档。