emblem-portfolio-tracker

name	emblem-portfolio-tracker
description	Track crypto portfolio across 7 blockchains via EmblemAI. Aggregated balances with USD values, conditional trade P&L, and DeFi position tracking via Nansen. Use when the user wants to check their portfolio, see balances across chains, or review trade positions.
license	MIT
compatibility	Requires Node.js >= 18.0.0, @emblemvault/agentwallet CLI, and internet access. Works on Claude Code, Cursor, Codex, OpenClaw, and other agents following the Agent Skills spec.
metadata	{"author":"EmblemAI","version":"1.1.0","homepage":"https://emblemvault.ai","docs":"https://emblemvault.ai/docs","docs-interactive":"https://emblemvault.dev"}

Emblem Portfolio Tracker

Cross-chain crypto portfolio monitoring powered by EmblemAI. Aggregated balances with USD values across Solana, Ethereum, Base, BSC, Polygon, Hedera, and Bitcoin. Conditional trade P&L tracking and DeFi position viewing via Nansen.

Requires: npm install -g @emblemvault/agentwallet

---

What This Skill Can Do

Capability	Tools Used
Wallet addresses (all chains)	wallet
Solana balances + USD values	solanaBalances
Ethereum balances + USD values	ethGetBalances
Base balances + USD values	baseGetBalances
BSC balances + USD values	bscGetBalances
Polygon balances + USD values	polygonGetBalances
Hedera balances	hederaGetBalances
Bitcoin balances	getBTCBalances
Crypto price lookup	getCryptoPrice
Conditional trade positions & P&L	getAllPositions, listPositions
DeFi positions (LP, staking, farming)	nansen_defi_portfolio

Not Supported

These features have no backing tools:

• Transaction history — no tool returns past wallet transactions on any chain
• Tax reporting / transaction exports — no historical transaction data available
• Unrealized P&L on held tokens — only realized P&L from conditional trade positions
• 24h portfolio change — no historical balance snapshots; only current balances
• Portfolio allocation percentages — agent must compute from individual chain balance calls

---

Quick Start

npm install -g @emblemvault/agentwallet

# Check balances across all chains
emblemai --agent --profile default -m "Use wallet to show my addresses, then use solanaBalances, ethGetBalances, baseGetBalances, bscGetBalances, polygonGetBalances, hederaGetBalances, and getBTCBalances to show all my balances"

# Check trade positions
emblemai --agent --profile default -m "Use getAllPositions to show my open and closed trade positions with P&L"

Trigger phrases:

• "Check my portfolio"
• "Show balances across all chains"
• "What's my P&L?"
• "Show my trade positions"

---

Workflow: Full Portfolio Review

Step 1: Wallet Addresses

emblemai --agent --profile default -m "Use wallet to list all my wallet addresses across every chain"

Step 2: Balance Snapshot

Check each chain. Name the tools explicitly for reliable execution.

emblemai --agent --profile default -m "Use solanaBalances to show my Solana tokens with USD values"
emblemai --agent --profile default -m "Use ethGetBalances to show my Ethereum tokens with USD values"
emblemai --agent --profile default -m "Use baseGetBalances to show my Base tokens"
emblemai --agent --profile default -m "Use bscGetBalances to show my BSC tokens"
emblemai --agent --profile default -m "Use polygonGetBalances to show my Polygon tokens"
emblemai --agent --profile default -m "Use hederaGetBalances to show my Hedera tokens"
emblemai --agent --profile default -m "Use getBTCBalances to show my Bitcoin balance"

Or ask for all at once:

emblemai --agent --profile default -m "Show my balances across all chains with USD values. Use the balance tools for each chain: solanaBalances, ethGetBalances, baseGetBalances, bscGetBalances, polygonGetBalances, hederaGetBalances, getBTCBalances"

Step 3: Trade Positions & P&L

emblemai --agent --profile default -m "Use getAllPositions to show my conditional trade positions with realized P&L"

Note: P&L data only covers conditional trade positions (limit orders, stop-losses, take-profits) created through EmblemAI. General wallet holdings do not have cost basis tracking.

Step 4: DeFi Positions (Optional)

For wallets indexed by Nansen (typically high-value wallets):

emblemai --agent --profile default -m "Use nansen_defi_portfolio to check DeFi positions for wallet [ADDRESS] on [CHAIN]"

---

Use Cases

Daily Check-In

emblemai --agent --profile default -m "Quick portfolio check — use solanaBalances, ethGetBalances, and getBTCBalances to show my main holdings"

Chain-Specific Deep Dive

emblemai --agent --profile default -m "Use solanaBalances to show all my Solana token balances with current prices"
emblemai --agent --profile default -m "Use ethGetBalances to show my Ethereum positions"

Trade Performance

emblemai --agent --profile default -m "Use getAllPositions to show my closed positions with realized P&L and win/loss rate"

Price Check

emblemai --agent --profile default -m "Use getCryptoPrice to show current prices for BTC, ETH, SOL, and BNB"

---

Communication Tips

Name the exact tools for reliable execution:

Bad	Good
"balances"	"Use solanaBalances and ethGetBalances to show my balances"
"PnL"	"Use getAllPositions to show my trade positions with realized P&L"
"portfolio"	"Use wallet to show addresses, then check balances on each chain"

---

Helper Script

bash scripts/portfolio-report.sh

See scripts/portfolio-report.sh for a ready-to-use portfolio report.

---

Links

• Agent Wallet CLI
• EmblemVault Docs — canonical
• EmblemVault Docs — interactive