Syntax

exchange.GetHistoryOrders

exchange.GetHistoryOrders() function is used to retrieve the historical orders of the current trading pair or contract, and supports specifying a particular trading instrument.


    
    
    
exchange.GetHistoryOrders()


    
    
    
exchange.GetHistoryOrders(symbol)


    
    
    
exchange.GetHistoryOrders(symbol, since)


    
    
    
exchange.GetHistoryOrders(symbol, since, limit)


    
    
    
exchange.GetHistoryOrders(since)


    
    
    
exchange.GetHistoryOrders(since, limit)

Examples


    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);
}

Returns

Type	Description
`Order` array / null	The `exchange.GetHistoryOrders()` function returns a `Order` structure array when the data request succeeds, and returns null when the data request fails.

Arguments

Name	Type	Required	Description
symbol	string	No	The `symbol` parameter is used to specify the trading instrument. Take the `BTC_USDT` trading pair as an example: when `exchange` is a spot exchange object, the `symbol` parameter format is `BTC_USDT`; when `exchange` is a futures exchange object, taking a perpetual contract as an example, the `symbol` parameter format is `BTC_USDT.swap`. If querying order data for an options contract, the `symbol` parameter should be set to `"BTC_USDT.BTC-240108-40000-C"` (taking the Binance option BTC-240108-40000-C as an example). Its format is a combination of the trading pair defined by the FMZ platform and the specific options contract code defined by the exchange, separated by the character ".". If this parameter is not passed, the order data for the currently set trading pair or contract code is requested by default.
since	number	No	The `since` parameter is used to specify the starting timestamp of the query, in milliseconds.
limit	number	No	The `limit` parameter is used to specify the number of orders to query.

Remarks

When the symbol, since, and limit parameters are not specified, the historical orders of the current trading pair or contract are queried by default, i.e., the historical orders within a certain range closest to the current time are queried. The specific query range depends on the single-query range of the exchange's interface.
When the symbol parameter is specified, the historical orders of the set trading instrument are queried.
When the since parameter is specified, the query starts from the since timestamp and proceeds toward the current time.
When the limit parameter is specified, the query returns once a sufficient number of records is reached.
This function is only supported by exchanges that provide a historical order query interface.

Exchanges that do not support the exchange.GetHistoryOrders() function:

Function Name	Unsupported Spot Exchanges	Unsupported Futures Exchanges
GetHistoryOrders	Zaif / Upbit / Coincheck / Bitstamp / Bithumb / BitFlyer / BigONE	Futures_Bibox / Futures_ApolloX