跳到主要內容

獲取歷史訂單

該接口用於獲取歷史訂單。

SDK Links

Python
longport.openapi.TradeContext.history_orders
Rust
longport::trade::TradeContext#history_orders
Go
TradeContext.HistoryOrders
Node.js
TradeContext#historyOrders

Request

HTTP MethodGET
HTTP URL/v1/trade/order/history

Parameters

Content-Type: application/json; charset=utf-8

NameTypeRequiredDescription
symbolstringNO股票代碼,使用 ticker.region 格式,例如:AAPL.US
statusstring[]NO訂單狀態

例如:status=FilledStatus&status=NewStatus
sidestringNO買賣方向

可選值:
Buy - 買入
Sell - 賣出
marketstringNO市場

可選值:
US - 美股
HK - 港股
start_atstringNO開始時間,格式為時間戳 (秒),例如:1650410999

開始時間為空時,默認為結束時間或當前時間前九十天。
end_atstringNO結束時間,格式為時間戳 (秒),例如:1650410999

結束時間為空時,默認為開始時間後九十天或當前時間。

Request Example

from datetime import datetime
from longport.openapi import TradeContext, Config, OrderStatus, OrderSide, Market

config = Config.from_env()
ctx = TradeContext(config)

resp = ctx.history_orders(
symbol = "700.HK",
status = [OrderStatus.Filled, OrderStatus.New],
side = OrderSide.Buy,
market = Market.HK,
start_at = datetime(2022, 5, 9),
end_at = datetime(2022, 5, 12),
)
print(resp)

Response

Response Headers

  • Content-Type: application/json

Response Example

{
"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": "東亞銀行",
"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": ""
}
]
}
}

Response Status

StatusDescriptionSchema
200歷史訂單查詢成功history_orders_rsp
400查詢失敗,請求參數錯誤。None

Schemas

history_orders_rsp

NameTypeRequiredDescription
has_morebooleantrue是否還有更多數據。

每次查詢最大訂單數量為 1000,如果查詢結果數量超過 1000,那麽 has_more 就會為 true
ordersobject[]false訂單信息
∟ order_idstringtrue訂單 ID
∟ statusstringtrue訂單狀態
∟ stock_namestringtrue股票名稱
∟ quantitystringtrue下單數量
∟ executed_quantitystringtrue成交數量。

當訂單未成交時為 0
∟ pricestringtrue下單價格。

當市價條件單未觸發時為空字符串
∟ executed_pricestringtrue成交價。

當訂單未成交時為 0
∟ submitted_atstringtrue下單時間
∟ sidestringtrue買賣方向

可選值:
Buy - 買入
Sell - 賣出
∟ symbolstringtrue股票代碼,使用 ticker.region 格式,例如:AAPL.US
∟ order_typestringtrue訂單類型
∟ last_donestringtrue最近成交價格。

當訂單未成交時為空字符串
∟ trigger_pricestringtrueLIT / MIT 訂單觸發價格。

當訂單不是 LIT / MIT 訂單為空字符串
∟ msgstringtrue拒絕信息或備註,默認為空字符串。
∟ tagstringtrue訂單標記

可選值:
Normal - 普通訂單
GTC - 長期單
Grey - 暗盤單
∟ time_in_forcestringtrue訂單有效期類型

可選值:
Day - 當日有效
GTC - 撤單前有效
GTD - 到期前有效
∟ expire_datestringtrue長期單過期時間,格式為 YYYY-MM-DD, 例如:2022-12-05。<br/><br/>不是長期單時,默認為空字符串。
∟ updated_atstringtrue最近更新時間,格式為時間戳 (秒),默認為 0。
∟ trigger_atstringtrue條件單觸發時間,格式為時間戳 (秒),默認為 0。
∟ trailing_amountstringtrueTSLPAMT 訂單跟蹤金額。

當訂單不是 TSLPAMT 訂單時為空字符串。
∟ trailing_percentstringtrueTSLPPCT 訂單跟蹤漲跌幅。

當訂單不是 TSLPPCT 訂單時為空字符串。
∟ limit_offsetstringtrueTSLPAMT / TSLPPCT 訂單指定價差。

當訂單不是 TSLPAMT / TSLPPCT 訂單時為空字符串。
∟ trigger_statusstringtrue條件單觸發狀態
當訂單不是條件單或條件單未觸發時, 觸發狀態為 NOT_USED

可選值:
NOT_USED - 未激活 DEACTIVE - 已失效 ACTIVE - 已激活 RELEASED - 已觸發
∟ currencystringtrue結算貨幣
∟ outside_rthstringtrue是否允許盤前盤後
當訂單不是美股時, 默認為 UnknownOutsideRth

可選值:
RTH_ONLY - 不允許盤前盤後
ANY_TIME - 允許盤前盤後
OVERNIGHT - 夜盤
∟ remarkstringtrue備註