nansen-cli 1.31.0 → 1.32.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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
+
+- [#443](https://github.com/nansen-ai/nansen-cli/pull/443) [`0ee84db`](https://github.com/nansen-ai/nansen-cli/commit/0ee84db6cdab06054c6ae79c6d871bae0b4f3edb) Thanks [@araa47](https://github.com/araa47)! - Skip native gas pre-check for trades >= $10 USD, where gasless/solver-paid routes (e.g. Relay) are viable. When gas is insufficient on smaller trades, the error now also suggests increasing the trade value as an alternative to topping up gas.
+
 ## 1.31.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.31.0",
+  "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",

package/src/trade-validation.js

@@ -136,6 +136,10 @@ const FEE_BUFFER = { solana: 0.005, base: 0.00004 };
 const HIGH_PERCENTAGE_THRESHOLD = 95;
 const AUTO_ADJUST_THRESHOLD_PERCENT = 2;
 
+// Trades at or above this USD value can use gasless/solver-paid routes (e.g. Relay),
+// so the native gas pre-check is skipped for them.
+export const GASLESS_MIN_TRADE_USD = 10;
+
 /**
  * Check if an address is USDC or the native token for a chain (case-insensitive for EVM).
  */
@@ -306,12 +310,19 @@ export async function resolvePercentAmount({ chain, from, walletAddress, percent
  *
  * Returns { hasSufficientNative } or throws on validation failure.
  * Best-effort: if RPC fails, returns passing result.
+ *
+ * Gasless bypass: trades >= $10 USD can use solver-paid options (e.g. Relay),
+ * so the gas check is skipped in that case.
  */
-export async function validateGasBalance({ chain, walletAddress }) {
+export async function validateGasBalance({ chain, walletAddress, tradeValueUsd }) {
   const normalizedChain = chain.toLowerCase();
   const minGas = MIN_GAS_AMOUNTS[normalizedChain];
   if (minGas === undefined) return { hasSufficientNative: true };
 
+  // High-value trades can use gasless/solver-paid routes — skip the check.
+  const tradeUsd = parseFloat(tradeValueUsd) || 0;
+  if (tradeUsd >= GASLESS_MIN_TRADE_USD) return { hasSufficientNative: true };
+
   const balance = await fetchNativeBalance(normalizedChain, walletAddress);
 
   // RPC failure — proceed without validation.
@@ -323,7 +334,7 @@ export async function validateGasBalance({ chain, walletAddress }) {
 
   const symbol = NATIVE_SYMBOLS[normalizedChain] || 'native token';
   throw new Error(
-    `Insufficient ${symbol} for gas fees. Wallet has ${balance} ${symbol} but needs at least ${minGas} ${symbol}. Fund the wallet before trading.`
+    `Insufficient ${symbol} for gas fees. Wallet has ${balance} ${symbol} but needs at least ${minGas} ${symbol}. Either fund the wallet with ${symbol} or trade a value of $${GASLESS_MIN_TRADE_USD}+ to use gasless options.`
   );
 }
 

package/src/trading.js

@@ -1331,8 +1331,10 @@ CROSS-CHAIN NOTES (when using --to-chain):
         response.quotes.forEach((q, i) => log(formatQuote(q, i)));
 
         // Gas balance validation — check that the wallet has enough native token for gas.
+        // High-value trades (>= $10) can use gasless/solver-paid routes and bypass this check.
         try {
-          await validateGasBalance({ chain, walletAddress });
+          const tradeValueUsd = response.quotes[0]?.inUsdValue;
+          await validateGasBalance({ chain, walletAddress, tradeValueUsd });
         } catch (gasErr) {
           throw new CommandError(`Error: ${gasErr.message}`, 'INSUFFICIENT_GAS');
         }