BASE MAINNET · WALLET BALANCE · X402 V2

Know whether a Base wallet can cover the next payment.

Name: Base USDC x402 Wallet Check API
Price: 0.001 USD
Availability: InStock

Read native ETH, official USDC, transaction count, account type, current gas price, and an optional payment estimate in one point-in-time public-chain snapshot.

Free live sample0.001 USDC / callNo account or API key

Open the free live wallet sample

LIVE BASE WALLET CHECKDirect Base USDC or x402

NO ACCOUNT · NO WALLET CONNECTION

Pay once, then redeem with the public transaction hash.

The invoice locks the address and estimate for 30 minutes. One successful exact USDC transfer can redeem only one invoice; repeat redemption returns the same stored snapshot.

01 · INPUT

One public address

Send an EVM address. Optionally supply the required six-decimal USDC amount and a gas-unit estimate.

address=0x5b1f4ab7ce2c252b44f8d1dd96da47d6bce6fbd0
requiredUsdcAtomic=1000
gasUnits=65000

02 · READ

Six live Base signals

BountyWorth reads ETH balance, official USDC balance, nonce, bytecode, gas price, and latest block number from public Base JSON-RPC.

03 · ESTIMATE

Compare funds to intent

The optional USDC amount is compared to the live token balance. Current gas price × requested gas units is compared to native ETH.

04 · DECIDE

Machine-readable verdict

Receive ready_for_estimate, contract_wallet_review, insufficient_usdc, insufficient_gas, both insufficient, or snapshot_only with explicit caveats.

ONE GET · SYNCHRONOUS JSON

A preflight for the payer, not just the endpoint.

Use it before an Agent attempts an x402 call, starts a Base workflow, retries a failed payment, or schedules work that depends on available USDC and gas.

{
  "wallet": {
    "accountType": "eoa",
    "transactionCount": 42
  },
  "balances": {
    "native": { "symbol": "ETH" },
    "usdc": { "symbol": "USDC" }
  },
  "checks": {
    "enoughUsdc": true,
    "enoughNativeGasForEstimate": true
  },
  "verdict": "ready_for_estimate"
}

INTEGRATION

HTTP or remote MCP

GET /api/base-wallet-readiness?sample=1Free

A fixed public Base address proves the full RPC and readiness path without a wallet.

GET /api/base-wallet-readiness0.001 USDC

Call with a valid address to receive exact x402 terms, then retry the identical request with PAYMENT-SIGNATURE.

GET /api/base-wallet-readiness/invoice0.001 USDC

Create a 30-minute browser-compatible invoice, transfer exact Base USDC, then redeem with the public transaction hash.

POST /mcp0.001 USDC

Call check_base_wallet_readiness through the stateless Streamable HTTP MCP transport.

GET /openapi.jsonFree

Read the complete input, payment, and output contract with executable examples.

SAFETY CONTRACT

Observation, never authorization.

No wallet connection, private key, seed phrase, account, API key, or transaction signature is requested by this site.
The service reads public Base state and cannot move funds or create an allowance.
Direct purchases verify the public Base receipt, official USDC contract, exact recipient and amount, and prevent transaction replay.
The verdict is an estimate, not proof that a signer, smart-account policy, allowance, or facilitator will approve the payment.
The free sample and paid request use the same Base RPC implementation.

Inspect the unpaid 402 contract →