Ethereum
Polygon
Ethereum
EthereumAnatomy of the Wallet NFTs endpoint
Returns the individual NFT positions held by a wallet, each with its media, name, collection, and estimated value based on the collection floor price. Sort by floor price and filter by collection to build rich NFT galleries.
curl "https://api.zerion.io/v1/wallets/0xabc.../nft-positions/" \
-H "authorization: Basic <API_KEY>" \
-G -d "currency=usd" -d "sort=-floor_price"{
"data": [
{
"type": "nft-positions",
"attributes": {
"nft_info": {
"name": "V1 PUNK #1763",
"interface": "ERC721"
},
"collection_info": {
"name": "CryptoPunks V1 (wrapped)"
},
"value": 4439
}
}
]
}Key parameters
addresspathEVM or Solana wallet address to read NFTs for.currencyqueryDenomination for floor-price values. Defaults to usd.sortqueryOrder results, e.g. -floor_price for highest value first.filter[collection_ids]queryRestrict results to specific collections by id.What the Wallet NFTs response gives you
One request returns enriched, ready-to-render fields — no decoding, pricing, or post-processing on your side.
NFT media
Preview, detail, audio and video URLs with their content types.
nft_info.contentCollection info
Name, description, icon and banner for every collection.
collection_infoFloor-price value
Per-item floor price and total value in your currency.
valueStandard & IDs
ERC-721 vs ERC-1155, contract address and token id.
interfaceAmount held
Quantity for multi-edition ERC-1155 holdings.
amountSpam flag
Spam NFTs are flagged so galleries stay clean.
flags.is_spamBuilt for production
Everything the Wallet NFTs endpoint gives you to ship a real integration — filters, coverage, and predictable limits.
Rank by value out of the box
Sort by floor price or recency and scope to the chains or collections you want.
- sort=-floor_price — most valuable first
- filter[collections_ids] — one or many collections
- filter[chain_ids] — up to 25 chains
Everything a gallery needs
Rich media and collection metadata come resolved — no separate metadata fetch.
- preview / detail / audio / video with MIME types
- Collection icon + banner
- include=nfts,nft_collections for full detail
Cursor paging up to 500
Walk large collections efficiently with stable cursors.
- page[size] up to 500 (default 50)
- page[after] cursor
- Follow links.next
Predictable warm-up
New wallets index on first read, then serve instantly.
- 202 while indexing — poll until 200
- Stop after ~2 minutes
- X-Env: testnet header for test data
What teams build with it
From dashboards to autonomous agents, teams reach for the Wallet NFTs endpoint to ship faster.
NFT galleries
Render a wallet's NFTs with media and metadata, ready to display, no indexing.
Portfolio valuation
Include floor-price NFT value alongside tokens for a complete net-worth view.
Marketplaces & tools
Power collection views and holdings pages from one enriched schema.
Bring NFTs into your product
Everything you need to ship NFTs — holdings, valuation, and rich media — behind one endpoint, spam-filtered and ready to render.
NFTs for any wallet
One call returns every NFT an address holds. Filter by chain and collection, sort by floor price or recency.
Read the docsPortfolio-grade valuation
Value NFT holdings across 26+ chains — Ethereum, Base, Blast, Zora and more — in ETH, USD, or any currency, alongside tokens.
Read the docsMedia-rich and spam-free
Full metadata for ERC-721 and ERC-1155 plus dynamic media — render image, audio, and video NFTs, with spam collections flagged out.
Read the docsThe same NFT infrastructure behind Zerion Wallet and 200+ products — production-ready, spam-filtered, and regularly audited by industry-leading security firms.
Other endpoints
NFTs Held by an Address
Read EVM & Solana NFT holdings with metadata, floor price, and collection data.
EthereumPolygonEthereumEthereumOne API, every major chain
Ethereum, Base, Solana, Arbitrum and 45+ more networks — queried in a single call.
Ethereum
Base
Solana
Arbitrum
OptimismEthereumBaseSolanaArbitrumOptimismEthereumBaseSolanaArbitrumOptimismEthereumBaseSolanaArbitrumOptimismEthereumBaseSolanaArbitrumOptimismEthereumBaseSolanaArbitrumOptimism
Polygon
Avalanche
BNB Chain
Robinhood
Linea
ScrollPolygonAvalancheBNB ChainRobinhoodLineaScrollPolygonAvalancheBNB ChainRobinhoodLineaScrollPolygonAvalancheBNB ChainRobinhoodLineaScrollPolygonAvalancheBNB ChainRobinhoodLineaScrollPolygonAvalancheBNB ChainRobinhoodLineaScroll
Zora
Celo
Gnosis
Fantom
Aurora
HyperEVMZoraCeloGnosisFantomAuroraHyperEVMZoraCeloGnosisFantomAuroraHyperEVMZoraCeloGnosisFantomAuroraHyperEVMZoraCeloGnosisFantomAuroraHyperEVMZoraCeloGnosisFantomAuroraHyperEVMWhy builders choose the
Wallet NFTs API
Ship faster
Go live in minutes, not months
Grab a free key, paste one request, and you're serving portfolio data. No nodes, no indexers, no infra to maintain.
Speed
Fast everywhere your users are
A globally cached edge keeps every query fast, so your app feels instant no matter where your users open it.
Freshness
Balances update in seconds
Balances, positions, and transactions land within seconds of confirmation. Never stale, never guessing.
Scale
Scale from one user to millions
One request spans Solana, Ethereum, Base and 50+ chains. The same endpoint carries your first user and your millionth.
Built for Consumer Scale and Enterprise Reliability
The same infrastructure that runs the Zerion wallet — sized for everything from a first prototype to fintech products in production.
Stay ahead with the Zerion API
New endpoints, chains, and webhooks — straight to your inbox.
Simple, transparent tiers
Start building for free. Upgrade as you scale.
DeFi Positions, Wallet Portfolio Chart, and Wallet P&L endpoints are limited to 25% of every plan quota and aren’t covered by overages.
For early prototypes and proofs of concept
Get started free- 2K requests / day
- 3 RPS limit
- Chat widget
- Best effort support
For shipping MVP without running any Infrastructure
Start building- Up to 250K requests / month
- 10 RPS
- Telegram group
- Priority support
For apps preparing for launches or already in production
Start building- Up to 1M requests / month
- 25 RPS
- Slack or Telegram channel
- Priority support
Custom pricing & features
For scale-ups & enterprises with high volume or custom needs
Contact salesWhat can you build?
Wallets & Stablecoins
Power portfolio views, transaction history, and in-app swaps with one API — across every chain and stablecoin your users hold.
Fintech & Neobanks
Add portfolio charts, PnL, and transaction history to your app — no blockchain node to stand up, no infra to maintain.
AI Agents
Wallet holdings, DeFi positions, and PnL in a single call. Pay per request with x402 on Base — no subscriptions, no keys.
.da6f4144.webp)
Trusted by the companies you know
From multichain wallets to onchain apps — teams build on Zerion API.
“Zerion API powers Kraken 2.0 with reliable token balances, P&L, and transaction history through one consolidated integration, making it easier to scale to more users.”
“We've worked with Zerion API since day zero, even before launching Uniswap Wallet. From multichain positions to EIP-7702 batching, they've been key partners.”
“Add a fresh customer quote here — pulled from the cleaned-up testimonials doc.”
“Add a fresh customer quote here — pulled from the cleaned-up testimonials doc.”
Built for developers.
Trusted by enterprises.
Give wallets, AI agents, and consumer apps reliable access to wallets, positions, transactions, and DeFi data across chains.
FAQ
If you have any questions