订单详情
该接口用于订单详情查询。
SDK Links
Python |
Rust |
Go |
Node.js |
Request
HTTP Method | GET |
HTTP URL | /v1/trade/order |
Parameters
Content-Type: application/json; charset=utf-8
Name | Type | Required | Description |
---|---|---|---|
order_id | string | YES | 订单 ID,用于指定订单 ID 查询,例如:701276261045858304 |
Request Example
from longport.openapi import TradeContext, Config
config = Config.from_env()
ctx = TradeContext(config)
resp = ctx.order_detail(
order_id = "701276261045858304",
)
print(resp)
Response
Response Headers
- Content-Type: application/json
Response Example
{
"code": 0,
"message": "success",
"data": {
"order_id": "828940451093708800",
"status": "FilledStatus",
"stock_name": "苹果",
"quantity": "10",
"executed_quantity": "10",
"price": "200.000",
"executed_price": "164.660",
"submitted_at": "1680863604",
"side": "Buy",
"symbol": "AAPL.US",
"order_type": "LO",
"last_done": "164.660",
"trigger_price": "0.0000",
"msg": "",
"tag": "Normal",
"time_in_force": "Day",
"expire_date": "2023-04-10",
"updated_at": "1681113000",
"trigger_at": "0",
"trailing_amount": "",
"trailing_percent": "",
"limit_offset": "",
"trigger_status": "NOT_USED",
"outside_rth": "ANY_TIME",
"currency": "USD",
"remark": "1680863603.927165",
"free_status": "None",
"free_amount": "",
"free_currency": "",
"deductions_status": "NONE",
"deductions_amount": "",
"deductions_currency": "",
"platform_deducted_status": "NONE",
"platform_deducted_amount": "",
"platform_deducted_currency": "",
"history": [
{
"price": "164.6600",
"quantity": "10",
"status": "FilledStatus",
"msg": "Execution of 10",
"time": "1681113000"
},
{
"price": "200.0000",
"quantity": "10",
"status": "NewStatus",
"msg": "",
"time": "1681113000"
}
],
"charge_detail": {
"items": [
{
"code": "BROKER_FEES",
"name": "收费明细",
"fees": []
},
{
"code": "THIRD_FEES",
"name": "第三方收费明细",
"fees": []
}
],
"total_amount": "0",
"currency": "USD"
}
}
}
Response Status
Status | Description | Schema |
---|---|---|
200 | 订单详情查询成功 | order_detail_rsp |
400 | 查询失败,请求参数错误。 | None |
Schemas
order_detail_rsp
订单信息
Name | Type | Required | Description |
---|---|---|---|
order_id | string | true | 订单 ID |
status | string | true | 订单状态 |
stock_name | string | true | 股票名称 |
quantity | string | true | 下单数量 |
executed_quantity | string | true | 成交数量。 当订单未成交时为 0 |
price | string | true | 下单价格。 当市价条件单未触发时为空字符串 |
executed_price | string | true | 成交价。 当订单未成交时为 0 |
submitted_at | string | true | 下单时间 |
side | string | true | 买卖方向 可选值: Buy - 买入Sell - 卖出 |
symbol | string | true | 股票代码,使用 ticker.region 格式,例如:AAPL.US |
order_type | string | true | 订单类型 |
last_done | string | true | 最近成交价格。 当订单未成交时为空字符串 |
trigger_price | string | true | LIT / MIT 订单触发价格。当订单不是 LIT / MIT 订单为空字符串 |
msg | string | true | 拒绝信息或备注,默认为空字符串。 |
tag | string | true | 订单标记 可选值: Normal - 普通订单GTC - 长期单Grey - 暗盘单 |
time_in_force | string | true | 订单有效期类型 可选值: Day - 当日有效GTC - 撤单前有效GTD - 到期前有效 |
expire_date | string | true | 长期单过期时间,格式为 YYYY-MM-DD , 例如:`2022-12-05。不是长期单时,默认为空字符串。 |
updated_at | string | true | 最近更新时间,格式为时间戳 (秒),默认为 0。 |
trigger_at | string | true | 条件单触发时间,格式为时间戳 (秒),默认为 0。 |
trailing_amount | string | true | TSLPAMT 订单跟踪金额。当订单不是 TSLPAMT 订单时为空字符串。 |
trailing_percent | string | true | TSLPPCT 订单跟踪涨跌幅。当订单不是 TSLPPCT 订单时为空字符串。 |
limit_offset | string | true | TSLPAMT / TSLPPCT 订单指定价差。当订单不是 TSLPAMT / TSLPPCT 订单时为空字符串。 |
trigger_status | string | true | 条件单触发状态 当订单不是条件单或条件单未触发时, 触发状态为 NOT_USED 可选值: NOT_USED - 未激活DEACTIVE - 已失效ACTIVE - 已激活RELEASED - 已触发 |
currency | string | true | 结算货币 |
outside_rth | string | true | 是否允许盘前盘后 当订单不是美股时, 默认为 UnknownOutsideRth 可选值: RTH_ONLY - 不允许盘前盘后ANY_TIME - 允许盘前盘后OVERNIGHT - 夜盘" |
remark | string | true | 备注 |
free_status | string | true | 免佣状态,默认为 None 可选值: None - 无Calculated - 免佣额待计算Pending - 待免佣Ready - 已免佣 |
free_amount | string | true | 免佣金额,默认为空字符串 |
free_currency | string | true | 免佣货币,默认为空字符串 |
deductions_status | string | true | 抵扣状态/返现状态,默认为 NONE 可选值: NONE - 待结算 NO_DATA - 已结算无数据PENDING - 已结算待发放DONE - 已结算已发放 |
deductions_amount | string | true | 抵扣金额,默认为空字符串 |
deductions_currency | string | true | 抵扣货币,默认为空字符串 |
platform_deducted_status | string | true | 平台费抵扣状态/返现状态,默认为 NONE 可选值: NONE - 待结算 NO_DATA - 已结算无数据PENDING - 已结算待发放DONE - 已结算已发放 |
platform_deducted_amount | string | true | 平台费抵扣金额,默认为空字符串 |
platform_deducted_currency | string | true | 平台费抵扣货币,默认为空字符串 |
history | object[] | true | 订单历史明细 |
∟ price | string | true | 成交展示成交价格,过期、撤单、拒绝等状态展示提交价格 |
∟ quantity | string | true | 成交展示成交数量,过期、撤单、拒绝等状态展示剩余数量 |
∟ status | string | true | 订单状态 |
∟ msg | string | true | 成交或错误信息 |
∟ time | string | true | 发生时间 |
charge_detail | object | true | 订单费用 |
∟ total_amount | string | true | 全部费用 |
∟ currency | string | true | 结算货币 |
∟ items | object[] | true | 订单费用明细 |
∟∟ code | string | true | 收费类别代码 可选值: UNKNOWN BROKER_FEES THIRD_FEES |
∟∟ name | string | true | 收费类别名称 |
∟∟ fees | object[] | true | 收费明细 |
∟∟∟ code | string | true | 收费代码 |
∟∟∟ name | string | true | 收费名称 |
∟∟∟ amount | string | true | 单项收费金额 |
∟∟∟ currency | string | true | 收费货币 |