订单查询

获取订单列表

功能说明

查询全部订单。 req 所有字段可选；Account 留空时自动填默认账户。 方法签名

func (c *TradeClient) Orders(req model.OrdersRequest) ([]model.Order, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.OrdersRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`SegType`	`string`	否	空值省略	无；可选值：ALL, SEC, FUT, FUND
`Symbol`	`string`	否	空值省略	标的代码
`IsBrief`	`bool`	否	`false` 时省略	是否返回精简订单信息
`StartDate`	`int64`	否	空值省略	无；ms 时间戳
`EndDate`	`int64`	否	空值省略	查询结束时间，毫秒时间戳
`Limit`	`int`	否	零值省略	返回数量；省略时服务端使用 100，最大 300
`States`	`[]string`	否	空值省略	无；OrderStatus 值列表
`ParentId`	`int64`	否	零值省略	父订单 ID
`SortBy`	`string`	否	空值省略	无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
`ShowCharges`	`*bool`	否	`nil` 时省略	是否请求费用明细；指针可区分显式 `false` 与省略
`PageToken`	`string`	否	空值省略	分页游标
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

时间范围说明：StartDate 和 EndDate 均可选；省略任一边界时，不添加对应方向的时间过滤。接口未规定最大时间跨度，但单次返回数量限制仍然适用。建议指定合理的时间范围。

([]model.Order, error)。关键字段来自 model.Order：

字段	类型	说明
Account	string	账户 ID
ID	int64	订单 ID
OrderId	int64	订单号
Action	string	交易方向 (BUY/SELL)
OrderType	string	订单类型
TotalQuantity	int64	委托数量
LimitPrice	float64	限价
AuxPrice	float64	辅助价格（止损价）
TrailingPercent	float64	跟踪止损百分比
Status	string	订单状态
FilledQuantity	int64	成交数量
AvgFillPrice	float64	按成交价格加权计算的成交均价，不含佣金和其他费用
TimeInForce	string	有效期
OutsideRth	bool	是否允许盘前盘后
OrderLegs	[]OrderLeg	附加订单
AlgoParams	*AlgoParams	算法参数
Symbol	string	标的代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Expiry	string	到期日
Strike	string	行权价
Right	string	期权方向
Identifier	string	合约标识符
Name	string	合约名称
Commission	float64	佣金
RealizedPnl	float64	已实现盈亏
OpenTime	int64	开仓时间，毫秒时间戳
UpdateTime	int64	更新时间，毫秒时间戳
LatestTime	int64	最新时间，毫秒时间戳
Remark	string	备注
Source	string	订单来源
UserMark	string	用户标记
ExternalId	string	外部 ID
TotalQuantityScale	int	委托数量精度
FilledQuantityScale	int	成交数量精度
FilledCashAmount	float64	成交现金金额
Gst	float64	GST
Liquidation	bool	是否为强平订单
AttrDesc	string	属性说明
AttrList	[]string	属性列表
AlgoStrategy	string	算法策略
Discount	float64	折扣
ReplaceStatus	string	改单状态
CancelStatus	string	撤单状态
CanModify	bool	是否可修改
CanCancel	bool	是否可撤销
IsOpen	bool	是否为未完成订单
OrderDiscount	float64	订单折扣
TradingSessionType	string	交易时段类型
LatestPrice	float64	最新价
DisplaySize	int64	冰山单展示数量
MinDisplaySize	int64	冰山单最小展示数量
CheckIntervals	int64	冰山单价检间隔，秒
PriceType	string	冰山单价格类型
StartTime	int64	生效开始时间，毫秒时间戳
EndTime	int64	生效结束时间，毫秒时间戳

`OrderLeg` 字段	类型	说明
LegType	string	附加订单类型
Price	float64	价格
TimeInForce	string	有效期
Quantity	int64	数量

`AlgoParams` 字段	类型	说明
AlgoStrategy	string	算法策略
StartTime	string	开始时间
EndTime	string	结束时间
ParticipationRate	float64	参与率

佣金和 GST 通过独立字段返回；准确的计算口径和币种请以账户结单为准。Go 的数值字段为非指针类型，缺失值与明确返回的 0 都表现为 0。

示例

result, err := tc.Orders(model.OrdersRequest{
	Account: "U123456",
	Market: "US",
	SecType: "STK",
	Symbol: "AAPL",
	StartDate: 1,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "id": 123456789,
    "orderId": 123456789,
    "symbol": "AAPL",
    "secType": "STK",
    "market": "US",
    "action": "BUY",
    "orderType": "LMT",
    "limitPrice": 310.00,
    "totalQuantity": 100,
    "filledQuantity": 100,
    "avgFillPrice": 309.85,
    "status": "Filled",
    "account": "12345678",
    "currency": "USD",
    "openTime": 1785504600000,
    "updateTime": 1785505200000
  }
]

调用频率

基础限流为 120 次/分钟。Orders 与 GetOrder 均使用 orders，共享此额度。

获取订单详情

功能说明

按订单 ID 查询单个订单详情。 API method: orders（传 id 或 order_id 参数，服务端直接返回单个 Order 对象，不是 {items:[]} 包装）。必须提供 Id 或 OrderId 之一。没有匹配时返回 nil。客户端会空账户字段由客户端填入默认账户。

方法签名

func (c *TradeClient) GetOrder(req model.GetOrderRequest) (*model.Order, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.GetOrderRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`Id`	`int64`	条件必填	零值省略	全局订单 ID；`Id` 与 `OrderId` 必须提供一个
`OrderId`	`int64`	条件必填	零值省略	账户维度订单 ID；`Id` 与 `OrderId` 必须提供一个
`IsBrief`	`bool`	否	`false` 时省略	是否返回精简订单信息
`ShowCharges`	`*bool`	否	`nil` 时省略	是否请求费用明细；指针可区分显式 `false` 与省略
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

(*model.Order, error)。关键字段来自 model.Order：

字段	类型	说明
Account	string	账户 ID
ID	int64	订单 ID
OrderId	int64	订单号
Action	string	交易方向 (BUY/SELL)
OrderType	string	订单类型
TotalQuantity	int64	委托数量
LimitPrice	float64	限价
AuxPrice	float64	辅助价格（止损价）
TrailingPercent	float64	跟踪止损百分比
Status	string	订单状态
FilledQuantity	int64	成交数量
AvgFillPrice	float64	成交均价
TimeInForce	string	有效期
OutsideRth	bool	是否允许盘前盘后
OrderLegs	[]OrderLeg	附加订单
AlgoParams	*AlgoParams	算法参数
Symbol	string	标的代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Expiry	string	到期日
Strike	string	行权价
Right	string	期权方向
Identifier	string	合约标识符
Name	string	合约名称
Commission	float64	佣金
RealizedPnl	float64	已实现盈亏
OpenTime	int64	开仓时间，毫秒时间戳
UpdateTime	int64	更新时间，毫秒时间戳
LatestTime	int64	最新时间，毫秒时间戳
Remark	string	备注
Source	string	订单来源
UserMark	string	用户标记
ExternalId	string	外部 ID
TotalQuantityScale	int	委托数量精度
FilledQuantityScale	int	成交数量精度
FilledCashAmount	float64	成交现金金额
Gst	float64	GST
Liquidation	bool	是否为强平订单
AttrDesc	string	属性说明
AttrList	[]string	属性列表
AlgoStrategy	string	算法策略
Discount	float64	折扣
ReplaceStatus	string	改单状态
CancelStatus	string	撤单状态
CanModify	bool	是否可修改
CanCancel	bool	是否可撤销
IsOpen	bool	是否为未完成订单
OrderDiscount	float64	订单折扣
TradingSessionType	string	交易时段类型
LatestPrice	float64	最新价
DisplaySize	int64	冰山单展示数量
MinDisplaySize	int64	冰山单最小展示数量
CheckIntervals	int64	冰山单价检间隔，秒
PriceType	string	冰山单价格类型
StartTime	int64	生效开始时间，毫秒时间戳
EndTime	int64	生效结束时间，毫秒时间戳

OrderLeg 字段

字段	类型	说明
`LegType`	`string`	附加订单类型
`Price`	`float64`	价格
`TimeInForce`	`string`	有效期
`Quantity`	`int64`	数量

AlgoParams 字段

字段	类型	说明
`AlgoStrategy`	`string`	算法策略
`StartTime`	`string`	算法订单开始时间
`EndTime`	`string`	算法订单结束时间
`ParticipationRate`	`float64`	参与率

示例

result, err := tc.GetOrder(model.GetOrderRequest{
	Account: "U123456",
	Id: 123456789,
	Lang: "en_US",
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

{
    "id": 123456789,
    "orderId": 123456789,
    "symbol": "AAPL",
    "secType": "STK",
    "market": "US",
    "action": "BUY",
    "orderType": "LMT",
    "limitPrice": 310.00,
    "totalQuantity": 100,
    "filledQuantity": 100,
    "avgFillPrice": 309.85,
    "status": "Filled",
    "account": "12345678",
    "currency": "USD",
    "openTime": 1785504600000,
    "updateTime": 1785505200000
  }

调用频率

基础限流为 120 次/分钟。Orders 与 GetOrder 均使用 orders，共享此额度。

获取待成交订单

功能说明

查询待成交订单。支持按 ParentId 过滤附加订单。 方法签名

func (c *TradeClient) ActiveOrders(req model.OrdersRequest) ([]model.Order, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.OrdersRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`Symbol`	`string`	否	空值省略	标的代码
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`SegType`	`string`	否	空值省略	无；可选值：ALL, SEC, FUT, FUND
`StartDate`	`int64`	否	空值省略	无；ms 时间戳
`EndDate`	`int64`	否	零值省略	查询结束时间，毫秒时间戳
`States`	`[]string`	否	空值省略	无；OrderStatus 值列表
`SortBy`	`string`	否	空值省略	无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
`ShowCharges`	`*bool`	否	`nil` 时省略	是否请求费用明细；指针可区分显式 `false` 与省略
`IsBrief`	`bool`	否	`false` 时省略	是否返回精简订单信息
`Limit`	`int`	否	零值省略	返回数量；省略时服务端使用 100，最大 300
`ParentId`	`int64`	否	零值省略	父订单 ID；可用于筛选附加订单
`PageToken`	`string`	否	空值省略	分页游标
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.Order, error)。关键字段来自 model.Order：

字段	类型	说明
Account	string	账户 ID
ID	int64	订单 ID
OrderId	int64	订单号
Action	string	交易方向 (BUY/SELL)
OrderType	string	订单类型
TotalQuantity	int64	委托数量
LimitPrice	float64	限价
AuxPrice	float64	辅助价格（止损价）
TrailingPercent	float64	跟踪止损百分比
Status	string	订单状态
FilledQuantity	int64	成交数量
AvgFillPrice	float64	成交均价
TimeInForce	string	有效期
OutsideRth	bool	是否允许盘前盘后
OrderLegs	[]OrderLeg	附加订单
AlgoParams	*AlgoParams	算法参数
Symbol	string	标的代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Expiry	string	到期日
Strike	string	行权价
Right	string	期权方向
Identifier	string	合约标识符
Name	string	合约名称
Commission	float64	佣金
RealizedPnl	float64	已实现盈亏
OpenTime	int64	开仓时间，毫秒时间戳
UpdateTime	int64	更新时间，毫秒时间戳
LatestTime	int64	最新时间，毫秒时间戳
Remark	string	备注
Source	string	订单来源
UserMark	string	用户标记
ExternalId	string	外部 ID
TotalQuantityScale	int	委托数量精度
FilledQuantityScale	int	成交数量精度
FilledCashAmount	float64	成交现金金额
Gst	float64	GST
Liquidation	bool	是否为强平订单
AttrDesc	string	属性说明
AttrList	[]string	属性列表
AlgoStrategy	string	算法策略
Discount	float64	折扣
ReplaceStatus	string	改单状态
CancelStatus	string	撤单状态
CanModify	bool	是否可修改
CanCancel	bool	是否可撤销
IsOpen	bool	是否为未完成订单
OrderDiscount	float64	订单折扣
TradingSessionType	string	交易时段类型
LatestPrice	float64	最新价
DisplaySize	int64	冰山单展示数量
MinDisplaySize	int64	冰山单最小展示数量
CheckIntervals	int64	冰山单价检间隔，秒
PriceType	string	冰山单价格类型
StartTime	int64	生效开始时间，毫秒时间戳
EndTime	int64	生效结束时间，毫秒时间戳

OrderLeg 字段

字段	类型	说明
`LegType`	`string`	附加订单类型
`Price`	`float64`	价格
`TimeInForce`	`string`	有效期
`Quantity`	`int64`	数量

AlgoParams 字段

字段	类型	说明
`AlgoStrategy`	`string`	算法策略
`StartTime`	`string`	算法订单开始时间
`EndTime`	`string`	算法订单结束时间
`ParticipationRate`	`float64`	参与率

示例

result, err := tc.ActiveOrders(model.OrdersRequest{
	Account: "U123456",
	Market: "US",
	SecType: "STK",
	Symbol: "AAPL",
	StartDate: 1,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "id": 123456790,
    "orderId": 123456790,
    "symbol": "TSLA",
    "secType": "STK",
    "market": "US",
    "action": "BUY",
    "orderType": "LMT",
    "limitPrice": 280.00,
    "totalQuantity": 50,
    "filledQuantity": 0,
    "status": "Submitted",
    "account": "12345678",
    "currency": "USD",
    "openTime": 1785504600000
  }
]

调用频率

基础限流为 120 次/分钟。

获取已撤销订单

功能说明

查询已撤销订单。 方法签名

func (c *TradeClient) InactiveOrders(req model.OrdersRequest) ([]model.Order, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.OrdersRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`Symbol`	`string`	否	空值省略	标的代码
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`SegType`	`string`	否	空值省略	无；可选值：ALL, SEC, FUT, FUND
`StartDate`	`int64`	否	空值省略	无；ms 时间戳
`EndDate`	`int64`	否	零值省略	查询结束时间，毫秒时间戳
`States`	`[]string`	否	空值省略	无；OrderStatus 值列表
`SortBy`	`string`	否	空值省略	无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
`ShowCharges`	`*bool`	否	`nil` 时省略	是否请求费用明细；指针可区分显式 `false` 与省略
`IsBrief`	`bool`	否	`false` 时省略	是否返回精简订单信息
`Limit`	`int`	否	零值省略	返回数量；省略时服务端使用 100，最大 300
`ParentId`	`int64`	否	零值省略	父订单 ID
`PageToken`	`string`	否	空值省略	分页游标
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.Order, error)。关键字段来自 model.Order：

字段	类型	说明
Account	string	账户 ID
ID	int64	订单 ID
OrderId	int64	订单号
Action	string	交易方向 (BUY/SELL)
OrderType	string	订单类型
TotalQuantity	int64	委托数量
LimitPrice	float64	限价
AuxPrice	float64	辅助价格（止损价）
TrailingPercent	float64	跟踪止损百分比
Status	string	订单状态
FilledQuantity	int64	成交数量
AvgFillPrice	float64	成交均价
TimeInForce	string	有效期
OutsideRth	bool	是否允许盘前盘后
OrderLegs	[]OrderLeg	附加订单
AlgoParams	*AlgoParams	算法参数
Symbol	string	标的代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Expiry	string	到期日
Strike	string	行权价
Right	string	期权方向
Identifier	string	合约标识符
Name	string	合约名称
Commission	float64	佣金
RealizedPnl	float64	已实现盈亏
OpenTime	int64	开仓时间，毫秒时间戳
UpdateTime	int64	更新时间，毫秒时间戳
LatestTime	int64	最新时间，毫秒时间戳
Remark	string	备注
Source	string	订单来源
UserMark	string	用户标记
ExternalId	string	外部 ID
TotalQuantityScale	int	委托数量精度
FilledQuantityScale	int	成交数量精度
FilledCashAmount	float64	成交现金金额
Gst	float64	GST
Liquidation	bool	是否为强平订单
AttrDesc	string	属性说明
AttrList	[]string	属性列表
AlgoStrategy	string	算法策略
Discount	float64	折扣
ReplaceStatus	string	改单状态
CancelStatus	string	撤单状态
CanModify	bool	是否可修改
CanCancel	bool	是否可撤销
IsOpen	bool	是否为未完成订单
OrderDiscount	float64	订单折扣
TradingSessionType	string	交易时段类型
LatestPrice	float64	最新价
DisplaySize	int64	冰山单展示数量
MinDisplaySize	int64	冰山单最小展示数量
CheckIntervals	int64	冰山单价检间隔，秒
PriceType	string	冰山单价格类型
StartTime	int64	生效开始时间，毫秒时间戳
EndTime	int64	生效结束时间，毫秒时间戳

OrderLeg 字段

字段	类型	说明
`LegType`	`string`	附加订单类型
`Price`	`float64`	价格
`TimeInForce`	`string`	有效期
`Quantity`	`int64`	数量

AlgoParams 字段

字段	类型	说明
`AlgoStrategy`	`string`	算法策略
`StartTime`	`string`	算法订单开始时间
`EndTime`	`string`	算法订单结束时间
`ParticipationRate`	`float64`	参与率

示例

result, err := tc.InactiveOrders(model.OrdersRequest{
	Account: "U123456",
	Market: "US",
	SecType: "STK",
	Symbol: "AAPL",
	StartDate: 1,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "id": 123456789,
    "orderId": 123456789,
    "symbol": "AAPL",
    "secType": "STK",
    "market": "US",
    "action": "BUY",
    "orderType": "LMT",
    "limitPrice": 310.00,
    "totalQuantity": 100,
    "filledQuantity": 100,
    "avgFillPrice": 309.85,
    "status": "Filled",
    "account": "12345678",
    "currency": "USD",
    "openTime": 1785504600000,
    "updateTime": 1785505200000
  }
]

调用频率

基础限流为 120 次/分钟。

获取已成交订单

功能说明

查询已成交订单。 方法签名

func (c *TradeClient) FilledOrders(req model.OrdersRequest) ([]model.Order, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.OrdersRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`Symbol`	`string`	否	空值省略	标的代码
`Market`	`string`	否	空值省略	无；可选值：ALL, US, HK, CN, SG
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`SegType`	`string`	否	空值省略	无；可选值：ALL, SEC, FUT, FUND
`StartDate`	`int64`	否	空值省略	无；ms 时间戳
`EndDate`	`int64`	否	零值省略	查询结束时间，毫秒时间戳
`States`	`[]string`	否	空值省略	无；OrderStatus 值列表
`SortBy`	`string`	否	空值省略	无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
`ShowCharges`	`*bool`	否	`nil` 时省略	是否请求费用明细；指针可区分显式 `false` 与省略
`IsBrief`	`bool`	否	`false` 时省略	是否返回精简订单信息
`Limit`	`int`	否	零值省略	返回数量；省略时服务端使用 100，最大 300
`ParentId`	`int64`	否	零值省略	父订单 ID
`PageToken`	`string`	否	空值省略	分页游标
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.Order, error)。关键字段来自 model.Order：

字段	类型	说明
Account	string	账户 ID
ID	int64	订单 ID
OrderId	int64	订单号
Action	string	交易方向 (BUY/SELL)
OrderType	string	订单类型
TotalQuantity	int64	委托数量
LimitPrice	float64	限价
AuxPrice	float64	辅助价格（止损价）
TrailingPercent	float64	跟踪止损百分比
Status	string	订单状态
FilledQuantity	int64	成交数量
AvgFillPrice	float64	成交均价
TimeInForce	string	有效期
OutsideRth	bool	是否允许盘前盘后
OrderLegs	[]OrderLeg	附加订单；字段见本页 `Orders` 返回表
AlgoParams	*AlgoParams	算法参数；字段见本页 `Orders` 返回表
Symbol	string	标的代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Expiry	string	到期日
Strike	string	行权价
Right	string	期权方向
Identifier	string	合约标识符
Name	string	合约名称
Commission	float64	佣金
RealizedPnl	float64	已实现盈亏
OpenTime	int64	开仓时间，毫秒时间戳
UpdateTime	int64	更新时间，毫秒时间戳
LatestTime	int64	最新时间，毫秒时间戳
Remark	string	备注
Source	string	订单来源
UserMark	string	用户标记
ExternalId	string	外部 ID
TotalQuantityScale	int	委托数量精度
FilledQuantityScale	int	成交数量精度
FilledCashAmount	float64	成交现金金额
Gst	float64	GST
Liquidation	bool	是否为强平订单
AttrDesc	string	属性说明
AttrList	[]string	属性列表
AlgoStrategy	string	算法策略
Discount	float64	折扣
ReplaceStatus	string	改单状态
CancelStatus	string	撤单状态
CanModify	bool	是否可修改
CanCancel	bool	是否可撤销
IsOpen	bool	是否为未完成订单
OrderDiscount	float64	订单折扣
TradingSessionType	string	交易时段类型
LatestPrice	float64	最新价
DisplaySize	int64	冰山单展示数量
MinDisplaySize	int64	冰山单最小展示数量
CheckIntervals	int64	冰山单价检间隔，秒
PriceType	string	冰山单价格类型
StartTime	int64	生效开始时间，毫秒时间戳
EndTime	int64	生效结束时间，毫秒时间戳

OrderLeg 字段

字段	类型	说明
`LegType`	`string`	附加订单类型
`Price`	`float64`	价格
`TimeInForce`	`string`	有效期
`Quantity`	`int64`	数量

AlgoParams 字段

字段	类型	说明
`AlgoStrategy`	`string`	算法策略
`StartTime`	`string`	算法订单开始时间
`EndTime`	`string`	算法订单结束时间
`ParticipationRate`	`float64`	参与率

示例

result, err := tc.FilledOrders(model.OrdersRequest{
	Account: "U123456",
	Market: "US",
	SecType: "STK",
	Symbol: "AAPL",
	StartDate: 1,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "id": 123456789,
    "orderId": 123456789,
    "symbol": "AAPL",
    "secType": "STK",
    "market": "US",
    "action": "BUY",
    "orderType": "LMT",
    "limitPrice": 310.00,
    "totalQuantity": 100,
    "filledQuantity": 100,
    "avgFillPrice": 309.85,
    "status": "Filled",
    "account": "12345678",
    "currency": "USD",
    "openTime": 1785504600000,
    "updateTime": 1785505200000
  }
]

调用频率

基础限流为 120 次/分钟。

获取成交记录

功能说明

查询订单成交明细。所有过滤字段（Symbol / SecType / OrderId / 时间范围等）均可选。 方法签名

func (c *TradeClient) OrderTransactions(req model.OrderTransactionsRequest) ([]model.Transaction, error)

需要配置中可访问的交易账户。机构账户可通过 SecretKey 鉴权。

参数

model.OrderTransactionsRequest

参数	类型	必填	默认值	说明
`Account`	`string`	否	空值时使用客户端默认账户	交易账户 ID
`SecretKey`	`string`	否	`Account` 与 `SecretKey` 均为空时使用客户端配置；其他情况下为空则省略	机构账户鉴权密钥
`OrderId`	`int64`	否	零值省略	账户维度订单 ID
`Symbol`	`string`	否	空值省略	标的代码
`SecType`	`string`	否	空值省略	无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
`StartDate`	`int64`	否	空值省略	无；ms 时间戳
`EndDate`	`int64`	否	零值省略	查询结束时间，毫秒时间戳
`SinceDate`	`string`	否	空值省略	无；yyyyMMdd
`ToDate`	`string`	否	空值省略	查询结束日期，`yyyyMMdd`
`Expiry`	`string`	否	空值省略	到期日
`Strike`	`float64`	否	零值省略	行权价
`Right`	`string`	否	空值省略	无；可选值：PUT, CALL (option side); br, nr when used as quote adjustment
`Limit`	`int`	否	零值省略	返回数量
`PageToken`	`string`	否	空值省略	分页游标
`Lang`	`string`	否	空值省略	无；可选值：zh_CN, zh_TW, en_US

([]model.Transaction, error)。关键字段来自 model.Transaction：

字段	类型	说明
ID	int64	成交记录 ID
OrderID	int64	订单 ID
AccountId	int64	账户数字 ID
Account	string	账户 ID
Symbol	string	股票代码
SecType	string	证券类型
Market	string	市场
Currency	string	币种
Identifier	string	标识符
Action	string	交易方向 (BUY/SELL)
Price	float64	委托价格
FilledPrice	float64	成交价格
Quantity	int64	委托数量
FilledQuantity	int64	成交数量
FilledQuantityScale	int	成交数量精度
Amount	float64	委托金额
FilledAmount	float64	成交金额
Commission	float64	佣金
TransactedAt	string	成交时间，`YYYY-MM-DD HH:MM:SS`
TransactionTime	int64	成交时间，毫秒时间戳
Time	int64	兼容时间字段

当前 API 响应可能不会填充 Time。

示例

result, err := tc.OrderTransactions(model.OrderTransactionsRequest{
	Account: "U123456",
	Symbol: "AAPL",
	SecType: "STK",
	StartDate: 1,
	EndDate: 1,
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%#v\n", result)

返回示例

[
  {
    "id": 987654321,
    "orderId": 123456789,
    "symbol": "AAPL",
    "secType": "STK",
    "action": "BUY",
    "filledQuantity": 100,
    "filledPrice": 309.85,
    "filledAmount": 30985.00,
    "transactionTime": 1785505200000,
    "account": "12345678",
    "currency": "USD"
  }
]

调用频率

基础限流为 60 次/分钟。