Live ERC-20 Token Balance
Read one wallet or contract's current ERC-20 balance directly from Base, Ethereum, or Arbitrum, including raw units and contract-supplied token metadata.
Preview request
The preview path is rate-limited and does not charge. It executes the live source and returns the paid response shape while withholding decision-ready values. 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/erc20_balance?preview=true&chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&account=0x0000000000000000000000000000000000000000&block=latest"
Input contract
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | string | No | base, ethereum, or arbitrum; defaults to base. |
token | string | Yes | ERC-20 token contract address. |
account | string | Yes | Wallet or contract address whose token balance should be read. |
block | string | No | Block tag or height; defaults to latest. |
Example deliverable
This is the documented response shape, not a promise that live values will match the example. The paid request returns current or declared-source results using the same contract.
{
"success": true,
"network": "base",
"symbol": "USDC",
"decimals": 6,
"balance_raw": "0",
"balance_formatted": "0.0",
"metadata_warnings": []
}Why this offer exists
One current ERC-20 balance with raw units, decimals, symbol, and formatted amount from the token contract.
Buyer searches: ERC20 balance, token balance lookup, wallet token balance, USDC balance, onchain balance.
Why pay: Delivers the highest-demand Bazaar lookup at a lower launch price with Base, Ethereum, and Arbitrum support.
Launch price: 0.001 USDC per complete paid result. The live contract proof verifies source, freshness, inputs, and response shape before a wallet is asked to pay.
Purchase decision
Buy when: the active task needs this product's structured result, its declared source and freshness are sufficient, and 0.001 USDC is within the buyer's authorized per-request limit.
Skip when: a cached result is sufficient, the source or fields do not satisfy the task, or the buyer has not authorized payment. Do not bypass wallet, budget, or user-approval policy.
Guaranteed response metadata
Every successful product response identifies how the result was produced. Product-specific output fields are documented in the paid OpenAPI contract. The preview proves the live source and field types without returning the paid values.
{
"marketplace_metadata": {
"data_mode": "live_source",
"billable": true,
"availability": "operational",
"source": "public EVM JSON-RPC and ERC-20 contract calls"
}
}Agent payment flow
Fast path: install the public MCP package, configure a dedicated low-balance Base buyer wallet and a maximum per-request spend, then call this tool with auto_pay: true. The client handles the challenge, local signature, settlement, and retry in one tool call.
npx -y dopaminedesk-ai-data-marketplace-mcp
X402_AUTO_PAY=true
X402_EVM_PRIVATE_KEY=<dedicated buyer wallet key>
X402_MAX_PAYMENT_USDC=0.25
tool input: { "auto_pay": true }Manual path: request the product, read the base64 PAYMENT-REQUIRED challenge, sign with any compatible x402 v2 client, and retry with PAYMENT-SIGNATURE. A successful response includes PAYMENT-RESPONSE.