Docs
English

订单查询

获取订单列表

功能说明

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

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

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

参数

model.OrdersRequest

参数类型必填默认值说明
Marketstring否空值省略无；可选值：ALL, US, HK, CN, SG
SecTypestring否空值省略无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
SegTypestring否空值省略无；可选值：ALL, SEC, FUT, FUND
StartDateint64否空值省略无；ms 时间戳
States[]string否空值省略无；OrderStatus 值列表
SortBystring否空值省略无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
ShowCharges*bool否空值省略无；Python 用 is not None 判断
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
Accountstring账户 ID
IDint64订单 ID
OrderIdint64订单号
Actionstring交易方向 (BUY/SELL)
OrderTypestring订单类型
TotalQuantityint64委托数量
LimitPricefloat64限价
AuxPricefloat64辅助价格（止损价）
TrailingPercentfloat64跟踪止损百分比
Statusstring订单状态
FilledQuantityint64成交数量
AvgFillPricefloat64成交均价
TimeInForcestring有效期
OutsideRthbool是否允许盘前盘后

示例

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
  }
]

获取订单详情

功能说明

按订单 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

参数类型必填默认值说明
Idint64否空值省略无；全局订单 ID
OrderIdint64否空值省略无；账户维度订单 ID
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
Accountstring账户 ID
IDint64订单 ID
OrderIdint64订单号
Actionstring交易方向 (BUY/SELL)
OrderTypestring订单类型
TotalQuantityint64委托数量
LimitPricefloat64限价
AuxPricefloat64辅助价格（止损价）
TrailingPercentfloat64跟踪止损百分比
Statusstring订单状态
FilledQuantityint64成交数量
AvgFillPricefloat64成交均价
TimeInForcestring有效期
OutsideRthbool是否允许盘前盘后

示例

result, err := tc.GetOrder(model.GetOrderRequest{
	Account: "U123456",
	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
  }

获取待成交订单

功能说明

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

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

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

参数

model.OrdersRequest

参数类型必填默认值说明
Marketstring否空值省略无；可选值：ALL, US, HK, CN, SG
SecTypestring否空值省略无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
SegTypestring否空值省略无；可选值：ALL, SEC, FUT, FUND
StartDateint64否空值省略无；ms 时间戳
States[]string否空值省略无；OrderStatus 值列表
SortBystring否空值省略无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
ShowCharges*bool否空值省略无；Python 用 is not None 判断
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
Accountstring账户 ID
IDint64订单 ID
OrderIdint64订单号
Actionstring交易方向 (BUY/SELL)
OrderTypestring订单类型
TotalQuantityint64委托数量
LimitPricefloat64限价
AuxPricefloat64辅助价格（止损价）
TrailingPercentfloat64跟踪止损百分比
Statusstring订单状态
FilledQuantityint64成交数量
AvgFillPricefloat64成交均价
TimeInForcestring有效期
OutsideRthbool是否允许盘前盘后

示例

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
  }
]

获取已撤销订单

功能说明

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

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

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

参数

model.OrdersRequest

参数类型必填默认值说明
Marketstring否空值省略无；可选值：ALL, US, HK, CN, SG
SecTypestring否空值省略无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
SegTypestring否空值省略无；可选值：ALL, SEC, FUT, FUND
StartDateint64否空值省略无；ms 时间戳
States[]string否空值省略无；OrderStatus 值列表
SortBystring否空值省略无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
ShowCharges*bool否空值省略无；Python 用 is not None 判断
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
Accountstring账户 ID
IDint64订单 ID
OrderIdint64订单号
Actionstring交易方向 (BUY/SELL)
OrderTypestring订单类型
TotalQuantityint64委托数量
LimitPricefloat64限价
AuxPricefloat64辅助价格（止损价）
TrailingPercentfloat64跟踪止损百分比
Statusstring订单状态
FilledQuantityint64成交数量
AvgFillPricefloat64成交均价
TimeInForcestring有效期
OutsideRthbool是否允许盘前盘后

示例

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
  }
]

获取已成交订单

功能说明

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

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

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

参数

model.OrdersRequest

参数类型必填默认值说明
Marketstring否空值省略无；可选值：ALL, US, HK, CN, SG
SecTypestring否空值省略无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
SegTypestring否空值省略无；可选值：ALL, SEC, FUT, FUND
StartDateint64否空值省略无；ms 时间戳
States[]string否空值省略无；OrderStatus 值列表
SortBystring否空值省略无；可选值：LATEST_CREATED, LATEST_STATUS_UPDATED
ShowCharges*bool否空值省略无；Python 用 is not None 判断
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
Accountstring账户 ID
IDint64订单 ID
OrderIdint64订单号
Actionstring交易方向 (BUY/SELL)
OrderTypestring订单类型
TotalQuantityint64委托数量
LimitPricefloat64限价
AuxPricefloat64辅助价格（止损价）
TrailingPercentfloat64跟踪止损百分比
Statusstring订单状态
FilledQuantityint64成交数量
AvgFillPricefloat64成交均价
TimeInForcestring有效期
OutsideRthbool是否允许盘前盘后

示例

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
  }
]

获取成交记录

功能说明

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

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

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

参数

model.OrderTransactionsRequest

参数类型必填默认值说明
SecTypestring否空值省略无；可选值：ALL, STK, OPT, WAR, IOPT, FUT, FOP, CASH, MLEG, FUND
StartDateint64否空值省略无；ms 时间戳
SinceDatestring否空值省略无；yyyyMMdd
Rightstring否空值省略无；可选值：PUT, CALL (option side); br, nr when used as quote adjustment
Langstring否空值省略无；可选值：zh_CN, zh_TW, en_US

返回

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

字段类型说明
IDint64成交记录 ID
OrderIDint64订单 ID
AccountIdint64账户数字 ID
Accountstring账户 ID
Symbolstring股票代码
SecTypestring证券类型
Marketstring市场
Currencystring币种
Identifierstring标识符
Actionstring交易方向 (BUY/SELL)
Pricefloat64委托价格
FilledPricefloat64成交价格
Quantityint64委托数量
FilledQuantityint64成交数量

示例

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"
  }
]

Updated 8 days ago

Did this page help you?