nansen-cli 1.9.3 → 1.10.1

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 1.10.1
+
+### Patch Changes
+
+- [#133](https://github.com/nansen-ai/nansen-cli/pull/133) [`4cbeb65`](https://github.com/nansen-ai/nansen-cli/commit/4cbeb6510c286660f611117d2d8b0508f2340e31) Thanks [@0xlaveen](https://github.com/0xlaveen)! - fix: correct profiler pagination parameter from `recordsPerPage` to `per_page`; remove unsupported pagination from pnl-summary; add --limit to labels, historical-balances, counterparties schema
+
+- [#164](https://github.com/nansen-ai/nansen-cli/pull/164) [`ec6ab78`](https://github.com/nansen-ai/nansen-cli/commit/ec6ab78d604a177c3459833091531de3fc07add1) Thanks [@DMagowan](https://github.com/DMagowan)! - fix: correct `--date` option marked as `required: true` when it is optional
+
+  The schema incorrectly marked `--date` as `required: true` for three commands:
+
+  - `research token flows`
+  - `research token who-bought-sold`
+  - `research profiler transactions`
+
+  All three use `parseDateOption` with a `days` fallback, so `--date` is optional — omitting it defaults to a rolling window based on `--days`. An agent following the schema strictly would unnecessarily refuse to run these commands without a date.
+
+- [#162](https://github.com/nansen-ai/nansen-cli/pull/162) [`4dbe181`](https://github.com/nansen-ai/nansen-cli/commit/4dbe181d3b4973881bcb7fb445cf6559819006b6) Thanks [@DMagowan](https://github.com/DMagowan)! - fix: surface wallet prerequisite in `trade quote` help text and schema
+
+  `nansen trade quote` requires a configured wallet (the trading API builds a transaction specific to the sender address), but this was not communicated until the command failed. Adds a PREREQUISITE section to the usage text and a `prerequisites` field to the schema so agents can discover this requirement before running the command.
+
+- [#165](https://github.com/nansen-ai/nansen-cli/pull/165) [`92f37ea`](https://github.com/nansen-ai/nansen-cli/commit/92f37eaa8655ae1a39b9200aafaf4771a0859229) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Fix trading docs and config to reflect actual supported chains (Base and Solana only)
+
+## 1.10.0
+
+### Minor Changes
+
+- [#125](https://github.com/nansen-ai/nansen-cli/pull/125) [`5a5a80a`](https://github.com/nansen-ai/nansen-cli/commit/5a5a80af9c2c5b93efcc707925b004f077e13c36) Thanks [@0xlaveen](https://github.com/0xlaveen)! - Add modular skills/ directory with 7 agent-optimised SKILL.md files (nansen-token, nansen-smart-money, nansen-profiler, nansen-trade, nansen-wallet, nansen-perp, nansen-search) following the linear-cli pattern. Each skill has scoped frontmatter, agent routing descriptions, bash examples, and exit codes. Add skills nudge to `nansen --help` output.
+
+### Patch Changes
+
+- [#122](https://github.com/nansen-ai/nansen-cli/pull/122) [`9a1ada8`](https://github.com/nansen-ai/nansen-cli/commit/9a1ada8543cd6fdbcc10d2d5004fe2e2e1a88928) Thanks [@TimNooren](https://github.com/TimNooren)! - `nansen research <unknown>` and `nansen trade <unknown>` now exit with code 1 and return `{"success":false,...}` instead of silently exiting 0.
+
+- [#138](https://github.com/nansen-ai/nansen-cli/pull/138) [`c61881f`](https://github.com/nansen-ai/nansen-cli/commit/c61881f5455b9fff7fb97841652a72af58ab8e0b) Thanks [@TimNooren](https://github.com/TimNooren)! - Fix `nansen login --help` to show usage instead of erroring. Previously, `--help` was silently ignored on TTY (showing the interactive prompt) and caused an error on non-TTY. Also fixes the post-login suggested command to use the non-deprecated `nansen research token screener` path.
+
+- [#129](https://github.com/nansen-ai/nansen-cli/pull/129) [`eeabf89`](https://github.com/nansen-ai/nansen-cli/commit/eeabf8988dafc7fb1964fd2eef629f03c6a4420a) Thanks [@araa47](https://github.com/araa47)! - Fix `token ohlcv` sending unsupported pagination/limit params that caused 422 errors
+
+- [#139](https://github.com/nansen-ai/nansen-cli/pull/139) [`e86dc68`](https://github.com/nansen-ai/nansen-cli/commit/e86dc6869f524d3dc59da4c7c04cb1ace1b7246b) Thanks [@TimNooren](https://github.com/TimNooren)! - Fix API key prompt masking: each keystroke was showing the real character followed by `*` (e.g. `f*o*o*`) because the readline interface was active alongside raw mode, causing double output. Moving readline creation into the non-hidden branch eliminates the double-echo and also fixes backspace incorrectly clearing the prompt label.
+
+- [#129](https://github.com/nansen-ai/nansen-cli/pull/129) [`eeabf89`](https://github.com/nansen-ai/nansen-cli/commit/eeabf8988dafc7fb1964fd2eef629f03c6a4420a) Thanks [@araa47](https://github.com/araa47)! - Fix `trade quote` crash when no wallet exists — now shows actionable error instead of uncaught exception
+
+- [#126](https://github.com/nansen-ai/nansen-cli/pull/126) [`f3b87e7`](https://github.com/nansen-ai/nansen-cli/commit/f3b87e7491d03d052d5d72fcc991de0c33caf51f) Thanks [@araa47](https://github.com/araa47)! - Remove root SKILL.md so `npx skills add nansen-ai/nansen-cli` correctly discovers all 7 skills in `skills/` instead of treating the repo as a single skill.
+
 ## 1.9.3
 
 ### Patch Changes

package/README.md

@@ -2,226 +2,56 @@
 
 [![npm version](https://img.shields.io/npm/v/nansen-cli.svg)](https://www.npmjs.com/package/nansen-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![CI](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/nansen-ai/nansen-cli/actions/workflows/ci.yml)
 
-> **Built by agents, for agents.** We prioritize the best possible AI agent experience.
-
-Command-line interface for the [Nansen API](https://docs.nansen.ai) with structured JSON output, designed for AI agents and automation.
+> **Built by agents, for agents.** Command-line interface for the [Nansen API](https://docs.nansen.ai) with structured JSON output.
 
 ## Installation
 
 ```bash
-# Install globally via npm
 npm install -g nansen-cli
-
-# Or run directly with npx
-npx nansen-cli help
-
-# Or clone and install locally
-git clone https://github.com/nansen-ai/nansen-cli.git
-cd nansen-cli
-npm install
-npm link
+npx skills add nansen-ai/nansen-cli  # load agent skill files
 ```
 
-## Configuration
-
-### For AI Agents (Recommended)
-
-Use the [AI Agent Setup](https://app.nansen.ai/auth/agent-setup) flow:
-
-1. Your agent will ask you to visit: **[app.nansen.ai/auth/agent-setup](https://app.nansen.ai/auth/agent-setup)**
-2. Sign in with your Nansen account
-3. Copy the message shown
-4. Paste it back to your agent
-
-Your agent saves the key and handles everything else automatically.
-
-### Manual Setup
-
-**Option 1: Interactive login**
-```bash
-nansen login
-# Enter your API key when prompted
-# ✓ Saved to ~/.nansen/config.json
-```
-
-**Option 2: Environment variable (best for agents)**
-```bash
-export NANSEN_API_KEY=your-api-key
-```
-
-**Option 3: Direct config file**
-```bash
-mkdir -p ~/.nansen && echo '{"apiKey":"<key>","baseUrl":"https://api.nansen.ai"}' > ~/.nansen/config.json && chmod 600 ~/.nansen/config.json
-```
-
-Get your API key at [app.nansen.ai/api](https://app.nansen.ai/api).
-
-### Auth Priority
-
-1. `NANSEN_API_KEY` env var (highest)
-2. `~/.nansen/config.json` file
-3. Interactive prompt
-
-### Verify It Works
+## Auth
 
 ```bash
-# Check CLI is installed (no API key needed):
-nansen schema | head -1
-
-# Verify API access:
-nansen research token screener --chain solana --limit 1
+nansen login              # interactive — saves to ~/.nansen/config.json
+export NANSEN_API_KEY=... # or env var (highest priority)
 ```
 
-## Quick Start
-
-```bash
-# Get trending tokens on Solana
-nansen research token screener --chain solana --timeframe 24h --pretty
-
-# Check Smart Money activity
-nansen research smart-money netflow --chain solana --pretty
-
-# Profile a wallet
-nansen research profiler balance --address 0x28c6c06298d514db089934071355e5743bf21d60 --chain ethereum --pretty
-
-# Search for tokens/entities
-nansen research search "Vitalik Buterin" --pretty
-```
+Get your API key at [app.nansen.ai/api](https://app.nansen.ai/api). AI agents can use the [Agent Setup](https://app.nansen.ai/auth/agent-setup) flow instead.
 
 ## Commands
 
-All analytics live under `nansen research`, trading under `nansen trade`, and wallet management under `nansen wallet`.
-
-### `research` - Research & Analytics
-
 ```
 nansen research <category> <subcommand> [options]
+nansen trade <subcommand> [options]
+nansen wallet <subcommand> [options]
+nansen schema [command] [--pretty]    # full command reference (no API key needed)
 ```
 
-**Category aliases:** `sm` (smart-money), `tgm` (token), `prof` (profiler), `port` (portfolio)
-
-#### `research smart-money` - Smart Money Analytics
-
-Track trading and holding activity of sophisticated market participants.
+**Research categories:** `smart-money` (`sm`), `token` (`tgm`), `profiler` (`prof`), `portfolio` (`port`), `search`, `perp`, `points`
 
-| Subcommand | Description |
-|------------|-------------|
-| `netflow` | Net capital flows (inflows vs outflows) |
-| `dex-trades` | Real-time DEX trading activity |
-| `perp-trades` | Perpetual trading on Hyperliquid |
-| `holdings` | Aggregated token balances |
-| `dcas` | DCA strategies on Jupiter |
-| `historical-holdings` | Historical holdings over time |
+**Trade:** `quote`, `execute` — DEX swaps on Solana and Base.
 
-**Smart Money Labels:** `Fund`, `Smart Trader`, `30D Smart Trader`, `90D Smart Trader`, `180D Smart Trader`, `Smart HL Perps Trader`
+**Wallet:** `create`, `list`, `show`, `export`, `default`, `delete`, `send` — local keypairs (EVM + Solana).
 
-#### `research profiler` - Wallet Profiling
+Run `nansen schema --pretty` for the full subcommand and field reference.
 
-**ENS Name Resolution:** You can use `.eth` names anywhere an `--address` is accepted:
-
-```bash
-nansen research profiler balance --address vitalik.eth
-nansen research profiler labels --address nansen.eth --chain ethereum
-nansen research profiler transactions --address vitalik.eth --table
-```
-
-ENS names are automatically resolved to `0x` addresses via public APIs (with onchain RPC fallback). Works on all EVM chains. The resolved name and address are included as `_ens` metadata in JSON output.
-
-| Subcommand | Description |
-|------------|-------------|
-| `balance` | Current token holdings |
-| `labels` | Behavioral and entity labels |
-| `transactions` | Transaction history |
-| `pnl` | PnL and trade performance |
-| `search` | Search for entities by name |
-| `historical-balances` | Historical balances over time |
-| `related-wallets` | Find wallets related to an address |
-| `counterparties` | Top counterparties by volume |
-| `pnl-summary` | Summarized PnL metrics |
-| `perp-positions` | Current perpetual positions |
-| `perp-trades` | Perpetual trading history |
-
-#### `research token` - Token God Mode
-
-| Subcommand | Description |
-|------------|-------------|
-| `screener` | Discover and filter tokens |
-| `holders` | Token holder analysis |
-| `flows` | Token flow metrics |
-| `dex-trades` | DEX trading activity |
-| `pnl` | PnL leaderboard |
-| `who-bought-sold` | Recent buyers and sellers |
-| `flow-intelligence` | Detailed flow intelligence by label |
-| `transfers` | Token transfer history |
-| `jup-dca` | Jupiter DCA orders for token |
-| `ohlcv` | OHLCV candle data for a token |
-| `perp-trades` | Perp trades by token symbol |
-| `perp-positions` | Open perp positions by token symbol |
-| `perp-pnl-leaderboard` | Perp PnL leaderboard by token |
-
-#### `research search` / `research perp` / `research portfolio` / `research points`
-
-See `nansen research help` or `nansen schema --pretty` for full details.
-
-### `trade` - DEX Trading
-
-```bash
-# Get a swap quote
-nansen trade quote --from USDC --to SOL --amount 10 --chain solana
-
-# Execute the swap
-nansen trade execute --from USDC --to SOL --amount 10 --chain solana
-```
-
-### `wallet` - Local Wallet Management
-
-| Subcommand | Description |
-|------------|-------------|
-| `create` | Create a new wallet (EVM + Solana keypair) |
-| `list` | List all wallets |
-| `show` | Show wallet addresses |
-| `export` | Export private keys |
-| `default` | Set default wallet |
-| `delete` | Delete a wallet |
-| `send` | Send tokens (native or ERC-20/SPL) |
-
-Wallets are passwordless by default (keys stored like SSH keys). Set `NANSEN_WALLET_PASSWORD` env var for encryption at rest.
-
-### `schema` - Schema Discovery
-
-No API key required. Machine-readable command reference for agent introspection.
-
-```bash
-nansen schema --pretty                    # All commands
-nansen schema research --pretty           # Research commands
-```
-
-### Deprecated Flat Commands
-
-The old flat commands (`nansen smart-money`, `nansen token`, `nansen profiler`, `nansen search`, `nansen perp`, `nansen portfolio`, `nansen points`, `nansen quote`, `nansen execute`) still work but print a deprecation warning to stderr. Use the new `research` and `trade` namespaces instead.
-
-## Options
+## Key Options
 
 | Option | Description |
 |--------|-------------|
-| `--pretty` | Format JSON output for readability |
-| `--table` | Format output as human-readable table |
-| `--fields <list>` | Comma-separated fields to include (reduces response size) |
-| `--stream` | Output as NDJSON for incremental processing |
-| `--cache` / `--no-cache` | Enable/disable response caching |
-| `--cache-ttl <s>` | Cache TTL in seconds (default: 300) |
 | `--chain <chain>` | Blockchain to query |
-| `--chains <json>` | Multiple chains as JSON array |
-| `--limit <n>` | Number of results |
-| `--days <n>` | Date range in days (default: 30) |
-| `--sort <field:dir>` | Sort results (e.g., `--sort value_usd:desc`) |
-| `--symbol <sym>` | Token symbol for perp endpoints (e.g., BTC, ETH) |
-| `--filters <json>` | Filter criteria as JSON |
+| `--limit <n>` | Result count |
+| `--timeframe <tf>` | Time window: `5m` `1h` `6h` `24h` `7d` `30d` |
+| `--fields <list>` | Comma-separated fields (reduces response size) |
+| `--sort <field:dir>` | Sort results, e.g. `--sort value_usd:desc` |
+| `--pretty` | Human-readable JSON |
+| `--table` | Table format |
+| `--stream` | NDJSON output for large results |
 | `--labels <label>` | Smart Money label filter |
-| `--smart-money` | Filter for Smart Money only |
-| `--timeframe <tf>` | Time window (5m, 10m, 1h, 6h, 24h, 7d, 30d) |
+| `--smart-money` | Filter for Smart Money addresses only |
 
 ## Supported Chains
 
@@ -229,121 +59,51 @@ The old flat commands (`nansen smart-money`, `nansen token`, `nansen profiler`,
 
 > Run `nansen schema` to get the current chain list (source of truth).
 
-## Agent-Optimized Patterns
-
-### Reduce Token Burn with `--fields`
-
-```bash
-# ❌ Returns everything (huge JSON, wastes agent context)
-nansen research smart-money netflow --chain solana
-
-# ✅ Only what you need
-nansen research smart-money netflow --chain solana --fields token_symbol,net_flow_usd,chain --limit 10
-```
-
-### Use `--stream` for Large Results
+## Agent Tips
 
+**Reduce token burn with `--fields`:**
 ```bash
-# NDJSON mode — process line by line, don't buffer giant arrays
-nansen research token dex-trades --chain solana --limit 100 --stream
+nansen research smart-money netflow --chain solana --fields token_symbol,net_flow_usd --limit 10
 ```
 
-### x402 Micropayments
+**Use `--stream` for large results** — outputs NDJSON instead of buffering a giant array.
 
-When the API returns a 402 Payment Required, the CLI automatically handles payment if a funded wallet exists:
-
-1. CLI detects 402 response with payment requirements
-2. Signs a USDC payment ($0.05/call) using your wallet
-3. Retries the request with the payment signature
-4. Falls back from EVM to Solana if first network has insufficient funds
-
-```bash
-# Fund your wallet, then API calls auto-pay
-nansen wallet create
-# Send USDC to the displayed address
-nansen research smart-money netflow --chain solana  # auto-pays if no API key
-```
-
-## Pagination
-
-Use `--limit N` to control result count. The CLI always fetches page 1 (there is no `--page` flag).
-
-**Detecting the last page:** If results returned < your `--limit`, you've reached the end.
+**ENS names** work anywhere `--address` is accepted: `--address vitalik.eth`
 
 ## Output Format
 
-### Response envelope
-
 ```json
-// Success
-{ "success": true, "data": <raw_api_response> }
-
-// Error
-{ "success": false, "error": "message", "code": "ERROR_CODE", "status": 401, "details": {...} }
+{ "success": true,  "data": <api_response> }
+{ "success": false, "error": "message", "code": "ERROR_CODE", "status": 401 }
 ```
 
-### Response shapes vary by endpoint
-
-The `data` field structure differs across endpoints:
-
-| Shape | Example endpoints |
-|-------|------------------|
-| `data.data` (array) | token screener |
-| `data.results` (array) | entity search |
-| `data.data.results` (array) | most profiler endpoints |
-| `data.netflows` | smart-money netflow |
-| `data.trades` | smart-money dex-trades |
-| `data.holdings` | smart-money holdings |
-| `data.holders` | token holders |
-
-`--table` and `--stream` handle this automatically. For raw JSON parsing:
-
-```bash
-nansen research smart-money netflow --chain solana | jq 'keys, .data | keys'
-```
-
-### Error codes
+**Critical error codes:**
 
 | Code | Action |
 |------|--------|
-| `CREDITS_EXHAUSTED` | Stop all API calls immediately — do not retry. Check your plan at [app.nansen.ai](https://app.nansen.ai). |
-| `RATE_LIMITED` | Auto-retry handles this. |
+| `CREDITS_EXHAUSTED` | Stop all API calls immediately. Check [app.nansen.ai](https://app.nansen.ai). |
+| `UNAUTHORIZED` | Wrong or missing key. Re-auth. |
+| `RATE_LIMITED` | Auto-retried by CLI. |
 | `UNSUPPORTED_FILTER` | Remove the filter and retry. |
-| `UNAUTHORIZED` | Key is wrong or missing. Re-auth. |
-| `INVALID_ADDRESS` | Check address format for the chain. |
 
 ## Troubleshooting
 
 | Symptom | Fix |
 |---------|-----|
-| `command not found: nansen` | `npm install -g nansen-cli` or `npx nansen-cli` |
-| `UNAUTHORIZED` after login | Check `cat ~/.nansen/config.json`. Write directly if needed. |
-| Login hangs | Skip `nansen login`, write config directly. |
-| Huge JSON response | Use `--fields` to select only needed columns. |
-| Perp endpoints empty | Use `--symbol BTC` not `--token`. Perps are Hyperliquid-only. |
-| `UNSUPPORTED_FILTER` on token holders | Not all tokens have smart money data. Remove `--smart-money`. |
-| `CREDITS_EXHAUSTED` | Check your plan at [app.nansen.ai](https://app.nansen.ai). |
+| `command not found` | `npm install -g nansen-cli` |
+| `UNAUTHORIZED` after login | `cat ~/.nansen/config.json` or set `NANSEN_API_KEY` |
+| Empty perp results | Use `--symbol BTC`, not `--token`. Perps are Hyperliquid-only. |
+| `UNSUPPORTED_FILTER` on token holders | Remove `--smart-money` — not all tokens have that data. |
+| Huge JSON response | Use `--fields` to select columns. |
 
 ## Development
 
 ```bash
-npm test              # Run tests (mocked, no API key needed)
-npm run test:coverage # With coverage
-npm run test:live     # Against live API (needs NANSEN_API_KEY)
+npm test              # mocked tests, no API key needed
+npm run test:live     # live API (needs NANSEN_API_KEY)
 ```
 
-See [AGENTS.md](AGENTS.md) for contributor guidance (architecture, testing patterns, style guide).
-
-## API Coverage
-
-| Category | Endpoints | Coverage |
-|----------|-----------|----------|
-| Smart Money | 6 | 100% |
-| Profiler | 11 | 100% |
-| Token God Mode | 12 | 100% |
-| Portfolio | 1 | 100% |
-| Search | 1 | 100% |
-| **Total** | **31** | **100%** |
+See [AGENTS.md](AGENTS.md) for architecture and contributor guidance.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.9.3",
+  "version": "1.10.1",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",
@@ -9,6 +9,7 @@
   },
   "files": [
     "src/*.js",
+    "src/*.json",
     "CHANGELOG.md"
   ],
   "scripts": {
@@ -19,6 +20,8 @@
     "test:coverage": "vitest run --coverage",
     "test:live": "NANSEN_LIVE_TEST=1 vitest run",
     "test:trade": "vitest run --config vitest.e2e.config.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "changeset:publish": "changeset publish"
@@ -52,7 +55,10 @@
   "devDependencies": {
     "@changesets/changelog-github": "^0.5.1",
     "@changesets/cli": "^2.29.4",
+    "@eslint/js": "^10.0.1",
     "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.2",
+    "globals": "^17.4.0",
     "vitest": "^4.0.18"
   }
-}
+}

package/src/api.js

@@ -194,9 +194,9 @@ export function getCachedResponse(endpoint, body, ttlSeconds = DEFAULT_CACHE_TTL
     }
     
     return { ...cached.data, _meta: { ...cached.data._meta, fromCache: true, cacheAge: Math.round(age) } };
-  } catch (e) {
+  } catch (_e) {
     // Invalid cache file, delete it
-    try { fs.unlinkSync(cacheFile); } catch {}
+    try { fs.unlinkSync(cacheFile); } catch { /* ignore */ }
     return null;
   }
 }
@@ -305,7 +305,7 @@ function loadConfig() {
 
   // ~/.nansen/config.json (from `nansen login`)
   if (fs.existsSync(CONFIG_FILE)) {
-    try { config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); } catch (e) {}
+    try { config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); } catch (_e) { /* ignore */ }
   }
 
   // Local config.json (for development)
@@ -476,7 +476,7 @@ export class NansenAPI {
       let data;
       try {
         data = await response.json();
-      } catch (err) {
+      } catch (_err) {
         // Non-JSON response (rare, usually server errors)
         const error = new NansenError(
           `Invalid response from API (status ${response.status})`,
@@ -646,11 +646,12 @@ export class NansenAPI {
   }
 
   async smartMoneyPerpTrades(params = {}) {
-    const { filters = {}, orderBy, pagination } = params;
+    const { filters = {}, orderBy, pagination, onlyNewPositions } = params;
     return this.request('/api/v1/smart-money/perp-trades', {
       filters,
       order_by: orderBy,
-      pagination
+      pagination,
+      only_new_positions: onlyNewPositions
     });
   }
 
@@ -703,7 +704,7 @@ export class NansenAPI {
   }
 
   async addressLabels(params = {}) {
-    const { address, chain = 'ethereum', pagination = { page: 1, recordsPerPage: 100 } } = params;
+    const { address, chain = 'ethereum', pagination = { page: 1, per_page: 100 } } = params;
     if (address) {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
@@ -814,7 +815,9 @@ export class NansenAPI {
   }
 
   async addressPnlSummary(params = {}) {
-    const { address, chain = 'ethereum', orderBy, pagination, days = 30 } = params;
+    // Note: pnl-summary endpoint is non-paginated (returns aggregate stats, not a list).
+    // Pagination param intentionally omitted from this request.
+    const { address, chain = 'ethereum', orderBy, days = 30 } = params;
     if (address) {
       const validation = validateAddress(address, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
@@ -823,8 +826,7 @@ export class NansenAPI {
       address,
       chain,
       date: buildDateRange(days),
-      order_by: orderBy,
-      pagination
+      order_by: orderBy
     });
   }
 
@@ -1039,7 +1041,7 @@ export class NansenAPI {
   }
 
   async tokenOhlcv(params = {}) {
-    const { tokenAddress, chain = 'solana', timeframe, pagination } = params;
+    const { tokenAddress, chain = 'solana', timeframe } = params;
     if (tokenAddress) {
       const validation = validateTokenAddress(tokenAddress, chain);
       if (!validation.valid) throw new NansenError(validation.error, validation.code);
@@ -1048,7 +1050,6 @@ export class NansenAPI {
       token_address: tokenAddress,
       chain,
       timeframe,
-      pagination
     });
   }