{"uid":"cap_vpnm4QBO0_rTRkTv6cXIH","slug":"evm-wallet-portfolio-totals-d28702ee","name":"EVM Wallet Portfolio Totals","description":"Hosted wallet portfolio totals for EVM agents: native balance, curated token totals, freshness, provenance, and risk flags before routing funds. Price 0.20 USDC on Base via x402. Demo: https://wallet-portfolio-history-mcp.mtree.workers.dev/demo/tools/portfolio_totals. Contact: https://wallet-portfolio-history-mcp.mtree.workers.dev/contact.","url":"https://wallet-portfolio-history-mcp.mtree.workers.dev/tools/portfolio_totals","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":"ethereum","limit":10,"address":"0x1234567890123456789012345678901234567890","refresh":false},"type":"http","method":"POST","bodyType":"json"}},"response":{"ok":true,"chain":"ethereum","route":"/tools/portfolio_totals","result":{"risk_flags":{"chain":"ethereum","no_recent_base_txs":false,"native_balance_error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_getBalance\",\"params\":[\"0x1234567890123456789012345678901234567890\",\"latest\"]}\n\nDetails","curated_defi_position_count":0,"curated_token_nonzero_count":0,"recent_protocol_interaction_count":0},"native_balance":"0","native_balance_wei":"0","curated_token_nonzero_count":0},"address":"0x1234567890123456789012345678901234567890","service":"wallet-portfolio-history-mcp","freshness_score":75,"source_coverage":{"rpc_native_balance":false,"dataset_writes_to_d1":true,"curated_erc20_balances":3,"protocol_watchlist_size":3,"rpc_native_balance_error":"HTTP request failed.\n\nStatus: 521\nURL: https://eth.llamarpc.com/\nRequest body: {\"method\":\"eth_getBalance\",\"params\":[\"0x1234567890123456789012345678901234567890\",\"latest\"]}\n\nDetails","transaction_history_source":"blockscout","curated_defi_receipt_tokens":3,"transaction_history_supported":false},"dataset_fresh_at":"2026-06-18T05:09:57.000Z"}},"exampleRequest":{"chain":"ethereum","limit":10,"address":"0x1234567890123456789012345678901234567890","refresh":false},"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_W-iTx0X22XZ4uEo9WwSoX","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 native balance, curated ERC-20 token totals, freshness metadata, provenance details, and risk flags for an EVM wallet address to support pre-routing fund diligence.","exampleAgentPrompt":"Before I route 50 USDC to wallet 0xAbC123...def on Base, can you pull its native balance, curated token totals, freshness, and any risk flags so I know it's safe to proceed?","exampleUseCases":null,"resultDescription":"Returns an aggregated portfolio snapshot for the queried EVM wallet including: native ETH/gas-token balance, curated ERC-20 token totals with USD values, data freshness timestamp, provenance sources (e.g. Blockscout), and risk flags that may indicate suspicious activity or unusual holdings — suitable for pre-routing diligence.","failureModes":["Invalid or malformed wallet address returns a 400 error","Unsupported chain/network returns an error or empty result","Stale data if the D1 snapshot has not refreshed recently — check freshness field","Payment not processed (x402 flow failure) results in 402 response","Rate limiting or upstream data provider outage returns 5xx error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to perform pre-routing wallet diligence on an EVM address — specifically when you need a combined view of native balance, token holdings, freshness, and risk flags in a single call. Prefer this over raw RPC calls when curated aggregation, provenance metadata, and risk context are needed together. Best suited for Base network wallets. Pairs well with sibling endpoints for deeper risk scoring or DeFi position analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:44.480Z","isFirstParty":false}