EVM ETH and USDC Balance Snapshot
Read native ETH and official USDC balances for a Base, Ethereum, or Arbitrum wallet, with an estimated ETH USD value. This is not a complete token or NFT portfolio.
Preview request
The preview path is rate-limited and does not charge. Production requests use the same parameters and return a standard x402 challenge when no payment signature is present.
curl --request GET \ "https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/wallet_portfolio?preview=true&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&chain=ethereum"
Input contract
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Wallet address (0x format or ENS). |
chain | string | No | Network to scan (default: all supported). |
Guaranteed response metadata
Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract and can be inspected through the preview request where available.
{
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "public EVM JSON-RPC and CoinGecko"
}
}Agent payment flow
Request the product, read the base64 PAYMENT-REQUIRED challenge, sign the exact Base-USDC authorization with an x402 buyer client, and retry using PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.