# Automaton Onchain Tools

> 13 pay-per-call APIs for AI agents: transaction explainer, token approval check, address inspector and contract risk for Base, Ethereum and BNB Smart Chain, plus URL phishing check. $0.005-$0.01 in USDC via x402. No signup, no API key. MCP server included.

Payment: x402 v2, exact scheme, USDC on Base (eip155:8453), payTo 0x679af3a893eDd0AeF4ac4c7776Ba581b238C0717. Request without payment returns 402 with requirements; retry with PAYMENT-SIGNATURE header. Invalid input returns 400 free.

## Docs
- [OpenAPI](https://automaton-tx-explainer.vercel.app/openapi.json)
- [x402 discovery](https://automaton-tx-explainer.vercel.app/.well-known/x402)
- [Health/endpoint list JSON](https://automaton-tx-explainer.vercel.app/health)
- MCP (streamable HTTP, POST): https://automaton-tx-explainer.vercel.app/mcp

## Endpoints
- GET https://automaton-tx-explainer.vercel.app/v1/base/tx?hash=<hash> ($0.01): Explain a Base transaction: status, fee, decoded method + args (openchain signature DB), and ERC-20 transfers with symbols and human amounts.
- GET https://automaton-tx-explainer.vercel.app/v1/base/approvals?address=<address> ($0.005): Check a Base wallet's ERC-20 approvals: allowances for 8 major tokens (USDC, WETH, USDbC, DAI...) to common spenders (Permit2, Uniswap Universal Router, Uniswap SwapRouter02, Aerodrome Router...); flags unlimited approvals.
- GET https://automaton-tx-explainer.vercel.app/v1/base/address?address=<address> ($0.005): Inspect any Base address: EOA vs contract vs EIP-7702 delegated, ETH balance, nonce, proxy implementation (EIP-1967/1167/zos), and ERC-20 name/symbol/decimals/supply.
- GET https://automaton-tx-explainer.vercel.app/v1/base/contract-risk?address=<address> ($0.01): Heuristic risk flags for a Base contract from free public data: Sourcify verification, upgradeable proxy + admin, owner type, mint/pause/blacklist/fee selectors, bytecode size. Not an audit or financial advice.
- GET https://automaton-tx-explainer.vercel.app/v1/ethereum/tx?hash=<hash> ($0.01): Explain a Ethereum transaction: status, fee, decoded method + args (openchain signature DB), and ERC-20 transfers with symbols and human amounts.
- GET https://automaton-tx-explainer.vercel.app/v1/ethereum/approvals?address=<address> ($0.005): Check a Ethereum wallet's ERC-20 approvals: allowances for 8 major tokens (USDC, USDT, WETH, DAI...) to common spenders (Permit2, Uniswap Universal Router v4, Uniswap Universal Router, Uniswap SwapRouter02...); flags unlimited approvals.
- GET https://automaton-tx-explainer.vercel.app/v1/ethereum/address?address=<address> ($0.005): Inspect any Ethereum address: EOA vs contract vs EIP-7702 delegated, ETH balance, nonce, proxy implementation (EIP-1967/1167/zos), and ERC-20 name/symbol/decimals/supply.
- GET https://automaton-tx-explainer.vercel.app/v1/ethereum/contract-risk?address=<address> ($0.01): Heuristic risk flags for a Ethereum contract from free public data: Sourcify verification, upgradeable proxy + admin, owner type, mint/pause/blacklist/fee selectors, bytecode size. Not an audit or financial advice.
- GET https://automaton-tx-explainer.vercel.app/v1/bsc/tx?hash=<hash> ($0.01): Explain a BNB Smart Chain transaction: status, fee, decoded method + args (openchain signature DB), and ERC-20 transfers with symbols and human amounts.
- GET https://automaton-tx-explainer.vercel.app/v1/bsc/approvals?address=<address> ($0.005): Check a BNB Smart Chain wallet's ERC-20 approvals: allowances for 8 major tokens (USDT, USDC, WBNB, BUSD...) to common spenders (Permit2, PancakeSwap v2 Router, PancakeSwap Smart Router, PancakeSwap Universal Router...); flags unlimited approvals.
- GET https://automaton-tx-explainer.vercel.app/v1/bsc/address?address=<address> ($0.005): Inspect any BNB Smart Chain address: EOA vs contract vs EIP-7702 delegated, BNB balance, nonce, proxy implementation (EIP-1967/1167/zos), and ERC-20 name/symbol/decimals/supply.
- GET https://automaton-tx-explainer.vercel.app/v1/bsc/contract-risk?address=<address> ($0.01): Heuristic risk flags for a BNB Smart Chain contract from free public data: Sourcify verification, upgradeable proxy + admin, owner type, mint/pause/blacklist/fee selectors, bytecode size. Not an audit or financial advice.
- GET https://automaton-tx-explainer.vercel.app/v1/url-safety?url=<url> ($0.005): Check a URL for phishing/scam signals: MetaMask eth-phishing-detect + Phishing.Database blocklists, RDAP domain age, punycode and brand-lookalike detection, HTTPS reachability. Heuristic; not security advice.