Portfolio Overview
Display a comprehensive DeFi portfolio dashboard aggregating token balances, staking positions, and lending positions — all with USD valuations. This is a read-only, single-command skill that provides a complete snapshot of the user's Starknet DeFi activity.
Prerequisites
- Active session required.
Rules
- Use this as the FIRST command when the user asks "what do I have?" or wants an overall assessment.
- This is a read-only operation — it never modifies any on-chain state.
- USD prices are sourced from Fibrous aggregation and may have slight variations.
Commands
npx starkfi@latest portfolio [--json]
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
--json | flag | Output as JSON | No |
Dashboard Sections
The portfolio displays three sections:
- Token Balances — STRK, ETH, and all ERC-20 tokens with non-zero balances and their USD values.
- Staking Positions — Active stakes across all validators/pools with pending rewards. Shows unpooling amounts and cooldown dates when exit intents are active.
- Lending Positions — Active Vesu V2 positions: supplied and borrowed amounts with pool details.
Examples
User: "Show me my portfolio"
npx starkfi@latest portfolio
User: "What's my total value on Starknet?"
npx starkfi@latest portfolio
User: "Get my portfolio as JSON for analysis"
npx starkfi@latest portfolio --json
Error Handling
| Error | Action |
|---|---|
Not authenticated | Run authenticate-wallet skill first. |
Partial failure | Some sections may show errors while others succeed. The portfolio uses fault-tolerant aggregation. |
Network error | Retry once. Use config to set custom RPC. |
Related Skills
- Use
balancefor a focused view of token balances only. - Use
stakingstake-statusfor detailed staking positions. - Use
lendinglend-statusfor detailed lending positions.