x402 Chain Tools

Read-only onchain utilities

x402 Chain Tools

Blockchain wallet, token, transaction and preflight tools for AI agents.

Deterministic, read-only Base Mainnet data utilities for autonomous agents using x402 pay-per-request access. The payment rail does not change the Base data returned.

Base Mainnet x402 V2 Read-only Base + Solana payments

Live paid activity

Real usage. Real settlements.

Loading live paid activity…

Paid calls —
Unique payers —
Repeat paid calls —
Repeat payers —
Repeat rate —
24H revenue —
7D revenue —
Recorded revenue —

Base

eip155:8453
Paid calls—
Revenue—

Solana

mainnet
Paid calls—
Revenue—
ToolCallsRevenue
/chain/block — —
/chain/balance — —
/chain/token-balance — —
/chain/allowance — —
/chain/transaction-lookup — —
/chain/transaction-receipt-status — —
/chain/wallet-preflight — —

Paid tools / 07

Small, deterministic Base reads.

Every chain tool is a read-only POST endpoint protected by an exact x402 V2 USDC payment requirement.

POST/chain/block
$0.001

Check the latest or current Base Mainnet block number. Use this to get the live Base block height.

POST/chain/balance
$0.001

Check the native ETH balance or gas balance of a Base wallet address. Use this to see how much Base ETH the wallet has.

POST/chain/token-balance
$0.001

Get ERC20 token balance for a Base wallet address. Use an ERC20 token contract address to return raw, decimal, and formatted token balance values.

POST/chain/allowance
$0.001

Get ERC20 allowance for an owner wallet and spender on Base. Return the approved token amount and whether the allowance is unlimited.

POST/chain/transaction-lookup
$0.002

Lookup Base transaction by hash on Base Mainnet. Return sender, recipient, value, nonce, block, gas fields, and input data when found.

POST/chain/transaction-receipt-status
$0.002

Check Base transaction receipt status by transaction hash. Determine whether the transaction is pending, confirmed successful, or confirmed reverted, with receipt, block, and gas details.

POST/chain/wallet-preflight
$0.002

Wallet preflight: check wallet readiness before token spend on Base. Verify native ETH gas balance, ERC20 token balance, allowance, spender contract status, and whether the requested amount can be spent.

Checks native ETH presence, token balance, allowance, and spender contract bytecode presence.

ready: true / falsewith deterministic issue codes

Does not simulate transaction execution or guarantee exact gas sufficiency.

Pricing

Pay for the request you make.

Exact USDC amounts are returned in each endpoint's x402 challenge. Accepted payment networks: Base Mainnet USDC or Solana Mainnet USDC.

$0.001per request

Basic chain reads: block, native balance, token balance, and allowance.

$0.002per request

Transaction lookup, receipt status, and bundled wallet preflight.

Pay per request with x402. No subscription.

Machine resources / Free

Contracts for clients and crawlers.

These resources are free and separate from the seven paid chain tools. Raw responses remain available at their exact paths.

Health

/health

Worker application response probe.

VIEW RAW

OpenAPI

/openapi.json

Machine-readable API schema.

VIEW RAW

Capabilities

/capabilities

Compact service and tool catalogue.

VIEW RAW

llms.txt

/llms.txt

Agent-readable discovery instructions.

VIEW RAW

x402 Service Manifest

/.well-known/x402-service.json

Project-owned x402 service metadata.

VIEW RAW

Live Stats

/stats

Real settled-call, payer, and revenue telemetry.

VIEW RAW

robots.txt

/robots.txt

Crawler instructions.

VIEW RAW

Developer quick start

The x402 request flow.

OpenAPI is the canonical detailed contract. The sequence below is intentionally conceptual.

  1. POST JSON to a paid /chain/* endpoint.
  2. Receive HTTP 402 with x402 payment requirements.
  3. The client pays and signs according to x402.
  4. Retry the request with PAYMENT-SIGNATURE.
  5. Receive the JSON result after successful verification and settlement.
REQUEST EXAMPLE
POST /chain/balance
Content-Type: application/json

{
  "address": "0x..."
}

See /openapi.json for field validation and response schemas.

Protocol facts

Base data. Flexible payment rails.

No signing, transaction submission, historical indexing, or portfolio analytics.

Data network
Base Mainnet
Data CAIP-2
eip155:8453
Payment protocol
x402 V2
Scheme
exact
Payment networks
Base Mainnet USDC or Solana Mainnet USDC

Access boundary