交易
鉴权
签名方式:每个请求用 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=。 |
该接口用于获取当日订单和订单查询。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 可选 | 股票代码,使用 `ticker.region` 格式,例如:`AAPL.US` |
status | array | 可选 | 订单状态。可选值:`NotReported`、`ReplacedNotReported`、`ProtectedNotReported`、`VarietiesNotReported`、`DelayedNotReported`、`FilledStatus`、`WaitToNew`、`NewStatus`、`WaitToReplace`、`PendingReplaceStatus`、`ReplacedStatus`、`PartialFilledStatus`、`WaitToCancel`、`PendingCancelStatus`、`RejectedStatus`、`CanceledStatus`、`ExpiredStatus`、`PartialWithdrawal`。. 例如:`status=FilledStatus&status=NewStatus` |
side | string | 可选 | 买卖方向。**可选值:**, `Buy` - 买入,`Sell` - 卖出 |
market | string | 可选 | 市场。**可选值:**, `US` - 美股,`HK` - 港股 |
order_id | string | 可选 | 订单 ID,用于指定订单 ID 查询,例如:`701276261045858304` |
is_attached | boolean | 可选 | order_id 是否为附加单,为 true 时返回附加单订单信息 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
orders | object[] | 可选 | 订单信息 |
└ order_id | string | 可选 | 订单 ID |
└ status | string | 可选 | 订单状态。可选值:`NotReported`、`ReplacedNotReported`、`ProtectedNotReported`、`VarietiesNotReported`、`DelayedNotReported`、`FilledStatus`、`WaitToNew`、`NewStatus`、`WaitToReplace`、`PendingReplaceStatus`、`ReplacedStatus`、`PartialFilledStatus`、`WaitToCancel`、`PendingCancelStatus`、`RejectedStatus`、`CanceledStatus`、`ExpiredStatus`、`PartialWithdrawal`。 |
└ stock_name | string | 可选 | 股票名称 |
└ quantity | string | 可选 | 下单数量 |
└ executed_quantity | string | 可选 | 成交数量。. 当订单未成交时为 0 |
└ price | string | 可选 | 下单价格。. 当市价条件单未触发时为空字符串 |
└ executed_price | string | 可选 | 成交价。. 当订单未成交时为 0 |
└ submitted_at | string | 可选 | 下单时间 |
└ side | string | 可选 | 买卖方向。**可选值:**, `Buy` - 买入,`Sell` - 卖出 |
└ symbol | string | 可选 | 股票代码,使用 `ticker.region` 格式,例如:`AAPL.US` |
└ order_type | string | 可选 | 订单类型。可选值:`LO`、`ELO`、`MO`、`AO`、`ALO`、`ODD`、`LIT`、`MIT`、`TSLPAMT`、`TSLPPCT`、`SLO`。 |
└ trigger_price | string | 可选 | `LIT` / `MIT` 订单触发价格。. 当订单不是 `LIT` / `MIT` 订单为空字符串 |
└ tag | string | 可选 | 订单标记。**可选值:**, `Normal` - 普通订单,`Gtc` - 长期单,`Grey` - 暗盘单 |
└ time_in_force | string | 可选 | 订单有效期类型。**可选值:**, `Day` - 当日有效,`GTC` - 撤单前有效,`GTD` - 到期前有效 |
└ expire_date | string | 可选 | 长期单过期时间,格式为 `YYYY-MM-DD`, 例如:`2022-12-05。. 不是长期单时,默认为空字符串。` |
└ updated_at | string | 可选 | 最近更新时间,格式为时间戳 (秒),默认为 0。 |
└ trigger_at | string | 可选 | 条件单触发时间,格式为时间戳 (秒),默认为 0。 |
└ trigger_status | string | 可选 | 条件单触发状态,当订单不是条件单或条件单未触发时,触发状态为 NOT_USED. **可选值:**, `NOT_USED` - 未激活 `DEACTIVE` - 已失效 `ACTIVE` - 已激活 `RELEASED` - 已触发 |
└ outside_rth | string | 可选 | 是否允许盘前盘后,当订单不是美股时,默认为 UnknownOutsideRth. **可选值:**, `RTH_ONLY` - 不允许盘前盘后,`ANY_TIME` - 允许盘前盘后,`OVERNIGHT` - 夜盘" |
└ currency | string | 可选 | 结算货币 |
└ limit_depth_level | integer | 可选 | 指定买卖档位 |
└ trigger_count | integer | 可选 | 触发次数 |
└ trigger_qty_type | integer | 可选 | 触发数量类型。 |
└ attached_orders | array | 可选 | 附加订单详情列表 |
└ last_done | string | 可选 | 最近成交价格。. 当订单未成交时为空字符串 |
└ msg | string | 可选 | 拒绝信息或备注,默认为空字符串。 |
└ trailing_amount | string | 可选 | `TSLPAMT` 订单跟踪金额。. 当订单不是 `TSLPAMT` 订单时为空字符串。 |
└ trailing_percent | string | 可选 | `TSLPPCT` 订单跟踪涨跌幅。. 当订单不是 `TSLPPCT` 订单时为空字符串。 |
└ limit_offset | string | 可选 | `TSLPAMT` / `TSLPPCT` 订单指定价差。. 当订单不是 `TSLPAMT` / `TSLPPCT` 订单时为空字符串。 |
└ remark | string | 可选 | 备注 |
└ monitor_price | string | 可选 | 监控价格 |
└ monitor_counter_id | string | 可选 | 监控标的内部标识(条件单)。 |
└ multi_leg | string | 可选 | 多腿策略信息,仅多腿期权组合订单返回,非组合订单不返回。 |
has_more | boolean | 可选 | 是否还有更多数据。. 每次查询最大订单数量为 1000,如果查询结果数量超过 1000,那么 has_more 就会为 true |
响应 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"orders": [
{
"currency": "HKD",
"executed_price": "0.000",
"executed_quantity": "0",
"expire_date": "",
"last_done": "",
"limit_offset": "",
"msg": "",
"order_id": "706388312699592704",
"order_type": "ELO",
"outside_rth": "UnknownOutsideRth",
"price": "11.900",
"quantity": "200",
"side": "Buy",
"status": "RejectedStatus",
"stock_name": "Bank of East Asia Ltd/The",
"submitted_at": "1651644897",
"symbol": "23.HK",
"tag": "Normal",
"time_in_force": "Day",
"trailing_amount": "",
"trailing_percent": "",
"trigger_at": "0",
"trigger_price": "",
"trigger_status": "NOT_USED",
"updated_at": "1651644898",
"remark": "",
"limit_depth_level": 0,
"monitor_price": "",
"trigger_count": 1,
"attached_orders": [
{
"order_id": "706388312699592705",
"attached_type_display": 2,
"trigger_price": "10.500",
"quantity": "200",
"executed_qty": "0",
"status": "NewStatus",
"updated_at": "1651644898",
"withdrawn": false,
"gtd": "",
"time_in_force": "Day",
"counter_id": "",
"trigger_status": 0,
"executed_amount": "0",
"tag": 0,
"submitted_at": "1651644897",
"executed_price": "0.000",
"force_only_rth": "RTH_ONLY",
"reviewed": false,
"activate_order_type": "MIT",
"activate_rth": "RTH_ONLY",
"submit_price": ""
}
],
"multi_leg": {
"strategy": "2",
"strategy_name": "Vertical spread",
"multileg_id": "Spread_QQQ20260731C764/767",
"code": "QQQ 260731 764/767 Vertical spread",
"legs": [
{
"symbol": "QQQ260731C764000.US",
"side": "Buy",
"position": "LONG",
"ratio_quantity": "1",
"strike_price": "764",
"expire_date": "20260731",
"contract_direction": "C"
},
{
"symbol": "QQQ260731C767000.US",
"side": "Sell",
"position": "SHORT",
"ratio_quantity": "1",
"strike_price": "767",
"expire_date": "20260731",
"contract_direction": "C"
}
]
}
}
]
}
}错误码
参见错误码文档。