EXC-1670 Added userTradesHistory route (#91)

* added route

* func name fix

Author: DanyalKhawaja

examples/9.user_data.py

@@ -46,6 +46,10 @@ async def main():
     print("User trades:")    
     pprint(trades)
 
+    # fetches user trades
+    trades = await client.get_user_trades_history({"symbol":MARKET_SYMBOLS.BTC})
+    print("User trades history:")    
+    pprint(trades["data"])
 
     # fetches user account's general data like leverage, pnl etc.
     account_data = await client.get_user_account_data()

src/firefly_exchange_client/client.py

@@ -878,6 +878,21 @@ async def get_user_trades(self,params:GetUserTradesRequest):
             params,
             True
         )
+    
+    async def get_user_trades_history(self,params:GetUserTradesHistoryRequest):
+        """
+            Returns a list of user trades history.
+            Inputs:
+                params(GetUserTradesHistoryRequest): params to query trades (e.g. symbol) 
+            Returns:
+                list: a list of positions
+        """
+        params = extract_enums(params,["symbol","type"])
+        return await self.apis.get(
+            SERVICE_URLS["USER"]["USER_TRADES_HISTORY"],
+            params,
+            True
+        )
 
     async def get_user_account_data(self, parentAddress:str = ""):
         """

src/firefly_exchange_client/constants.py

@@ -92,7 +92,8 @@
     "FUND_GAS": "/account/fundGas",
     "TRANSFER_HISTORY": "/userTransferHistory",
     "FUNDING_HISTORY": "/userFundingHistory",
-    "CANCEL_ON_DISCONNECT": "/dms-countdown"
+    "CANCEL_ON_DISCONNECT": "/dms-countdown",
+     "USER_TRADES_HISTORY": "/userTradesHistory",
   },
   "ORDERS": {
     "ORDERS": "/orders",

src/firefly_exchange_client/interfaces.py

@@ -134,6 +134,17 @@ class GetUserTradesRequest(TypedDict):
   type: ORDER_TYPE
   parentAddress: str # (optional) should be provided by sub account
 
+class GetUserTradesHistoryRequest(TypedDict):
+  symbol: MARKET_SYMBOLS
+  maker: bool
+  fromId: int
+  startTime: int
+  endTime: int
+  limit: int
+  cursor: int
+  type: ORDER_TYPE
+  parentAddress: str # (optional) should be provided by sub account
+
 class GetOrderRequest(GetTransactionHistoryRequest):
   statuses:List[ORDER_STATUS] # (optional) status of orders to be fetched
   orderId: int #(optional) the id of order to be fetched