nansen-cli 1.31.1 → 1.32.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.32.0
+
+### Minor Changes
+
+- [#451](https://github.com/nansen-ai/nansen-cli/pull/451) [`73600d9`](https://github.com/nansen-ai/nansen-cli/commit/73600d9cd13248a265332ec0728c602b16f44868) Thanks [@kome12](https://github.com/kome12)! - Add `nansen research profiler dex-trades` command for DEX trade history
+
 ## 1.31.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.31.1",
+  "version": "1.32.0",
   "description": "AI-agent CLI for Nansen API analytics, DEX swaps, and cross-chain trading",
   "main": "src/index.js",
   "type": "module",

package/src/api.js

@@ -973,6 +973,20 @@ export class NansenAPI {
     });
   }
 
+  async addressDexTrades(params = {}) {
+    const { address, chain = 'ethereum', filters = {}, orderBy, pagination, days = 30, date } = params;
+    if (address) requireValidAddress(address, chain);
+    const dateRange = date || buildDateRange(days);
+    return this.request('/api/v1/profiler/dex-trades', {
+      address,
+      chain,
+      date: dateRange,
+      filters,
+      order_by: orderBy,
+      pagination
+    });
+  }
+
   // ============= Token God Mode Endpoints =============
 
   async tokenScreener(params = {}) {

package/src/cli.js

@@ -1148,6 +1148,10 @@ export function buildCommands(deps = {}) {
         'pnl-summary': () => apiInstance.addressPnlSummary({ address, chain, orderBy, pagination, days }),
         'perp-positions': () => apiInstance.addressPerpPositions({ address, filters, orderBy, pagination }),
         'perp-trades': () => apiInstance.addressPerpTrades({ address, filters, orderBy, pagination, days }),
+        'dex-trades': () => {
+          const date = parseDateOption(options.date, days);
+          return apiInstance.addressDexTrades({ address, chain, filters, orderBy, pagination, days, date });
+        },
         'batch': () => {
           let addresses = [];
           if (options.addresses) {
@@ -1186,7 +1190,7 @@ export function buildCommands(deps = {}) {
           return compareWallets(apiInstance, { addresses: addrs, chain, days });
         },
         'help': () => ({
-          commands: ['balance', 'labels', 'transactions', 'pnl', 'search', 'historical-balances', 'related-wallets', 'counterparties', 'pnl-summary', 'perp-positions', 'perp-trades', 'batch', 'trace', 'compare'],
+          commands: ['balance', 'labels', 'transactions', 'pnl', 'search', 'historical-balances', 'related-wallets', 'counterparties', 'pnl-summary', 'perp-positions', 'perp-trades', 'dex-trades', 'batch', 'trace', 'compare'],
           description: 'Wallet profiling endpoints',
           example: 'nansen research profiler compare --addresses "0xABC...,0xDEF..." --chain ethereum'
         })

package/src/schema.json

@@ -203,6 +203,21 @@
                 }
               }
             },
+            "dex-trades": {
+              "endpoint": "/api/v1/profiler/dex-trades",
+              "description": "DEX trade history for a wallet",
+              "options": {
+                "address": {
+                  "required": true
+                },
+                "chain": {
+                  "default": "ethereum"
+                },
+                "days": {
+                  "default": 30
+                }
+              }
+            },
             "search": {
               "endpoint": "/api/v1/search/entity-name",
               "description": "Search for entities by name",