Nansen Defi Positions

Quick protocol-by-protocol breakdown of what DeFi positions a wallet holds using Nansen's research API. You get lending positions, LP stakes, and rewards across chains, plus it pulls spot balances from Ethereum and Base to round out the picture. Useful when you need to understand someone's full on-chain exposure without hopping between block explorers and protocol dashboards. The portfolio endpoint can return empty if Nansen isn't tracking DeFi activity for that address, so it's really for wallets with meaningful protocol positions. Requires a Nansen API key and the nansen-cli npm package.

skills.sh installs: 410
GitHub stars: 148
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add nansen-ai/nansen-cli --skill nansen-defi-positions --agent claude-code

Installs into .claude/skills of the current project.

Files

Authentication

Nansen account API calls accept a selected nansen:api browser session or conventional API key with the same permissions. NANSEN_API_KEY takes precedence; optional primaryEnv preserves configured-key injection. Run nansen auth status for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is enabled in production within the documented platform scope.

DeFi Exposure

Answers: "What DeFi positions does this wallet have across protocols?"

ADDR=<address>

nansen research portfolio defi --wallet $ADDR
# → protocol_name, chain, total_value_usd, total_assets_usd, total_debts_usd, total_rewards_usd, tokens

SKILL.md on GitHub

Details

Repository: github.com/nansen-ai/nansen-cli
Categories: CLI & Terminal, Finance & Trading, Web3 & Blockchain
First seen: Jun 3, 2026