feat: add trade history endpoint

v4-client-js/__tests__/modules/client/AccountEndpoints.test.ts

@@ -232,5 +232,73 @@ describe('IndexerClient', () => {
       expect(response.pageSize).toStrictEqual(1);
       expect(response.offset).toStrictEqual(0);
     });
+
+    it('Trade History', async () => {
+      const response = await client.account.getSubaccountTradeHistory(DYDX_TEST_ADDRESS, 0);
+      expect(response).not.toBeNull();
+      const trades = response.tradeHistory;
+      expect(trades).not.toBeNull();
+      if (trades.length > 0) {
+        const trade = trades[0];
+        expect(trade).not.toBeNull();
+      }
+    });
+
+    it('Trade History ParentSubaccountNumber', async () => {
+      const response = await client.account.getParentSubaccountNumberTradeHistory(DYDX_TEST_ADDRESS, 0);
+      expect(response).not.toBeNull();
+      const trades = response.tradeHistory;
+      expect(trades).not.toBeNull();
+      if (trades.length > 0) {
+        const trade = trades[0];
+        expect(trade).not.toBeNull();
+      }
+    });
+
+    it('Trade History Pagination', async () => {
+      const response = await client.account.getSubaccountTradeHistory(
+        DYDX_TEST_ADDRESS,
+        0,
+        undefined,
+        undefined,
+        1,
+        1,
+      );
+
+      expect(response).not.toBeNull();
+      const trades = response.tradeHistory;
+      expect(trades).not.toBeNull();
+      if (trades.length > 0) {
+        const trade = trades[0];
+        expect(trade).not.toBeNull();
+        expect(response.totalResults).toBeGreaterThanOrEqual(1);
+      }
+
+      expect(response.pageSize).toStrictEqual(1);
+      expect(response.offset).toStrictEqual(0);
+    });
+
+    it('Trade History ParentSubaccountNumber Pagination', async () => {
+      const response = await client.account.getParentSubaccountNumberTradeHistory(
+        DYDX_TEST_ADDRESS,
+        0,
+        undefined,
+        undefined,
+        1,
+        1,
+      );
+
+      expect(response).not.toBeNull();
+      const trades = response.tradeHistory;
+      expect(trades).not.toBeNull();
+      if (trades.length > 0) {
+        const trade = trades[0];
+        expect(trade).not.toBeNull();
+        expect(response.totalResults).toBeGreaterThanOrEqual(1);
+      }
+
+      expect(response.pageSize).toStrictEqual(1);
+      expect(response.offset).toStrictEqual(0);
+    });
   });
 });

v4-client-js/examples/account_endpoints.ts

@@ -120,6 +120,20 @@ async function test(): Promise<void> {
   } catch (error) {
     console.log(error.message);
   }
+
+  // Get trade history
+  try {
+    const response = await client.account.getSubaccountTradeHistory(address, 0);
+    console.log(response);
+    const trades = response.tradeHistory;
+    console.log(trades);
+    if (trades.length > 0) {
+      const trade0 = trades[0];
+      console.log(trade0);
+    }
+  } catch (error) {
+    console.log(error.message);
+  }
 }
 
 test()

v4-client-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dydxprotocol/v4-client-js",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "General client library for the new dYdX system (v4 decentralized)",
   "main": "build/cjs/src/index.js",
   "module": "build/esm/src/index.js",

v4-client-js/src/clients/modules/account.ts

@@ -385,4 +385,30 @@ export default class AccountClient extends RestClient {
     const uri = `/v4/fundingPayments/parentSubaccount`;
     return this.get(uri, { address, parentSubaccountNumber, limit, ticker, afterOrAt, page });
   }
+
+  // ------ Trade History ------ //
+
+  async getSubaccountTradeHistory(
+    address: string,
+    subaccountNumber: number,
+    market?: string,
+    marketType?: string,
+    limit?: number,
+    page?: number,
+  ): Promise<Data> {
+    const uri = `/v4/tradeHistory`;
+    return this.get(uri, { address, subaccountNumber, market, marketType, limit, page });
+  }
+
+  async getParentSubaccountNumberTradeHistory(
+    address: string,
+    parentSubaccountNumber: number,
+    market?: string,
+    marketType?: string,
+    limit?: number,
+    page?: number,
+  ): Promise<Data> {
+    const uri = `/v4/tradeHistory/parentSubaccountNumber`;
+    return this.get(uri, { address, parentSubaccountNumber, market, marketType, limit, page });
+  }
 }