{"uid":"cap_wU_F3hHShoriHJnba3VQx","slug":"defi-balances-protocol-position-snapshot-d05f88be","name":"DeFi Balances & Protocol Position Snapshot","description":"Hosted DeFi balance and protocol-position snapshot for wallet diligence: Aave/Compound receipt-token reads, Aerodrome/Lido coverage, protocol interaction hints, D1 history, freshness, and provenance. Price 0.20 USDC on Base via x402. Demo: https://wallet-portfolio-history-mcp.mtree.workers.dev/demo/tools/defi_balances. Contact: https://wallet-portfolio-history-mcp.mtree.workers.dev/contact.","url":"https://wallet-portfolio-history-mcp.mtree.workers.dev/tools/defi_balances","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"limit":{"type":"integer","maximum":50,"minimum":1},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"refresh":{"type":"boolean"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"chain":"base","limit":10,"address":"0x1234567890123456789012345678901234567890"},"type":"http","method":"POST","bodyType":"json"}},"response":{"ok":true,"chain":"base","route":"/tools/defi_balances","result":{"source":"hosted D1 snapshot + EVM receipt-token reads + Blockscout protocol interaction hints","status":"no_curated_positions_detected","positions":[{"asset":"USDC","error":"HTTP request failed.\n\nStatus: 521\nURL: https://base.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"","market":"Base USDC supply","source":"receipt_token_balanceOf","symbol":"aBasUSDC","address":"0x4e65fE4DbA92790696d040ac24Aa414708F5c0AB","decimals":6,"protocol":"Aave v3","position_type":"supply_receipt_token"},{"asset":"USDC","error":"HTTP request failed.\n\nStatus: 521\nURL: https://base.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"","market":"Base USDC supply","source":"receipt_token_balanceOf","symbol":"cUSDCv3","address":"0x9c4ec768c28520b50860ea7a15bd7213a9ff58bf","decimals":6,"protocol":"Compound v3","position_type":"supply_receipt_token"},{"asset":"AERO","error":"HTTP request failed.\n\nStatus: 521\nURL: https://base.llamarpc.com/\nRequest body: {\"method\":\"eth_call\",\"params\":[{\"data\":\"","market":"AERO voting escrow","source":"receipt_token_balanceOf","symbol":"veAERO","address":"0xeB018363F0a9Af8f91F06FEe6613a751b2A33FE5","decimals":18,"protocol":"Aerodrome","position_type":"governance_lock"}],"interaction_count":0,"supported_protocols":["Aave v3","Compound v3","Aerodrome","Aave","Compound"],"nonzero_position_count":0,"recent_protocol_interactions":[]},"address":"0x1234567890123456789012345678901234567890","service":"wallet-portfolio-history-mcp","freshness_score":75,"source_coverage":{"rpc_native_balance":false,"dataset_writes_to_d1":true,"curated_erc20_balances":2,"protocol_watchlist_size":4,"rpc_native_balance_error":"HTTP request failed.\n\nStatus: 521\nURL: https://base.llamarpc.com/\nRequest body: {\"method\":\"eth_getBalance\",\"params\":[\"0x1234567890123456789012345678901234567890\",\"latest\"]}\n\nDetail","transaction_history_source":"base.blockscout.com","curated_defi_receipt_tokens":3,"transaction_history_supported":true},"dataset_fresh_at":"2026-06-16T18:48:38.000Z"}},"exampleRequest":{"chain":"base","limit":10,"address":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.2","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qeF50q3rYC3IyQXc45LMq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a DeFi balance and protocol-position snapshot for a wallet, including Aave/Compound receipt tokens, Aerodrome/Lido positions, protocol interaction hints, D1 history, freshness, and provenance.","exampleAgentPrompt":"Pull the full DeFi balance and protocol position snapshot for wallet 0x1234...abcd on Base — I need to see any Aave or Compound receipt tokens, Aerodrome and Lido positions, and provenance info for due diligence.","exampleUseCases":null,"resultDescription":"A structured snapshot of the wallet's DeFi holdings including receipt token balances for Aave and Compound, protocol positions for Aerodrome and Lido, protocol interaction hints, cached D1 history, data freshness timestamps, and provenance information — enabling a complete picture of the wallet's DeFi exposure.","failureModes":["Invalid or malformed wallet address returns an error response","Unsupported chain or non-Base address may yield empty or partial results","Stale D1 snapshot may be returned if freshness threshold is exceeded","Payment failure via x402 (insufficient USDC balance or wrong network) blocks the call","Rate limiting or worker timeout on the Cloudflare edge may return a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive DeFi protocol position breakdown for a wallet, specifically including receipt-token reads for Aave/Compound and coverage of Aerodrome/Lido — especially for wallet due diligence, risk assessment pipelines, or portfolio audits where protocol-level provenance and freshness metadata matter. Prefer this over generic balance endpoints when protocol-specific position context and D1 history are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:04.094Z","isFirstParty":false}