{"uid":"cap_3Bus1qRw3wDzYuS7vSIHW","slug":"nightshift-labs-base-portfolio-lookup-407ec798","name":"Nightshift Labs Base Portfolio Lookup","description":"Base wallet portfolio: ETH plus 12 major Base tokens (USDC, USDbC, DAI, EURC, WETH, cbETH, wstETH, cbBTC, AERO, DEGEN, VIRTUAL, BRETT) with non-zero balances, USD values from Chainlink ETH/USD and BTC/USD feeds, and a total.","url":"https://nightshift-x402.nightshift-labs.workers.dev/v1/base/portfolio?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"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"wallet address on Base"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","prices":{"BTC":75826.24,"ETH":2244.94},"holdings":[{"usd":6734.6,"amount":"2.9999","symbol":"ETH"},{"usd":79709.11,"amount":"79709.10502","symbol":"USDC"},{"usd":null,"amount":"3.0187","symbol":"AERO"}],"totalUsdPriced":86463.08}},"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_S4uxx_fd-uQx7AedtY51r","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 token holdings and USD valuations for a given wallet address on the Base blockchain","exampleAgentPrompt":"What tokens does the Base wallet 0x1234567890abcdef1234567890abcdef12345678 hold, and what's the total USD value of the portfolio?","exampleUseCases":[{"title":"Autonomous agent treasury check","prompt":"Look up the current portfolio for the Base wallet 0xAbCd1234567890abcdef1234567890abcdef5678 — tell me what tokens it holds and the total USD value."},{"title":"DeFi portfolio snapshot for reporting","prompt":"Pull the full token holdings and USD valuations for Base address 0x9999aaabbbcccdddeeefff000111222333444555 so I can include them in a weekly performance report."},{"title":"Wallet net worth estimation","prompt":"What's the total value in USD of everything held in this Base wallet: 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef? Break it down by token."}],"resultDescription":"A JSON object containing the chain identifier ('base'), current prices for BTC and ETH in USD, an array of token holdings (each with symbol, amount, and USD value where priced), and the total USD-priced portfolio value across all tokens.","failureModes":["Invalid or malformed wallet address (not matching 0x + 40 hex chars) returns a validation error","Wallet address with no on-chain activity may return empty holdings array","Tokens without available price feeds will return null for the USD value field","Network or RPC issues with Base may cause lookup failures","Payment failure via x402/USDC on Base will prevent the call from completing"],"whenToPreferThis":"Use this endpoint when you need to look up on-chain token holdings and USD valuations specifically for a Base network wallet address. It is well-suited for AI agents that need to assess portfolio composition, net worth, or asset allocation for a given address without connecting directly to an RPC node. At $0.01 USDC per call via x402, it is cost-effective for single-address spot checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:56:47.044Z","isFirstParty":false,"canonicalSlug":"nightshift-labs-base-portfolio-lookup-407ec798"}