{"uid":"cap_BNjgfxBjpEOsybaIZHMKl","slug":"basebrief-x402-base-address-state-gas-balances-tokens-allowances-0bb7a93d","name":"BaseBrief x402 — Base Address State (Gas, Balances, Tokens, Allowances)","description":"Gas, balances, token metadata and allowances for $0.004 per result.","url":"https://basebrief-x402.savannah-5966.chatgpt.site/api/v1/base/address","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Base mainnet address address."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["evidence","limitations"],"properties":{"evidence":{"type":"object","additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"evidence":{"chain":"Base mainnet","chainId":8453,"blockNumber":"35123456","pointInTime":true},"limitations":["Point-in-time direct Base JSON-RPC evidence."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_WnqUyWZZhD-UMua9Ucqxq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns point-in-time on-chain state for a Base mainnet address: ETH/token balances, gas data, token metadata, and ERC-20 allowances.","exampleAgentPrompt":"What's the current ETH balance, token holdings, and any ERC-20 allowances for Base address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 right now on Base mainnet?","exampleUseCases":[{"title":"Pre-transaction wallet validation","prompt":"Before I send that USDC transfer on Base, check the current balance and USDC allowance for my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — I want to make sure I have enough and the allowance is set correctly."},{"title":"DeFi portfolio snapshot on Base","prompt":"Give me a full snapshot of what tokens and ETH are held by 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base mainnet, including any token metadata like decimals and symbols."},{"title":"Gas budget check before agent transaction","prompt":"What are the current gas prices on Base, and does wallet 0x1111222233334444555566667777888899990000 have enough ETH to cover a typical transaction right now?"}],"resultDescription":"A JSON object with point-in-time on-chain evidence: chain name, chain ID (8453), current block number, ETH balance, ERC-20 token balances with metadata (symbol, decimals, name), and spender allowances for the queried address. Also includes a limitations array noting the point-in-time nature of the data.","failureModes":["Invalid or malformed address (not matching ^0x[0-9a-fA-F]{40}$) returns a validation error","Address not found or zero-balance address may return empty token/balance arrays","Payment not included or insufficient (x402 payment required) returns 402 Payment Required","Base RPC node temporarily unavailable may cause timeout or 503","Rate limiting if too many requests in a short window"],"whenToPreferThis":"Choose this endpoint when you need live, point-in-time on-chain state for a specific Base mainnet address — especially gas prices, token balances, ERC-20 allowances, and token metadata — without running your own Base RPC node. Ideal for AI agents that need to verify wallet state before executing transactions or reporting portfolio data on Base (chain ID 8453). Prefer this over generic Ethereum endpoints when the target chain is specifically Base mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:47.289Z","isFirstParty":false}