exchange.GetHistoryConditionOrders()函数用于获取当前交易对、合约的历史条件单(包括已触发、已取消、已过期的条件单);支持指定具体交易品种。
exchange.GetHistoryConditionOrders()函数请求数据成功时返回{@struct/Order Order}结构数组,请求数据失败时返回空值。
返回的Order结构中包含{@struct/Condition Condition}字段,该字段包含条件单的详细配置信息(触发价格、执行价格、条件类型等)。 {@struct/Order Order}数组 / 空值
exchange.GetHistoryConditionOrders() exchange.GetHistoryConditionOrders(symbol) exchange.GetHistoryConditionOrders(symbol, since) exchange.GetHistoryConditionOrders(symbol, since, limit) exchange.GetHistoryConditionOrders(since) exchange.GetHistoryConditionOrders(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
”`javascript function main() { var historyConditionOrders = exchange.GetHistoryConditionOrders() Log(“Historical condition orders count:”, historyConditionOrders.length)
// 遍历显示,订单按Time属性升序排列
for (var i = 0; i < historyConditionOrders.length; i++) {
Log("Order", i+1, "Created at:", historyConditionOrders[i].Time,
"ID:", historyConditionOrders[i].Id,
"Status:", historyConditionOrders[i].Status)
}
}
python
def main():
historyConditionOrders = exchange.GetHistoryConditionOrders()
Log(“Historical condition orders count:”, len(historyConditionOrders))
# 遍历显示,订单按Time属性升序排列
for i in range(len(historyConditionOrders)):
Log("Order", i+1, "Created at:", historyConditionOrders[i]["Time"],
"ID:", historyConditionOrders[i]["Id"],
"Status:", historyConditionOrders[i]["Status"])```
”`cpp void main() { auto historyConditionOrders = exchange.GetHistoryConditionOrders(); Log(“Historical condition orders count:”, historyConditionOrders.size());
// 遍历显示,订单按Time属性升序排列
for (int i = 0; i < historyConditionOrders.size(); i++) {
Log("Order", i+1, "Created at:", historyConditionOrders[i].Time,
"ID:", historyConditionOrders[i].Id,
"Status:", historyConditionOrders[i].Status);
}
}
查询历史条件单,返回结果按时间升序排列。
javascript
function main() {
// 查询BTC_USDT交易对最近的10条历史条件单
var historyConditionOrders = exchange.GetHistoryConditionOrders(“BTC_USDT”, 0, 10)
Log(“BTC_USDT historical condition orders:”, historyConditionOrders)
}
python
def main():
# 查询BTC_USDT交易对最近的10条历史条件单
historyConditionOrders = exchange.GetHistoryConditionOrders(“BTC_USDT”, 0, 10)
Log(“BTC_USDT historical condition orders:”, historyConditionOrders)
cpp
void main() {
// 查询BTC_USDT交易对最近的10条历史条件单
auto historyConditionOrders = exchange.GetHistoryConditionOrders(“BTC_USDT”, 0, 10);
Log(“BTC_USDT historical condition orders:”, historyConditionOrders);
}
查询指定交易对的历史条件单,并限制查询数量。
javascript
function main() {
// 查询从指定时间戳开始的历史条件单
var startTime = new Date(“2024-01-01”).getTime()
var historyConditionOrders = exchange.GetHistoryConditionOrders(startTime, 50)
Log(“Historical condition orders since:”, historyConditionOrders)
}
python
def main():
# 查询从指定时间戳开始的历史条件单
import time
startTime = int(time.mktime(time.strptime(“2024-01-01”, “%Y-%m-%d”)) * 1000)
historyConditionOrders = exchange.GetHistoryConditionOrders(startTime, 50)
Log(“Historical condition orders since:”, historyConditionOrders)
cpp
void main() {
// 查询从指定时间戳开始的历史条件单
auto startTime = 1704067200000; // 2024-01-01的时间戳
auto historyConditionOrders = exchange.GetHistoryConditionOrders(startTime, 50);
Log(“Historical condition orders since:”, historyConditionOrders);
}“`
根据指定时间范围查询历史条件单。
不指定symbol、since、limit参数时,默认查询当前交易对、合约的历史条件单。查询距离当前时间最近的一定范围内的历史条件单,查询范围根据交易所接口单次查询范围而定。
指定symbol参数时,查询设置的交易品种的历史条件单。
指定since参数时,从since时间戳开始向当前时间方向查询。
指定limit参数时,查询到足够条数后返回。
该函数仅支持提供历史条件单查询接口的交易所。
历史条件单包括:已触发(转换为普通订单)、已取消、已过期等状态的条件单。
返回的历史条件单数组按订单创建时间(Time属性)递增排序,即时间最早的订单在数组前面,时间最晚的订单在数组后面。
条件单功能支持情况取决于具体交易所,部分交易所可能不支持条件单功能或历史条件单查询功能。
{@struct/Order Order}, {@fun/Trade/exchange.GetConditionOrder exchange.GetConditionOrder}, {@fun/Trade/exchange.GetConditionOrders exchange.GetConditionOrders}