订单详情

该接口用于订单详情查询

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 - 允许盘前盘后
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	收费货币