NFT portfolio
NFT + wallet snapshot: NFT holdings, native balance, and ETH price for a given address in one call.
$0.15
per call · one payment for the whole workflow
POST /api/skill/nft-portfolio
3 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
Quick portfolio view - what NFTs does this address hold, what's the wallet balance, and what's ETH worth.
Tools in this pack
All 3 run inside the single $0.15 call above. Each is also callable on its own if you only need one part.
- NFT holdings for an address POST /api/nft-holdings Return the NFTs owned by a wallet address on a given network. Each row carries the collection name, contract address, token ID, image URL (where available), and ERC-721 vs ERC-1155 standard. Up to 100 per call - paginate with `pageKey` from the previous response.
- Wallet balance (native + ERC-20) POST /api/wallet-balance Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, Arbitrum, or Optimism. Returns clean decimal balances (already scaled by token decimals) plus symbol and contract - ready to display in a UI or feed into a portfolio tool.
- Crypto price GET /api/crypto-price Live crypto prices for one or many coins in any vs_currency (usd, eur, btc, eth, etc). Returns last price, 24h change %, 24h volume, and market cap per coin. The simplest crypto price read - for ranked market-cap tables use crypto-market, for candles use crypto-history, and when you need an oracle-grade price with a confidence interval use price-pyth. Accepts ticker symbols (BTC, ETH, SOL) for the top ~50 by market cap, or canonical CoinGecko ids (e.g. "render-token") for any of the ~15k tracked coins. Batched: up to 25 coins per call. Backed by CoinGecko's public API - keyless.
Workflow
- Pull NFT holdings for the address on Base.
- Get the native wallet balance on Base.
- Get ETH price for portfolio valuation.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response:
npx agent402-client call nft-portfolio {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Show me the NFT portfolio for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using Agent402's nft-portfolio skill pack. Get (1) NFT holdings, (2) wallet balance, (3) ETH price. Summarize the collection.