exchange.GetHistoryOrders()函数用于获取当前交易对、合约的历史订单,支持指定具体交易品种。
exchange.GetHistoryOrders()函数请求数据成功时返回{@struct/Order Order}结构数组,请求数据失败时返回空值。
{@struct/Order Order}数组 / 空值
exchange.GetHistoryOrders() exchange.GetHistoryOrders(symbol) exchange.GetHistoryOrders(symbol, since) exchange.GetHistoryOrders(symbol, since, limit) exchange.GetHistoryOrders(since) exchange.GetHistoryOrders(since, limit)
symbol参数用于指定交易品种。以BTC_USDT交易对为例,当exchange为现货交易所对象时,symbol参数格式为:BTC_USDT;如果是期货交易所对象,以永续合约为例,symbol参数格式为:BTC_USDT.swap。
如果查询期权合约的订单数据,参数symbol设置为"BTC_USDT.BTC-240108-40000-C"(以币安期权BTC-240108-40000-C为例),格式为FMZ平台定义的交易对与交易所定义的具体期权合约代码组合,以字符”.“间隔。不传该参数时默认请求当前设置的交易对、合约代码的订单数据。
symbol
false
string
since参数用于指定查询的起始时间戳,单位为毫秒。
since
false
number
limit参数用于指定查询的订单数量。
limit
false
number
function main() {
var historyOrders = exchange.GetHistoryOrders()
Log(historyOrders)
}
def main():
historyOrders = exchange.GetHistoryOrders()
Log(historyOrders)
void main() {
auto historyOrders = exchange.GetHistoryOrders();
Log(historyOrders);
}
不指定symbol、since、limit参数时,默认查询当前交易对、合约的历史订单。查询距离当前时间最近的一定范围内的历史订单,查询范围根据交易所接口单次查询范围而定。
指定symbol参数时,查询设置的交易品种的历史订单。
指定since参数时,以since时间戳为开始时间向当前时间方向查询。
指定limit参数时,查询足够条数后返回。
该函数仅支持提供历史订单查询接口的交易所。
不支持exchange.GetHistoryOrders()函数的交易所:
| 函数名 | 不支持的现货交易所 | 不支持的期货交易所 |
|---|---|---|
| GetHistoryOrders | Zaif / Upbit / Coincheck / Bitstamp / Bithumb / BitFlyer / BigONE | Futures_Bibox / Futures_ApolloX |
{@struct/Order Order}, {@fun/Trade/exchange.GetOrder exchange.GetOrder}, {@fun/Trade/exchange.GetOrders exchange.GetOrders}