{"uid":"cap_byyWax8o1UdaDXbJKKZh0","slug":"tracefast-ethereum-address-portfolio-3f971f8b","name":"TraceFast Ethereum Address Portfolio","description":"TraceFast live Ethereum data: everything an address holds, valued in USD — token balances and native ETH, up to 100 positions by USD value, plus totalUsd / pricedCount / hiddenCount over the whole holding. Path address: 0x-prefixed, 40 hex. Query block: integer, state at the end of this block, absent = current; limit: integer 1..100, default 100. Docs: https://docs.tracefast.xyz/api/address-portfolio.md","url":"https://mpp.tracefast.xyz/api/v1/chains/1/entities/:address/portfolio","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_o2I0XPQA1sC_Okq60h6xx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the complete USD-valued token and ETH portfolio for an Ethereum address, with up to 100 positions ranked by value, plus aggregate totals.","exampleAgentPrompt":"What does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently hold on Ethereum — list all token and ETH balances with their USD values and the total portfolio value?","exampleUseCases":[{"title":"Whale wallet portfolio snapshot","prompt":"Pull the full Ethereum portfolio for 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 — I want every token and ETH balance ranked by USD value and the grand total."},{"title":"Historical holdings at specific block","prompt":"Show me what 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 was holding on Ethereum at the end of block 19000000 — all positions with USD values."},{"title":"DeFi protocol treasury check","prompt":"What tokens and ETH does the Uniswap treasury at 0x1a9C8182C09F50C8318d769245beA52c32BE35BC hold right now on Ethereum, and what's the total USD value?"}],"resultDescription":"A ranked list of up to 100 token and ETH positions for the address, each with token symbol, contract address, balance, and USD value. Includes aggregate fields: totalUsd (sum of all valued positions), pricedCount (number of positions with a USD price), and hiddenCount (positions omitted due to spam/dust filters or limit). Positions are ordered by USD value descending.","failureModes":["Invalid or malformed Ethereum address (not 0x-prefixed 40 hex) returns 400 error","Block number that doesn't exist or is in the future returns 400 or 404","Limit outside 1–100 range returns 400 validation error","Address with no holdings returns empty positions array with totalUsd of 0","Payment failure (insufficient USDC balance) returns 402 Payment Required","Network timeout for very active addresses with hundreds of tokens"],"whenToPreferThis":"Use this endpoint when you need a complete, USD-valued snapshot of everything an Ethereum address holds — both ERC-20 tokens and native ETH — in a single call. Prefer it over per-token balance checks when you need portfolio-level aggregation, total net worth, or a ranked view of positions. It supports historical state via block number, making it ideal for point-in-time portfolio analysis. Choose it over generic blockchain explorers when you need structured, agent-ready output with USD valuations already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:35:58.206Z","isFirstParty":false}