Api Endpoint

ERC20 token balance

Use when an agent must confirm a wallet holds enough of a token before it swaps, pays or settles: the ERC-20 balance of any address for any token (USDC, USDT, DAI or any other), returned raw (exact integer string) with its decimals, the formatted amount and the symbol, so no rounding is forced on you. Do not use for the native coin (/v1/evm/balance) or for what a contract is allowed to spend (/v1/evm/erc20-allowance). No API key, no account.

Open interactive test console

Offering

Provider: flat-rate-llm.kikoribera03.workers.dev
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Blockchain And Crypto
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://flat-rate-llm.kikoribera03.workers.dev/v1/evm/erc20-balance
MIME type: Not provided
First seen: 2026-10-16T01:50:19.913Z
Last seen: 2026-11-02T08:58:28.072Z
Tags: ERC20 balance, token balance, ERC20, balanceOf, USDC, Token, EVM, Base, Ethereum, Polygon, Arbitrum, optimism

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0.005 USDC
Atomic price: 5000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3: 0.005 USDC
Atomic price: 5000 · Network: eip155:42161 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0xc210Ea7D5692a6401ADf25BbCB7aCDe9cDB7e9Ff"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "5000",
    "payTo": "0xc210Ea7D5692a6401ADf25BbCB7aCDe9cDB7e9Ff"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "5000",
    "payTo": "0xc210Ea7D5692a6401ADf25BbCB7aCDe9cDB7e9Ff"
  }
]

Observed health

Status: Healthy
Latest latency: 243 ms
Average latency: 1533 ms
HTTP status: 402
Last checked: 2026-11-02T08:58:28.068Z
Reachability: 92.3% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "description": "Wallet to look up."
        },
        "token": {
          "type": "string",
          "description": "ERC20 contract address."
        },
        "chain": {
          "type": "string",
          "description": "base | ethereum | polygon | arbitrum | optimism."
        }
      },
      "required": [
        "address",
        "token"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "address": {
              "description": "Wallet to look up.",
              "type": "string"
            },
            "chain": {
              "description": "base | ethereum | polygon | arbitrum | optimism.",
              "type": "string"
            },
            "token": {
              "description": "ERC20 contract address.",
              "type": "string"
            }
          },
          "required": [
            "address",
            "token"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}