{"uid":"cap_IXrFidvgzzR_gkC6vqD0-","slug":"agenttoll-base-portfolio-snapshot-79b37fd9","name":"AgentToll Base Portfolio Snapshot","description":"Base-native onchain data for AI agents — gas, token prices by contract, address analytics, DEX pools, new-token radar. From $0.001 a call in USDC via x402. No API keys. Open source.","url":"https://agenttoll.app/api/base/portfolio/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Optional. How many holdings to list, default 20"},"minValue":{"type":"number","minimum":0,"description":"Optional. USD floor per holding, default 1"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"at":"2026-08-05T13:31:58.678Z","chain":"base","shown":1,"native":{"symbol":"ETH","balance":194.68,"priceUsd":1868.57,"valueUsd":363774.32},"source":"blockscout","tokens":[{"name":"Coinbase Wrapped BTC","symbol":"CBBTC","address":"0xcbb7...33bf","balance":5.673857,"priceUsd":64198,"valueUsd":364250.29}],"address":"0x1985...5c87","basename":null,"totalUsd":7143109.27,"unpriced":0,"tokenCount":52,"minValueUsd":10000,"hiddenBelowFloor":48}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AEsFFJD0tMZhYOImkRP2f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a full token portfolio snapshot for a Base address, including ETH balance, ERC-20 holdings with USD values, and aggregate totals","exampleAgentPrompt":"What tokens does Base wallet 0x1985...5c87 hold right now — show me up to 20 holdings worth at least $10 each, with their USD values and the total portfolio value?","exampleUseCases":[{"title":"DeFi portfolio net worth check","prompt":"Can you pull the full portfolio for Base address 0xAbCd...1234 and tell me how much it's worth in USD total, including ETH and all token holdings above $1?"},{"title":"Whale wallet holdings audit","prompt":"I want to see what tokens the wallet 0x1985...5c87 is holding on Base — show me the top 50 positions by value, minimum $100 each, so I can see what a big player is accumulating."},{"title":"Address token screening before transfer","prompt":"Before I send funds, can you check what 0x742d...35Cb already holds on Base? I want the ETH balance, main token balances, and total USD value of the wallet."}],"resultDescription":"A JSON object containing: the timestamp of the snapshot, chain identifier ('base'), ETH native balance with USD price and value, an array of ERC-20 token holdings each with name, symbol, contract address, balance, USD price, and USD value, total portfolio USD value, count of tokens held, count of unpriced tokens, count of holdings hidden below the value floor, and the address's basename if registered.","failureModes":["Invalid address format (not a 0x + 40 hex chars) returns a 400 error","Address not found or never active on Base returns empty token list with zero values","Limit parameter out of range (below 1 or above 50) returns a 400 validation error","Downstream Blockscout outage may cause 503 or stale data","Price data unavailable for exotic tokens results in those tokens counted in 'unpriced' and excluded from totalUsd","Payment not provided or insufficient USDC via x402 results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a complete token portfolio snapshot for a specific Base address, including both native ETH and ERC-20 holdings with live USD prices aggregated in a single call. Prefer it over querying individual token balances separately, or over Ethereum mainnet equivalents when the user specifically cares about Base chain holdings. It is ideal for portfolio valuation, wallet screening, whale monitoring, and onchain net worth calculations on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-07T00:42:13.654Z","isFirstParty":false,"canonicalSlug":"agenttoll-base-portfolio-snapshot-79b37fd9"}