Implement market.get_limit_orders(depth) bitshares#244

Author: xeroc

bitshares/market.py

@@ -234,6 +234,9 @@ def orderbook(self, limit=25):
                 ``base``, ``quote`` and ``price``. From those you can
                 obtain the actual amounts for sale
 
+            .. note:: This method does order consolidation and hides some
+                details of individual orders!
+
         """
         orders = self.blockchain.rpc.get_order_book(
             self["base"]["id"], self["quote"]["id"], limit
@@ -271,6 +274,42 @@ def orderbook(self, limit=25):
         data = {"asks": asks, "bids": bids}
         return data
 
+    def get_limit_orders(self, limit=25):
+        """ Returns the list of limit orders for a given market.
+
+            :param int limit: Limit the amount of orders (default: 25)
+
+            Sample output:
+
+            .. code-block:: js
+
+                {'bids': [0.003679 USD/BTS (1.9103 USD|519.29602 BTS),
+                0.003676 USD/BTS (299.9997 USD|81606.16394 BTS),
+                0.003665 USD/BTS (288.4618 USD|78706.21881 BTS),
+                0.003665 USD/BTS (3.5285 USD|962.74409 BTS),
+                0.003665 USD/BTS (72.5474 USD|19794.41299 BTS)],
+                'asks': [0.003738 USD/BTS (36.4715 USD|9756.17339 BTS),
+                0.003738 USD/BTS (18.6915 USD|5000.00000 BTS),
+                0.003742 USD/BTS (182.6881 USD|48820.22081 BTS),
+                0.003772 USD/BTS (4.5200 USD|1198.14798 BTS),
+                0.003799 USD/BTS (148.4975 USD|39086.59741 BTS)]}
+
+
+            .. note:: Each bid is an instance of
+                class:`bitshares.price.Order` and thus carries the keys
+                ``base``, ``quote`` and ``price``. From those you can
+                obtain the actual amounts for sale
+
+        """
+        return list(
+            map(
+                lambda x: Order(x, blockchain_instance=self.blockchain),
+                self.blockchain.rpc.get_limit_orders(
+                    self["base"]["id"], self["quote"]["id"], limit
+                ),
+            )
+        )
+
     def trades(self, limit=25, start=None, stop=None):
         """ Returns your trade history for a given market.