Merge pull request #452 from alpacahq/extend-list-orders-2

Extend list_orders functionality with symbols filtering

Author: camelpac

README.md

@@ -176,7 +176,7 @@ for trade in trades_iter:
 ### Live Stream Data
 There are 2 streams available as described [here](https://alpaca.markets/docs/api-documentation/api-v2/market-data/alpaca-data-api-v2/real-time/).<br>
 The free plan is using the `iex` stream, while the paid subscription is using the `sip` stream.<br>
-You could subscribe to bars, trades or quotes and account updates as well.<br>
+You could subscribe to bars, trades or quotes and trade updates as well.<br>
 Under the example folder you could find different code [samples](https://github.com/alpacahq/alpaca-trade-api-python/tree/master/examples/websockets) to achieve different goals. Let's see the basic example<br>
 We present a new Streamer class under `alpaca_trade_api.stream` for API V2.
 ```py

alpaca_trade_api/rest.py

@@ -234,7 +234,9 @@ def list_orders(self,
                     until: str = None,
                     direction: str = None,
                     params=None,
-                    nested: bool = None) -> Orders:
+                    nested: bool = None,
+                    symbols: List[str] = None
+                    ) -> Orders:
         """
         Get a list of orders
         https://docs.alpaca.markets/web-api/orders/#get-a-list-of-orders
@@ -245,6 +247,8 @@ def list_orders(self,
         :param until: timestamp
         :param direction: asc or desc.
         :param params: refer to documentation
+        :param nested: should the data be nested like json
+        :param symbols: list of str (symbols)
         """
         if params is None:
             params = dict()
@@ -260,6 +264,8 @@ def list_orders(self,
             params['status'] = status
         if nested is not None:
             params['nested'] = nested
+        if symbols is not None:
+            params['symbols'] = ",".join(symbols)
         url = '/orders'
         resp = self.get(url, params)
         if self._use_raw_data: