Nansen Defi Positions
- 365 installs
- 127 repo stars
- Updated August 4, 2026
- nansen-ai/nansen-cli
nansen-defi-positions is an agent skill that queries and summarizes on-chain DeFi wallet holdings by protocol and chain through the Nansen CLI for developers who need treasury exposure, debt, and reward breakdowns.
About
nansen-defi-positions is an agent skill in the nansen-ai/nansen-cli repository that teaches coding agents to pull on-chain DeFi exposure through the Nansen CLI. The skill documents `nansen research portfolio defi --wallet <address>`, which returns structured output with protocol_name, chain, total_value_usd, total_assets_usd, total_debts_usd, total_rewards_usd, and token-level holdings per protocol. Developers reach for nansen-defi-positions when automating treasury reviews, lending health checks, LP and staking exposure audits, or agent-driven risk reports that need protocol-by-protocol USD totals across chains. Setup requires the npm nansen-cli package, a nansen binary on PATH, and a NANSEN_API_KEY environment variable; agents run commands through Bash with the nansen:* tool allowance. Results may be empty for wallets without DeFi positions indexed by Nansen.
- DeFi position queries
- portfolio exposure
- Nansen CLI
- on-chain balances
- treasury visibility
Nansen Defi Positions by the numbers
- 365 all-time installs (skills.sh)
- +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #38 of 479 Web3 & Blockchain skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/nansen-ai/nansen-cli --skill nansen-defi-positionsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 365 |
|---|---|
| repo stars | ★ 127 |
| Last updated | August 4, 2026 |
| Repository | nansen-ai/nansen-cli ↗ |
What DeFi positions does a wallet hold across protocols?
Query and summarize on-chain DeFi positions through Nansen CLI for portfolio review, exposure checks, and agent-driven treasury or risk reporting.
Who is it for?
Developers building agent workflows that audit treasury wallets, lending collateral, or multi-protocol DeFi exposure through the Nansen CLI.
Skip if: Developers who need historical portfolio charts, spot-only wallet balances, or on-chain analytics without a Nansen API key and subscription.
When should I use this skill?
A wallet address is provided and the task requires current DeFi lending, LP, staking, or protocol-level exposure with USD debt and reward totals.
What you get
Protocol-by-protocol DeFi breakdown with per-chain USD assets, debts, rewards, and token holdings
- Protocol-by-protocol DeFi position breakdown
- USD totals for assets, debts, and rewards per chain
By the numbers
- Documents 7 DeFi position output fields: protocol_name, chain, total_value_usd, total_assets_usd, total_debts_usd, total
- Requires 1 API key (NANSEN_API_KEY) and 1 CLI binary (nansen) from the nansen-cli npm package
Files
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
nansen research profiler balance --address $ADDR --chain ethereum
# → token_symbol, token_name, token_amount, value_usd per holding
nansen research profiler balance --address $ADDR --chain baseCombine DeFi positions (lending, LPs, staking) with spot balances for a complete picture of on-chain exposure.
Note: portfolio defi may return empty for wallets with no tracked DeFi positions.
Related skills
Solidity SecurityCatch and fix critical Solidity vulnerabilities like reentrancy before deploying smart contracts.13k38.4k
Extension Http OutcallsEnable their Internet Computer backend canister to make secure HTTP GET and POST requests to external APIs.10.3k
Okx Dapp DiscoveryCorrectly route Chinese-language DeFi and on-chain queries to the right protocol plugins inside an agent workflow.9.5k315Okx Growth CompetitionGuide users through OKX OnchainOS competition reward status checks, atomic claims, and post-win contact collection via the onchainos CLI.9.1k315Okx Agent Payments ProtocolLet their AI agent create and fulfill on-chain payment links without leaving the coding session.8.7k315
Query Token InfoGive your coding agent a Node CLI to search Binance tokens and pull metadata while you build crypto or DeFi features.6.1k946How it compares
Choose nansen-defi-positions for live protocol-level DeFi exposure; use companion Nansen profiler or portfolio skills when historical balances or spot-only holdings are needed.
FAQ
What command does nansen-defi-positions use?
nansen-defi-positions documents `nansen research portfolio defi --wallet <address>`, which returns protocol_name, chain, USD totals for assets and debts, rewards, and token holdings per DeFi protocol.
What does nansen-defi-positions require to run?
nansen-defi-positions requires the nansen-cli npm package, a nansen binary on PATH, a NANSEN_API_KEY environment variable, and Bash access scoped to nansen:* commands.
When does nansen-defi-positions return empty results?
nansen-defi-positions may return empty output when the wallet has no DeFi positions indexed by Nansen's portfolio tracker, even if the address holds spot tokens elsewhere.