{"uid":"cap_VXTQt_fL_qUw3tUeK8tV6","slug":"onchainexpat-defi-positions-api-68340cbd","name":"OnchainExpat DeFi Positions API","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-crypto/defi-positions","method":"POST","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"Blockchain (default: all)"},"address":{"type":"string","description":"EVM wallet address (0x + 40 hex chars) or ENS name (e.g. 'vitalik.eth')"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"chain":{"type":"string"},"address":{"type":"string"},"positions":{"type":"array","description":"List of DeFi positions by protocol"},"protocols":{"type":"array","description":"Protocols with active positions"},"ai_analysis":{"type":"object","description":"AI-powered strategy insights and recommendations"},"total_value_usd":{"type":"number","description":"Total value of all DeFi positions"}}},"success":{"type":"boolean"}}},"example":{"request":{"address":"0x1234567890123456789012345678901234567890"},"response":{"data":{"chain":"all","address":"0x1234567890123456789012345678901234567890","summary":{"total_protocols":4,"chains_with_value":19,"total_protocol_value_usd":85.59848993678995},"protocols":[{"name":"clanker world","category":"Reward","positions":[{"type":"reward","value_usd":0.00020671932638964546,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.0006386283724340001,"description":"Coinbase Wrapped BTC (cbBTC)"},{"type":"reward","value_usd":0.012910774818269688,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013332723705160292,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013801991413209473,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013801991413209473,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.013801991413209473,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.016665904631450797,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":0.4915717261729284,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":4.906607947396582,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":5.0780976907057305,"description":"Wrapped Ether (WETH)"},{"type":"reward","value_usd":36.88934920978142,"description":"Wrapped Ether (WETH)"}],"value_usd":47.517450917675795},{"name":"FOXIFY","category":"Deposit","positions":[{"type":"deposit","value_usd":21.037524511961248,"description":"Foxify (FOX)"}],"value_usd":21.037524511961248},{"name":"PancakeSwap","category":"Deposit","positions":[{"type":"deposit","value_usd":17.027456215428348,"description":"Wrapped BNB (WBNB)"}],"value_usd":17.027456215428348},{"name":"Superfluid","category":"Deposit","positions":[{"type":"deposit","value_usd":0.0160582917245608,"description":"USDC (USDC)"}],"value_usd":0.0160582917245608}],"top_tokens":[{"price":"$1,726.12","token":"Ethereum (ETH)","amount":"17.3734","value_usd":29988.654475040596},{"price":"$1.00","token":"Tether USD (USDT)","amount":"6,305.7764","value_usd":6296.73223611739},{"price":"$588.05","token":"BNB (BNB)","amount":"4.2689","value_usd":2510.3345530495676},{"price":"$1.00","token":"Tether USD (USDT)","amount":"888.4072","value_usd":887.1329473684826},{"price":"$1.00","token":"USDC (USDC)","amount":"530.8819","value_usd":530.5942132572166},{"price":"$1,726.12","token":"Ethereum (ETH)","amount":"0.2677","value_usd":462.07260066866735},{"price":"$0.02","token":"Monad (MON)","amount":"20,024.3143","value_usd":426.4897239678932},{"price":"$69.87","token":"Hyperliquid (HYPE)","amount":"3.8310","value_usd":267.66752035452447},{"price":"$1.00","token":"USDC (USDC)","amount":"217.6305","value_usd":217.5125048129931},{"price":"$0.61","token":"Worldcoin (WLD)","amount":"240.4842","value_usd":147.60291762889315},{"price":"$0.00","token":"DebtReliefBot (DRB)","amount":"2,897,485.2371","value_usd":133.59782475162842},{"price":"$1.00","token":"USDC (Polygon) (USDC.e)","amount":"94.1479","value_usd":94.08434026686459},{"price":"$1.00","token":"USDC (USDC)","amount":"92.9489","value_usd":92.89848294041525},{"price":"$69.84","token":"Wrapped HYPE (WHYPE)","amount":"0.8506","value_usd":59.406733008012694},{"price":"$1.00","token":"USDC (USDC)","amount":"50.7946","value_usd":50.76708536147342},{"price":"$1,726.12","token":"Ethereum (ETH)","amount":"0.0157","value_usd":27.05190518093208},{"price":"$1.00","token":"USDT0 (USDT0)","amount":"26.4857","value_usd":26.44851802096183},{"price":"$1.00","token":"USDT0 (USDT0)","amount":"22.4908","value_usd":22.459200129124863},{"price":"$1,726.12","token":"Ethereum (ETH)","amount":"0.0116","value_usd":19.996599625200005},{"price":"$63,759.95","token":"Wrapped BTC (WBTC)","amount":"0.0003","value_usd":19.493328604442418},{"price":"$1.00","token":"Dai Stablecoin (DAI)","amount":"17.0000","value_usd":16.9879408902},{"price":"$1.00","token":"Dai Stablecoin (DAI)","amount":"16.7164","value_usd":16.70449394378527},{"price":"$1,725.25","token":"Wrapped Ether (WETH)","amount":"0.0076","value_usd":13.134837653275103},{"price":"$63,759.95","token":"Wrapped BTC (WBTC)","amount":"0.0001","value_usd":7.906871030768666},{"price":"$0.00","token":"Mdex (MDX)","amount":"12,389.9859","value_usd":7.02304179284954},{"price":"$0.80","token":"Augur (REP)","amount":"5.3816","value_usd":4.303252472095921},{"price":"$1.80","token":"Livepeer Token (LPT)","amount":"2.1555","value_usd":3.8830494675835907},{"price":"$1.00","token":"USDC (USDC)","amount":"3.4500","value_usd":3.44813010828},{"price":"$1.00","token":"USD Coin (Base) (USDbC)","amount":"2.9389","value_usd":2.9363359907023328},{"price":"$0.08","token":"Polygon (POL)","amount":"25.2916","value_usd":1.9087409769043107}],"ai_analysis":{"success":true,"summary":"Wallet has positions across 4 DeFi protocols totaling $85.60.","ai_model":"heuristic","ai_provider":"fallback","defi_profile":"moderate","risk_assessment":"Varies by position"},"chain_breakdown":{"0g":0.00002805235294,"ape":0.021286789443586838,"ink":0.034519600000000004,"base":757.7542659922931,"celo":0.01490484325432,"xdai":0.00458576536365718,"monad":426.4897239678932,"sonic":21.134154490309232,"tempo":0.009993769395999998,"world":147.63780814149067,"plasma":1.0746019000337599,"polygon":390.42530819532993,"abstract":0.0000017259800000000002,"arbitrum":580.2854976226904,"ethereum":30892.210769737285,"hyperevm":327.0620222629587,"optimism":23.84196411945183,"avalanche":3.638981630068053,"binance-smart-chain":8882.454225168434},"wallet_tokens_usd":42370.464452495515,"total_portfolio_usd":42454.094643774035},"cached":false,"source":"zerion","success":true,"timestamp":"2026-06-18T06:14:11.566201+00:00"}},"exampleRequest":{"address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o5KlTuXoOhho7UEs1yAzj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches DeFi portfolio positions and holdings for a given wallet or address across decentralized finance protocols","exampleAgentPrompt":"Can you pull up all the DeFi positions for my wallet 0xAbc123...def456 — I want to see what liquidity pools, yield farms, and token holdings I have across protocols?","exampleUseCases":null,"resultDescription":"A JSON object containing the DeFi positions associated with the queried wallet, including protocol names, token pairs, liquidity pool shares, staked amounts, and estimated portfolio values across DeFi protocols.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported blockchain network or protocol returns empty or partial results","Payment not fulfilled via x402 protocol results in 402 Payment Required response","Rate limiting or network timeout may return a 5xx error","Wallet with no DeFi activity returns empty positions array"],"whenToPreferThis":"Use this endpoint when you need to look up on-chain DeFi positions for a specific wallet address and are willing to pay per request via the x402 micropayment protocol. Best suited for agents that need real-time DeFi portfolio data without managing API keys or subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:56:11.817Z","isFirstParty":false}