输入/搜索内容
内置函数
Global
Log
Market
Trade
Account
Futures
Exchange
IO
Network
Storage
Threads
TA
Talib
OS
结构体
内置变量与常量
通用约定
交易所

获取当前未完成的订单。


    
    
    
exchange.GetOrders()

    
    
    
exchange.GetOrders(symbol)

示例

  • 查询未完成订单（不传参数时按默认范围）并逐条打印。

    
    javascript
    
    
    function main() {
    var orders = exchange.GetOrders()
    if (!orders) return    // 获取失败时为null，没有挂单时为空数组
    Log("未完成订单数", orders.length)
    for (var o of orders) {
        Log(o.Symbol, o.Id, "价格", o.Price, "数量", o.Amount, "已成交", o.DealAmount)
    }
}
    
    python
    
    
    def main():
    orders = exchange.GetOrders()
    if orders is None:
        return
    Log("未完成订单数", len(orders))
    for o in orders:
        Log(o["Symbol"], o["Id"], "价格", o["Price"], "数量", o["Amount"], "已成交", o["DealAmount"])
    
    rust
    
    
    fn main() {
    let Ok(orders) = exchange.GetOrders(None) else { return };
    Log!("未完成订单数", orders.len());
    for o in &orders {
        Log!(o.Symbol, o.Id, "价格", o.Price, "数量", o.Amount, "已成交", o.DealAmount);
    }
}

  • 使用现货交易所对象，针对多个不同的交易对，以当前价格的一半作为下单价格挂出买单，随后查询未成交订单的信息。

    
    javascript
    
    
    /*backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/

function main() {
    var arrSymbol = ["ETH_USDT", "BTC_USDT", "LTC_USDT", "SOL_USDT"]

    for (var symbol of arrSymbol) {
        var t = exchange.GetTicker(symbol)
        exchange.CreateOrder(symbol, "buy", t.Last / 2, 0.01)
    }

    var spotOrders = exchange.GetOrders()

    var tbls = []
    for (var orders of [spotOrders]) {
        var tbl = {type: "table", title: "test GetOrders", cols: ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], rows: []}
        for (var order of orders) {
            tbl.rows.push([order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType])
        }
        tbls.push(tbl)
    }

    LogStatus("`" + JSON.stringify(tbls) +  "`")

    // 打印输出一次信息后返回，防止后续回测时订单成交，影响数据观察
    return
}
    
    python
    
    
    '''backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
'''

import json

def main():
    arrSymbol = ["ETH_USDT", "BTC_USDT", "LTC_USDT", "SOL_USDT"]

    for symbol in arrSymbol:
        t = exchange.GetTicker(symbol)
        exchange.CreateOrder(symbol, "buy", t["Last"] / 2, 0.01)

    spotOrders = exchange.GetOrders()

    tbls = []
    for orders in [spotOrders]:
        tbl = {"type": "table", "title": "test GetOrders", "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], "rows": []}
        for order in orders:
            tbl["rows"].append([order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType])
        tbls.append(tbl)

    LogStatus("`" + json.dumps(tbls) +  "`")

    return
    
    rust
    
    
    /*backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Binance","currency":"BTC_USDT"}]
*/

fn main() {
    let arrSymbol = ["ETH_USDT", "BTC_USDT", "LTC_USDT", "SOL_USDT"];

    for symbol in arrSymbol {
        let t = exchange.GetTicker(symbol).unwrap();
        let _ = exchange.CreateOrder(symbol, "buy", t.Last / 2.0, 0.01);
    }

    let spotOrders = exchange.GetOrders(None).unwrap();

    // Rust不支持JSON.stringify，使用format!拼接表格的JSON文本
    let mut tbls = Vec::new();
    for orders in [&spotOrders] {
        let mut rows = Vec::new();
        for order in orders {
            rows.push(format!(r#"["{}", "{}", {}, {}, {}, {}, {}, {}, {}, "{}"]"#,
                order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType));
        }
        let tbl = format!(r#"{{"type": "table", "title": "test GetOrders", "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], "rows": [{}]}}"#,
            rows.join(","));
        tbls.push(tbl);
    }

    LogStatus!(format!("`[{}]`", tbls.join(",")));

    // 打印输出一次信息后返回，防止后续回测时订单成交，影响数据观察
    return;
}

  • 使用期货交易所对象，对多个不同交易对、不同合约代码的品种进行下单。下单价格远离盘口对手价，使订单保持未成交状态，并按多种方式查询订单。

    
    javascript
    
    
    /*backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Futures_Binance","currency":"BTC_USDT"}]
*/

function main() {
    var arrSymbol = ["BTC_USDT.swap", "BTC_USDT.quarter", "ETH_USDT.swap", "ETH_USDT.quarter"]

    for (var symbol of arrSymbol) {
        var t = exchange.GetTicker(symbol)
        exchange.CreateOrder(symbol, "buy", t.Last / 2, 1)
        exchange.CreateOrder(symbol, "sell", t.Last * 2, 1)
    }

    var defaultOrders = exchange.GetOrders()
    var swapOrders = exchange.GetOrders("USDT.swap")
    var futuresOrders = exchange.GetOrders("USDT.futures")
    var btcUsdtSwapOrders = exchange.GetOrders("BTC_USDT.swap")

    var tbls = []
    var arr = [defaultOrders, swapOrders, futuresOrders, btcUsdtSwapOrders]
    var tblDesc = ["defaultOrders", "swapOrders", "futuresOrders", "btcUsdtSwapOrders"]
    for (var index in arr) {
        var orders = arr[index]
        var tbl = {type: "table", title: tblDesc[index], cols: ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], rows: []}
        for (var order of orders) {
            tbl.rows.push([order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType])
        }
        tbls.push(tbl)
    }

    LogStatus("`" + JSON.stringify(tbls) +  "`")

    // 打印输出一次信息后立即返回，防止后续回测过程中订单成交而影响数据观察
    return
}
    
    python
    
    
    '''backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Futures_Binance","currency":"BTC_USDT"}]
'''

import json

def main():
    arrSymbol = ["BTC_USDT.swap", "BTC_USDT.quarter", "ETH_USDT.swap", "ETH_USDT.quarter"]

    for symbol in arrSymbol:
        t = exchange.GetTicker(symbol)
        exchange.CreateOrder(symbol, "buy", t["Last"] / 2, 1)
        exchange.CreateOrder(symbol, "sell", t["Last"] * 2, 1)

    defaultOrders = exchange.GetOrders()
    swapOrders = exchange.GetOrders("USDT.swap")
    futuresOrders = exchange.GetOrders("USDT.futures")
    btcUsdtSwapOrders = exchange.GetOrders("BTC_USDT.swap")

    tbls = []
    arr = [defaultOrders, swapOrders, futuresOrders, btcUsdtSwapOrders]
    tblDesc = ["defaultOrders", "swapOrders", "futuresOrders", "btcUsdtSwapOrders"]
    for index in range(len(arr)):
        orders = arr[index]
        tbl = {"type": "table", "title": tblDesc[index], "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], "rows": []}
        for order in orders:
            tbl["rows"].append([order["Symbol"], order["Id"], order["Price"], order["Amount"], order["DealAmount"], order["AvgPrice"], order["Status"], order["Type"], order["Offset"], order["ContractType"]])
        tbls.append(tbl)

    LogStatus("`" + json.dumps(tbls) +  "`")

    return
    
    rust
    
    
    /*backtest
start: 2024-05-21 00:00:00
end: 2024-09-05 00:00:00
period: 5m
basePeriod: 1m
exchanges: [{"eid":"Futures_Binance","currency":"BTC_USDT"}]
*/

fn main() {
    let arrSymbol = ["BTC_USDT.swap", "BTC_USDT.quarter", "ETH_USDT.swap", "ETH_USDT.quarter"];

    for symbol in arrSymbol {
        let t = exchange.GetTicker(symbol).unwrap();
        let _ = exchange.CreateOrder(symbol, "buy", t.Last / 2.0, 1);
        let _ = exchange.CreateOrder(symbol, "sell", t.Last * 2.0, 1);
    }

    let defaultOrders = exchange.GetOrders(None).unwrap();
    let swapOrders = exchange.GetOrders("USDT.swap").unwrap();
    let futuresOrders = exchange.GetOrders("USDT.futures").unwrap();
    let btcUsdtSwapOrders = exchange.GetOrders("BTC_USDT.swap").unwrap();

    // Rust 不支持 JSON.stringify，此处使用 format! 拼接表格的 JSON 文本
    let mut tbls = Vec::new();
    let arr = [&defaultOrders, &swapOrders, &futuresOrders, &btcUsdtSwapOrders];
    let tblDesc = ["defaultOrders", "swapOrders", "futuresOrders", "btcUsdtSwapOrders"];
    for index in 0..arr.len() {
        let orders = arr[index];
        let mut rows = Vec::new();
        for order in orders {
            rows.push(format!(r#"["{}", "{}", {}, {}, {}, {}, {}, {}, {}, "{}"]"#,
                order.Symbol, order.Id, order.Price, order.Amount, order.DealAmount, order.AvgPrice, order.Status, order.Type, order.Offset, order.ContractType));
        }
        let tbl = format!(r#"{{"type": "table", "title": "{}", "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"], "rows": [{}]}}"#,
            tblDesc[index], rows.join(","));
        tbls.push(tbl);
    }

    LogStatus!(format!("`[{}]`", tbls.join(",")));

    // 打印输出一次信息后立即返回，防止后续回测过程中订单成交而影响数据观察
    return;
}

  • 调用exchange.GetOrders()函数时，可传入Symbol参数以指定请求特定交易对或合约代码的订单数据。

    
    javascript
    
    
    function main() {
    var orders = exchange.GetOrders("BTC_USDT")           // 现货品种示例
    // var orders = exchange.GetOrders("BTC_USDT.swap")   // 期货品种示例
    Log("orders:", orders)
}
    
    python
    
    
    def main():
    orders = exchange.GetOrders("BTC_USDT")          # 现货品种示例
    # orders = exchange.GetOrders("BTC_USDT.swap")   # 期货品种示例
    Log("orders:", orders)
    
    rust
    
    
    fn main() {
    let orders = exchange.GetOrders("BTC_USDT");           // 现货品种示例
    // let orders = exchange.GetOrders("BTC_USDT.swap");   // 期货品种示例
    Log!("orders:", orders);
}

返回值

类型描述

Order数组 / 空值

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

参数

名称类型必填描述

symbol

string

否

要查询的品种（例如BTC_USDT.swap）或品种范围（例如USDT.swap）。不传或传空字符串时，现货交易所对象查询全部品种，期货交易所对象查询当前计价币种与合约类型的范围（例如当前品种为BTC_USDT.swap时即USDT.swap）。范围写法与缺省范围的完整规则见品种代码。

参考

Order exchange.GetOrder exchange.GetHistoryOrders

备注

范围写法（USDT.swap、USD.futures、USDT.option等）与不传symbol时的缺省范围见品种代码；交易所接口不支持的范围会报错并返回空值。

当交易所对象exchange所代表的账户在查询范围内或指定的交易品种上没有挂单（即处于未成交状态的活动订单）时，调用该函数将返回空数组，即：[]。

少数交易所查询未完成订单的接口必须指定品种：在这些交易所上不传symbol时只查询当前品种的未完成订单，而不是整个范围。哪些交易所属于这种情况见各交易所页的注意事项（所有交易所的入口见能力矩阵）。

不支持的交易所：OKX_DEX、Web3。调用时报错并返回空值，所有交易所的对照见能力矩阵。