exchange.GetOrders

The exchange.GetOrders() function is used to get unfilled orders.

    
    
    
exchange.GetOrders()

    
    
    
exchange.GetOrders(symbol)

Examples

• Using spot exchange objects to operate on multiple different trading pairs, placing buy orders at half the current price, then querying pending order information.

  • javascript
  • python
  • cpp

  
      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
  

  
      c++
      
      
  /*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"}]
  */
  
  void main() {
      auto arrSymbol = {"ETH_USDT", "BTC_USDT", "LTC_USDT", "SOL_USDT"};
  
      for (const auto& symbol : arrSymbol) {
          auto t = exchange.GetTicker(symbol);
          exchange.CreateOrder(symbol, "buy", t.Last / 2, 0.01);
      }
  
      auto spotOrders = exchange.GetOrders();
  
      json tbls = R"([])"_json;
      std::vector<std::vector<Order>> arr = {spotOrders};
      for (const auto& orders : arr) {
          json tbl = R"({
              "type": "table",
              "title": "test GetOrders",
              "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"],
              "rows": []
          })"_json;
  
          for (const auto& order : orders) {
              json arrJson = R"([])"_json;
  
              arrJson.push_back("Symbol");
              arrJson.push_back("Id");
              arrJson.push_back(order.Price);
              arrJson.push_back(order.Amount);
              arrJson.push_back(order.DealAmount);
              arrJson.push_back(order.AvgPrice);
              arrJson.push_back(order.Status);
              arrJson.push_back(order.Type);
              arrJson.push_back(order.Offset);
              arrJson.push_back(order.ContractType);
  
              tbl["rows"].push_back(arrJson);
          }
  
          tbls.push_back(tbl);
      }
  
      LogStatus(_D(), "\n", "`" + tbls.dump() + "`");
  
      return;
  }
  

• Use futures exchange object to place orders for multiple trading pairs and contract codes. Set order prices far from the order book counterparty prices to keep orders in unfilled status, and query orders in various ways.

  • javascript
  • python
  • cpp

  
      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
  

  
      c++
      
      
  /*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"}]
  */
  
  void main() {
      auto arrSymbol = {"BTC_USDT.swap", "BTC_USDT.quarter", "ETH_USDT.swap", "ETH_USDT.quarter"};
  
      for (const auto& symbol : arrSymbol) {
          auto t = exchange.GetTicker(symbol);
          exchange.CreateOrder(symbol, "buy", t.Last / 2, 1);
          exchange.CreateOrder(symbol, "sell", t.Last * 2, 1);
      }
  
      auto defaultOrders = exchange.GetOrders();
      auto swapOrders = exchange.GetOrders("USDT.swap");
      auto futuresOrders = exchange.GetOrders("USDT.futures");
      auto btcUsdtSwapOrders = exchange.GetOrders("BTC_USDT.swap");
  
      json tbls = R"([])"_json;
      std::vector<std::vector<Order>> arr = {defaultOrders, swapOrders, futuresOrders, btcUsdtSwapOrders};
      std::string tblDesc[] = {"defaultOrders", "swapOrders", "futuresOrders", "btcUsdtSwapOrders"};
      for (int index = 0; index < arr.size(); index++) {
          auto orders = arr[index];
          json tbl = R"({
              "type": "table",
              "cols": ["Symbol", "Id", "Price", "Amount", "DealAmount", "AvgPrice", "Status", "Type", "Offset", "ContractType"],
              "rows": []
          })"_json;
          tbl["title"] = tblDesc[index];
  
          for (const auto& order : orders) {
              json arrJson = R"([])"_json;
  
              arrJson.push_back(order.Symbol);
              arrJson.push_back(to_string(order.Id));    // Order订单结构中的Id属性类型为TId，使用FMZ平台内置的C++函数to_string进行编码
              arrJson.push_back(order.Price);
              arrJson.push_back(order.Amount);
              arrJson.push_back(order.DealAmount);
              arrJson.push_back(order.AvgPrice);
              arrJson.push_back(order.Status);
              arrJson.push_back(order.Type);
              arrJson.push_back(order.Offset);
              arrJson.push_back(order.ContractType);
  
              tbl["rows"].push_back(arrJson);
          }
  
          tbls.push_back(tbl);
      }
  
      LogStatus(_D(), "\n", "`" + tbls.dump() + "`");
  
      return;
  }
  

• When calling the exchange.GetOrders() function, pass the Symbol parameter to specify the order data for the trading pair or contract code to be queried.

  • javascript
  • python
  • cpp

  
      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)
  

  
      c++
      
      
  void main() {
      auto orders = exchange.GetOrders("BTC_USDT");          // 现货品种举例
      // auto orders = exchange.GetOrders("BTC_USDT.swap");   // 期货品种举例
      Log("orders:", orders);
  }
  

Returns

Arguments

See Also

Remarks

Summary of symbol parameter usage scenarios in the GetOrders function:

Summary of futures exchange object query dimension ranges in the GetOrders function:

When the account represented by the exchange object exchange has no pending orders (active orders in unfilled status) within the query scope or specified trading variety, calling this function returns an empty array, i.e.: [].

The following exchanges require a symbol parameter when querying current unfilled orders. When calling the GetOrders function with these exchanges, if no symbol parameter is passed, only the unfilled orders of the current variety are requested, not all varieties' unfilled orders (because the exchange API does not support it).

Zaif, MEXC, LBank, Korbit, Coinw, BitMart, Bithumb, BitFlyer, BigONE.

Exchanges that do not support the exchange.GetOrders() function: