Anatomy of the DeFi Positions endpoint
Returns a wallet's fungible positions: simple token balances plus decoded DeFi protocol positions (deposited, staked, borrowed, locked, and reward assets) with prices, labels, and protocol metadata resolved for you.
curl "https://api.zerion.io/v1/wallets/0xabc.../positions/" \
-H "authorization: Basic <API_KEY>" \
-G -d "filter[chain_ids]=base" -d "currency=usd"{
"data": [
{
"type": "positions",
"attributes": {
"name": "LAGOON",
"position_type": "deposit",
"quantity": {
"float": 58.98
},
"value": 114569.34,
"fungible_info": {
"symbol": "WETH"
},
"chain": "ethereum"
}
}
]
}Key parameters
addresspathEVM or Solana wallet address to read positions for.filter[chain_ids]queryComma-separated chain slugs to scope results, e.g. base,ethereum.filter[position_types]querydeposit, loan, staked, locked, reward, and more.currencyqueryDenomination for values. Defaults to usd.What the DeFi Positions response gives you
One request returns enriched, ready-to-render fields — no decoding, pricing, or post-processing on your side.
Every position type
Deposits, loans, staked, locked, rewards and wallet balances in one list.
position_typeDecoded amounts & value
Raw and human-readable quantity plus current value, priced for you.
quantity.floatProtocol & module
Know the protocol and what the position does — lending, yield, LP, farming.
protocol_moduleGrouped LP legs
Liquidity pools return one object per token, linked so you can group them.
group_idFull asset info
Name, symbol, icon, verification and market data on every asset.
fungible_infoSpam filtering
Trash assets are flagged and filtered out by default.
flags.is_trashBuilt for production
Everything the DeFi Positions endpoint gives you to ship a real integration — filters, coverage, and predictable limits.
Seven ways to scope the response
Narrow results to the chains, protocols, position types or assets you care about — up to 25 values each.
- filter[chain_ids] — up to 25 chains
- filter[position_types] — deposit, loan, staked, locked, reward…
- filter[dapp_ids] — scope to specific protocols
- filter[trash] — hide or isolate spam
4,500+ protocols, one schema
Positions across thousands of DeFi protocols are decoded into the same shape, so you write integration code once.
- 4,500+ protocols decoded
- deposit, lending, yield, liquidity_pool, staked, farming, vesting, rewards
- Protocol name + module on every position
Pools you can actually render
A pool returns one position per underlying token, each sharing a group_id — group by it for a clean, unified pool card.
- One object per token in the pool
- Same group_id across legs
- Distinct symbols and values per leg
Multi-chain, non-paginated
Returns all matching positions in a single response across every supported chain.
- EVM + Solana (wallet positions on Solana)
- sort=value or -value
- 503 with Retry-After while warming up
What teams build with it
From dashboards to autonomous agents, teams reach for the DeFi Positions endpoint to ship faster.
DeFi dashboards
Show a wallet's active positions across every protocol in one unified list.
Risk & monitoring
Track lending, borrowing, and LP exposure across chains for alerts and health checks.
Yield trackers
Surface staked and reward positions with live valuations, no protocol-specific code.
Other endpoints
DeFi & Protocol Positions
Fetch active EVM & Solana DeFi positions, rewards, and liquidity pools across 4,500+ protocols.
One 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
DeFi Positions 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.
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 salesDeFi Positions, Wallet Portfolio Chart, and Wallet P&L endpoints are limited to 25% of every plan quota and aren’t covered by overages.
What 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