语法指南 | 发明者量化

exchange.GetHistoryConditionOrders

获取当前交易对、合约的历史条件单（包括已触发、已取消、已过期的条件单），并支持指定具体的交易品种。


    
    
    
exchange.GetHistoryConditionOrders()


    
    
    
exchange.GetHistoryConditionOrders(symbol)


    
    
    
exchange.GetHistoryConditionOrders(symbol, since)


    
    
    
exchange.GetHistoryConditionOrders(symbol, since, limit)


    
    
    
exchange.GetHistoryConditionOrders(since)


    
    
    
exchange.GetHistoryConditionOrders(since, limit)

示例

查询历史条件单，返回的结果按时间升序排列。


    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"])


    rust
    
    
fn main() {
    let historyConditionOrders = exchange.GetHistoryConditionOrders(None, None, None).unwrap();
    Log!("Historical condition orders count:", historyConditionOrders.len());

    // 遍历并显示，订单按 Time 属性升序排列
    for i in 0..historyConditionOrders.len() {
        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)


    rust
    
    
fn main() {
    // 查询BTC_USDT交易对最近的10条历史条件单
    let 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)


    rust
    
    
fn main() {
    // 查询从指定时间戳开始的历史条件单
    let startTime: i64 = 1704067200000;  // 2024-01-01的时间戳
    // Rust中symbol参数传None表示当前交易对
    let historyConditionOrders = exchange.GetHistoryConditionOrders(None, startTime, 50);
    Log!("Historical condition orders since:", historyConditionOrders);
}

返回值

类型描述

Order数组 / 空值

成功时返回Order结构数组；失败时返回空值。

返回的Order结构中包含Condition字段，该字段包含条件单的详细配置信息（触发价格、执行价格、条件类型等）。

参数

名称	类型	必填	描述
symbol	string	否	品种代码，例如现货交易所对象上的`BTC_USDT`、期货交易所对象上的`BTC_USDT.swap`，写法（含期权）见`品种代码`。不传时查询当前交易对、合约代码的历史条件单。
since	number	否	查询的起始时间戳，单位为毫秒。
limit	number	否	查询的条件单数量。

参考

Order exchange.GetConditionOrder exchange.GetConditionOrders

备注

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

历史条件单包括：已触发（转为普通订单）、已取消、已过期等状态的条件单。

返回的历史条件单数组按订单创建时间（Time属性）升序排列，即时间最早的订单位于数组前面，时间最晚的订单位于数组后面。

对条件单功能的支持情况取决于具体的交易所，部分交易所可能不支持条件单功能或历史条件单查询功能。

不支持的交易所：Bithumb、Bitstamp、Coincheck、Coinone、Coinw、DigiFinex、Futures_DigiFinex、Gemini、HashKey、Korbit、LBank、MEXC、Upbit、WEEX、Zaif、Hyperliquid、Pendle、Uniswap、PancakeSwap、Aerodrome、Velodrome、KyberSwap、OneInch、Jupiter、OKX_DEX、Futures_Polymarket、Futures_IB、Exchange、Web3。调用时报错并返回空值，所有交易所的对照见能力矩阵。