Syntax

exchange.GetHistoryOrders

The exchange.GetHistoryOrders() function is used to get historical orders for the current trading pair or contract, and supports specifying specific trading instruments.


    
    
    
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)


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

Returns

Type	Description
`Order` array / null	The `exchange.GetHistoryOrders()` function returns an array of `Order` structures when the data request is successful, 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. Taking the `BTC_USDT` trading pair as an example, when `exchange` is a spot exchange object, the `symbol` parameter format is: `BTC_USDT`; if it is a futures exchange object, taking perpetual contracts as an example, the `symbol` parameter format is: `BTC_USDT.swap`. If querying option contract order data, set the `symbol` parameter to `"BTC_USDT.BTC-240108-40000-C"` (using Binance option BTC-240108-40000-C as an example), the format is a combination of the trading pair defined by the FMZ platform and the specific option contract code defined by the exchange, separated by the character ".". When this parameter is not passed, it defaults to requesting order data for the currently set trading pair and contract code.
since	number	No	The `since` parameter is used to specify the starting timestamp for the query, in milliseconds.
limit	number	No	The `limit` parameter is used to specify the number of orders to query.

Remarks

When symbol, since, and limit parameters are not specified, it defaults to querying historical orders for the current trading pair or contract. It queries historical orders within a certain range closest to the current time, with the query range determined by the single query range of the exchange API.
When the symbol parameter is specified, it queries historical orders for the specified trading instrument.
When the since parameter is specified, it queries from the since timestamp towards the current time.
When the limit parameter is specified, it returns after querying the sufficient number of entries.
This function only supports exchanges that provide historical order query interfaces.

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