# EVM Chains Read-Only

Live read-only facts from public RPCs for Ethereum, Base, Arbitrum, Optimism and Polygon.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://evm-chains.x402tookit.com/openapi.json
- x402 manifest: https://evm-chains.x402tookit.com/.well-known/x402
- Catalog (free): https://evm-chains.x402tookit.com/catalog
- Health (free): https://evm-chains.x402tookit.com/health
- Uptime (free): https://evm-chains.x402tookit.com/uptime

## Endpoints (9)

### GET /evm-address-kind — $0.02
Is this address a wallet or a contract on an EVM chain? Code size, nonce and native balance of a public address.
Params: chain: string, address: string
Example: https://evm-chains.x402tookit.com/evm-address-kind?chain=ethereum&address=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

### GET /evm-block — $0.02
Facts about one block on an EVM chain: time, transaction count, gas used versus limit, base fee, producer.
Params: chain: string, block?: string
Example: https://evm-chains.x402tookit.com/evm-block?chain=ethereum&block=18000000

### GET /evm-chain-facts — $0.02
Chain id, native currency, EIP-1559 support and measured average block time for an EVM chain.
Params: chain: string
Example: https://evm-chains.x402tookit.com/evm-chain-facts?chain=optimism

### GET /evm-chain-status — $0.03
Latest block and age on Ethereum, Base, Arbitrum, Optimism or Polygon, cross-checked against a second public node.
Params: chain: string
Example: https://evm-chains.x402tookit.com/evm-chain-status?chain=base

### GET /evm-erc20-balance — $0.02
ERC-20 balance of a public holder address on an EVM chain, exact raw units plus decimals and symbol.
Params: chain: string, token: string, holder: string
Example: https://evm-chains.x402tookit.com/evm-erc20-balance?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&holder=0x4200000000000000000000000000000000000016

### GET /evm-erc20-info — $0.02
ERC-20 token symbol, name, decimals and total supply on an EVM chain, read straight from the contract.
Params: chain: string, token: string
Example: https://evm-chains.x402tookit.com/evm-erc20-info?chain=ethereum&token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

### GET /evm-gas — $0.02
Gas price in gwei on an EVM chain with slow, normal and fast max-fee tiers from the last 20 blocks of fee history.
Params: chain: string
Example: https://evm-chains.x402tookit.com/evm-gas?chain=ethereum

### GET /evm-native-balance — $0.02
Native balance (ETH or POL) of a public address on Ethereum, Base, Arbitrum, Optimism or Polygon, exact in wei.
Params: chain: string, address: string
Example: https://evm-chains.x402tookit.com/evm-native-balance?chain=base&address=0x4200000000000000000000000000000000000016

### GET /evm-tx-status — $0.02
Transaction status by hash on an EVM chain: success, failed, pending or not found, with confirmations and fee paid.
Params: chain: string, hash: string
Example: https://evm-chains.x402tookit.com/evm-tx-status?chain=ethereum&hash=0x16e199673891df518e25db2ef5320155da82a3dd71a677e7d84363251885d133

## Terms

On-chain facts read from public JSON-RPC nodes, provided as is, with no warranty. A node can lag, be pruned or answer wrongly; a failed read is UNVERIFIED, never zero. Nothing here signs or sends transactions, holds keys, or gives financial or investment advice.