G

gpt55-token-gateway · Tools EVM Wallet Balance

by gpt55-token-gateway

GETBaseSolana

$0.001

per call · USD Coin on Base

Read a public EVM wallet balance on Base or Ethereum and determine whether its Base USDC balance can cover a suggested $0.001 x402 payment. Returns a coherent provider snapshot, USDC runway, shortfall, native-gas presence, and a handoff to the full funding-readiness doctor without signing, broadcasting, or handling private keys. Balance-only readiness does not prove client, signing, spend-cap, or retry capability. GET variant for agents, crawlers, and wallets that prefer query parameters over...

Endpoint

GET https://gpt55.558686.xyz/v1/tools/evm-wallet-balance

3

Calls / 30d

2

Unique payers / 30d

Aug 28

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://gpt55.558686.xyz/v1/tools/evm-wallet-balance", {
  method: "GET",
});
const data = await res.json();
cURL
curl -X GET \
  "https://gpt55.558686.xyz/v1/tools/evm-wallet-balance?address=0x1111111111111111111111111111111111111111&network=base" \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "address": "0x1111111111111111111111111111111111111111",
  "blockNumber": "1234567",
  "chainId": "eip155:8453",
  "nativeBalance": {
    "decimals": 18,
    "formatted": "1",
    "raw": "1000000000000000000",
    "symbol": "ETH"
  },
  "network": "base",
  "observedAt": "2026-08-10T00:00:00.000Z",
  "ok": true,
  "rpcProviderHost": "rpc.example.test",
  "tool": "evmWalletBalance",
  "usdcBalance": {
    "decimals": 6,
    "formatted": "1.234567",
    "raw": "1234567",
    "symbol": "USDC",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  },
  "x402Readiness": {
    "assessment": "balance_ready",
    "balanceOnly": true,
    "canCoverSuggestedX402Amount": true,
    "fundingReadinessDoctor": {
      "guideUrl": "https://gpt55.558686.xyz/x402/wallet-funding-readiness-doctor",
      "paidUrl": "https://gpt55.558686.xyz/v1/tools/x402-wallet-funding-readiness-doctor"
    },
    "limitations": [
      "Balance signals do not prove payment-client, typed-data signing, spend-cap, or same-request retry readiness."
    ],
    "nativeGasPresent": true,
    "shortfall": {
      "atomic": "0",
      "formatted": "0"
    },
    "suggestedPayment": {
      "amountAtomic": "1000",
      "amountUsd": "0.001",
      "asset": "USDC",
      "network": "eip155:8453"
    },
    "usdcRunwayAtSuggestedAmount": "1234",
    "walletNetworkMatches": true
  }
}

Payment details

Pay to0x1f0130669ca6fd02e025a984cc038f139df19a2f
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, Solana
Schemesexact

Is this your API?

Pin it to the top of Onchain Data and the homepage with a featured placement.

Get featured →

More from gpt55-token-gateway & similar services