语法指南 | 发明者量化

exchange.GetHistoryOrders()函数用于获取当前交易对、合约的历史订单，并支持指定具体的交易品种。


    
    
    
exchange.GetHistoryOrders()


    
    
    
exchange.GetHistoryOrders(symbol)


    
    
    
exchange.GetHistoryOrders(symbol, since)


    
    
    
exchange.GetHistoryOrders(symbol, since, limit)


    
    
    
exchange.GetHistoryOrders(since)


    
    
    
exchange.GetHistoryOrders(since, limit)

示例


    javascript
    
    
function main() {
    var historyOrders = exchange.GetHistoryOrders()
    Log(historyOrders)
}


    python
    
    
def main():
    historyOrders = exchange.GetHistoryOrders()
    Log(historyOrders)


    rust
    
    
fn main() {
    let historyOrders = exchange.GetHistoryOrders(None, None, None);
    Log!(historyOrders);
}


    c++
    
    
void main() {
    auto historyOrders = exchange.GetHistoryOrders();
    Log(historyOrders);
}

返回值

类型	描述
`Order`数组 / 空值	`exchange.GetHistoryOrders()`函数在请求数据成功时返回`Order`结构数组，请求数据失败时返回空值。

参数

名称	类型	必填	描述
symbol	string	否	`symbol`参数用于指定交易品种。以`BTC_USDT`交易对为例：当`exchange`为现货交易所对象时，`symbol`参数格式为`BTC_USDT`；当`exchange`为期货交易所对象时，以永续合约为例，`symbol`参数格式为`BTC_USDT.swap`。如果查询的是期权合约的订单数据，参数`symbol`需设置为`"BTC_USDT.BTC-240108-40000-C"`（以币安期权BTC-240108-40000-C为例），其格式为FMZ平台定义的交易对与交易所定义的具体期权合约代码的组合，两者之间以字符"."间隔。若不传该参数，则默认请求当前设置的交易对、合约代码的订单数据。
since	number	否	`since`参数用于指定查询的起始时间戳，单位为毫秒。
limit	number	否	`limit`参数用于指定查询的订单数量。

参考

备注

未指定symbol、since、limit参数时，默认查询当前交易对、合约的历史订单，即查询距当前时间最近的一定范围内的历史订单，具体查询范围取决于交易所接口的单次查询范围。
指定symbol参数时，查询所设置交易品种的历史订单。
指定since参数时，以since时间戳为起始时间，向当前时间方向查询。
指定limit参数时，查询到足够条数后返回。
该函数仅支持提供历史订单查询接口的交易所。

不支持exchange.GetHistoryOrders()函数的交易所：

函数名	不支持的现货交易所	不支持的期货交易所
GetHistoryOrders	Zaif / Upbit / Coincheck / Bitstamp / Bithumb / BitFlyer / BigONE	Futures_Bibox / Futures_ApolloX