v1.27.0

Minor Changes

• #403 fe53dbe Thanks @marius-reed! - Add prediction market filtering (order_by, volume/liquidity/OI/trader/price/date filters, neg_risk, tags) and address-summary endpoint

Patch Changes

• #402 cfd94ce Thanks @TimNooren! - Enforce USDC or native token on one side of every swap

v1.26.1

Patch Changes

• #392 025993d Thanks @TimNooren! - Add gas balance validation: rejects trades when the wallet lacks sufficient native token for gas fees.

v1.26.0

Minor Changes

• #380 12e4e25 Thanks @TimNooren! - Add --amount-unit percent to trade commands, allowing trades as a percentage of wallet balance (e.g. --amount 100 --amount-unit percent to sell all)

Patch Changes

• #382 d9c87ef Thanks @kome12! - fix: default profiler balance chain to 'all' instead of 'ethereum'

  Previously, nansen profiler balance --address <addr> without --chain defaulted to ethereum, returning empty results for wallets with no ETH mainnet holdings (e.g. Base-only or Solana-only wallets). Now defaults to 'all', letting the API auto-route based on address format.

v1.25.1

Patch Changes

• #367 9fea10a Thanks @kome12! - add --premium-labels flag to tgm/holders, tgm/pnl-leaderboard, tgm/perp-pnl-leaderboard, and perp-leaderboard endpoints

v1.25.0

Minor Changes

• #363 6ae402e Thanks @TimNooren! - Add --amount-unit usd to trade commands — specify swap amounts in USD

Patch Changes

• #374 0f14803 Thanks @TimNooren! - Fix cross-chain quote display: show adaptive precision for sub-cent bridge fees, "< 1 min" for fast bridges, and echo --to-wallet address in output

• #366 f358fff Thanks @kome12! - fix(token): replace dead --days param with working --timeframe for token flow-intelligence

  The --days option was accepted but never sent to the API, resulting in always fetching 1d data. This replaces it with --timeframe (enum: 1h | 6h | 12h | 1d | 7d, default 1d) which maps correctly to the API parameter.

v1.24.0

Minor Changes

• #333 c8fe79c Thanks @imhta! - Add cross-chain swap support between Solana and Base via Li.Fi bridge.

  nansen trade quote --chain base --to-chain solana --from ETH --to SOL --amount 0.01 --amount-unit token
nansen trade execute --quote <id>

  Bridge status can be checked with nansen trade bridge-status.

Patch Changes

• #365 56335af Thanks @TimNooren! - Add balance pre-check before quote API calls. Validates sell token balance, auto-adjusts near-full-balance trades (≤2% over), and reserves gas fees for native token swaps (SOL/ETH).

v1.23.1

Patch Changes

• #361 ff22da3 Thanks @TimNooren! - fix(alerts): error when --webhook-secret is passed without --webhook

  Previously, passing --webhook-secret with a non-webhook channel (e.g. --telegram)
  silently discarded the secret with no warning. The alert was created successfully
  but without any signing, giving the false impression that the secret was active.

  Now throws an actionable error: "--webhook-secret requires --webhook".

• #358 70ee712 Thanks @TimNooren! - Add pre-quote trade input validation: rejects same-token swaps, invalid address formats, and non-positive amounts before any network call.

v1.23.0

Minor Changes

• #341 4b60056 Thanks @gulshngill! - Add --webhook <url> and --webhook-secret <secret> flags to alerts create and alerts update.

  Allows alerts to be delivered to any HTTP/HTTPS endpoint via POST, alongside
  the existing --telegram, --slack, and --discord channels. The optional
  --webhook-secret enables HMAC payload signing for verification.

Patch Changes

• #344 3dc09cc Thanks @0xlaveen! - Add nansen-agent-guide skill — routing guide for when to use nansen agent vs direct CLI data commands

• #347 a243c7a Thanks @kome12! - Add --buy-or-sell option to token who-bought-sold command — allows filtering by buy or sell side (BUY | SELL, defaults to BUY)

v1.22.0

Minor Changes

• #336 c3b1fbd Thanks @kome12! - Add --label option to token flows command to filter by holder segment (top_100_holders, smart_money, public_figure, whale, exchange).

• #334 83244c6 Thanks @kome12! - Add --include-stablecoins flag to token screener command. Pass --include-stablecoins false to exclude stablecoins from screener results (API default is true). Supports combined usage with --smart-money.

• #339 27ebcfc Thanks @TimNooren! - Add --amount-unit token flag to trade quote for human-readable amounts

v1.21.0

Minor Changes

• #315 908fa0c Thanks @TimNooren! - Add nansen agent command for the Nansen AI research agent with fast/expert modes, SSE streaming, conversation continuation, and JSON output.

Patch Changes

• #326 1532ba4 Thanks @TimNooren! - Show API credit cost in research subcommand help text (fetched from OpenAPI spec, cached 24h).

• #330 a6b9b8f Thanks @0xlaveen! - Suppress misleading PASSWORD_REQUIRED error when --provider privy is specified. Privy wallets don't need a password — only the Privy-specific credentials error is now shown when PRIVY_APP_ID/PRIVY_APP_SECRET are missing.

• #329 f047833 Thanks @TimNooren! - Limit deprecation warnings and update notices to help output only, keeping stdout/stderr clean for programmatic usage.

• #332 e9b6de1 Thanks @0xlaveen! - docs: add trading examples and Privy wallet setup to README