{"uid":"cap_dPXN-b3ZMrufHpiS61MsA","slug":"nansen-defi-holdings-cc727aef","name":"Nansen DeFi Holdings","description":"Get simplified DeFi holdings for a wallet address with aggregated tokens\n        and protocol summaries in a user-friendly format.","url":"https://api.nansen.ai/api/v1/portfolio/defi-holdings?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"PortfolioDefiHoldingsRequest","required":["wallet_address"],"properties":{"address":{"anyOf":[{"type":"string"}],"title":"Address","deprecated":true,"description":"Deprecated: Use 'wallet_address' instead. Alias of `wallet_address`. If you send both fields, they must contain the same address."},"wallet_address":{"type":"string","title":"Wallet Address","examples":["0x4062b997279de7213731dbe00485722a26718892"],"description":"Wallet address to get DeFi holdings for"}},"description":"Request model for portfolio DeFi holdings endpoint."},"responseSchema":{"type":"object","title":"PortfolioDefiHoldingsResponse","required":["summary","protocols"],"properties":{"summary":{"type":"object","title":"HoldingsSummary","required":["total_value_usd","total_assets_usd","total_debts_usd","total_rewards_usd","token_count","protocol_count"],"properties":{"token_count":{"type":"integer","title":"Token Count","description":"Total number of unique tokens"},"protocol_count":{"type":"integer","title":"Protocol Count","description":"Total number of protocols"},"total_debts_usd":{"type":"number","title":"Total Debts Usd","description":"Total USD value of all debts"},"total_value_usd":{"type":"number","title":"Total Value Usd","description":"Total USD value of all holdings"},"total_assets_usd":{"type":"number","title":"Total Assets Usd","description":"Total USD value of all assets"},"total_rewards_usd":{"type":"number","title":"Total Rewards Usd","description":"Total USD value of all rewards"}},"description":"Summary statistics for DeFi holdings."},"protocols":{"type":"array","items":{"type":"object","title":"ProtocolHolding","required":["protocol_name","chain","total_value_usd","total_assets_usd","total_debts_usd","total_rewards_usd","tokens"],"properties":{"chain":{"type":"string","title":"Chain","description":"Blockchain network"},"tokens":{"type":"array","items":{"type":"object","title":"ProtocolToken","required":["symbol","amount","value_usd","position_type"],"properties":{"amount":{"anyOf":[{"type":"number"}],"title":"Amount","description":"Token amount"},"symbol":{"anyOf":[{"type":"string"}],"title":"Symbol","description":"Token symbol"},"address":{"anyOf":[{"type":"string"}],"title":"Address","description":"Token contract address (null for native tokens)"},"value_usd":{"anyOf":[{"type":"number"}],"title":"Value Usd","description":"USD value"},"position_type":{"type":"string","title":"Position Type","description":"Position type: deposit, stake, borrow, or mixed"}},"description":"Individual token holding within a protocol."},"title":"Tokens","description":"Token holdings in this protocol"},"protocol_name":{"type":"string","title":"Protocol Name","description":"User-friendly protocol name"},"total_debts_usd":{"type":"number","title":"Total Debts Usd","description":"Total USD value of debts in this protocol"},"total_value_usd":{"type":"number","title":"Total Value Usd","description":"Total USD value in this protocol"},"total_assets_usd":{"type":"number","title":"Total Assets Usd","description":"Total USD value of assets in this protocol"},"total_rewards_usd":{"type":"number","title":"Total Rewards Usd","description":"Total USD value of rewards in this protocol"}},"description":"Holdings summary for a specific protocol."},"title":"Protocols","description":"Protocol-specific holdings with token breakdown"}},"description":"Response model for portfolio DeFi holdings endpoint."},"example":null,"exampleRequest":null,"tags":["blockchain","smart-money","wallet","tokens","defi","analytics","profiler","dex","pnl","onchain","prediction-market","data"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"Nansen","brandSlug":"nansen","brandBaseUrl":"https://nansen.ai","brandDocsUrl":"https://docs.nansen.ai","whatItDoes":"Returns a wallet's aggregated DeFi positions across protocols, including assets, debts, rewards, and token-level breakdowns by chain.","exampleAgentPrompt":"Can you pull up the DeFi holdings for wallet 0x4062b997279de7213731dbe00485722a26718892 — I want to see the total portfolio value, which protocols it's in, what's deposited vs borrowed, and any unclaimed rewards?","exampleUseCases":null,"resultDescription":"Returns a summary object with total_value_usd, total_assets_usd, total_debts_usd, total_rewards_usd, token_count, and protocol_count, plus a list of protocol-level holdings each containing chain, token positions (symbol, amount, USD value, position type: deposit/stake/borrow/mixed), and per-protocol asset/debt/reward totals.","failureModes":["Invalid or malformed wallet address returns a 400 validation error","Wallet address with no DeFi activity may return empty protocols array and zero values","Unsupported chain or newly deployed contracts may be omitted from results","Rate limiting or auth errors return 401/429 if API key is invalid or quota exceeded","Truncated response schema may omit some fields for very large portfolios"],"whenToPreferThis":"Use this endpoint when you need a clean, aggregated view of a wallet's DeFi exposure across protocols and chains — especially for portfolio dashboards, smart money tracking, or risk assessment. Prefer over raw on-chain queries when you need protocol-level summaries, position type classification (deposit/stake/borrow), and USD valuations in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-06-05T03:57:59.639Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:54:22.738Z","isFirstParty":false,"canonicalSlug":"nansen-defi-holdings-cc727aef"}