How to detect whether a contract is a proxy and find its implementation
Updated 2026-11-10
Use when an agent must find out whether a contract is a proxy and where its implementation and admin are.
From an MCP client, add https://tanod.dev/mcp and call detect_proxy; its free daily calls are applied automatically, no key or signup.
POST a chain and a contract address to /v1/chain/proxy. It reports whether the address is a proxy, which pattern it uses, and the implementation, admin and beacon addresses it found.
Request
chain is ethereum or base; address is 0x plus 40 hex characters. Detected kinds include EIP-1967 transparent, UUPS and beacon, EIP-1822, OpenZeppelin legacy, multisig masterCopy, EIP-1167 and ERC-7511 minimal proxies and EIP-7702 delegation.
curl -s -X POST https://tanod.dev/v1/chain/proxy \
-H 'X-Tanod-Free: 1' -H 'content-type: application/json' \
-d '{"chain": "ethereum", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}'Response
{
"chain": "ethereum",
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"is_contract": true,
"code_bytes": 2186,
"is_proxy": true,
"kind": "oz_legacy",
"implementation": "0x43506849D7C04F9138D1A2050bbF3A0c054402dd",
"implementation_has_code": true,
"admin": "0x807a96288A1A408dBC13DE2b1d087d10356395d2",
"patterns": ["oz_legacy"],
"slots": {
"oz_legacy_implementation": "0x43506849D7C04F9138D1A2050bbF3A0c054402dd",
"oz_legacy_admin": "0x807a96288A1A408dBC13DE2b1d087d10356395d2"
},
"rpc_calls": 10
}Limits and caveats
Detection uses storage slots and code patterns only, so a contract that stores its implementation somewhere else, or computes it, is reported as not a proxy. The admin address is who can upgrade it, so an upgradeable contract can change behaviour after you review it.
This says what the proxy points to, not whether the implementation is safe. For a risk check see the contract risk guide.
Results come from an Ethereum or Base node. A malformed or inconsistent node answer is a 5xx and is not charged.
Price and free allowance
USD 0.002 per call, paid in USDC on Base, Polygon, Solana, BNB Chain or Arbitrum with x402. 10 free calls per IP per UTC day with the header X-Tanod-Free: 1. The pool is shared by every on-chain read. MCP tool: detect_proxy at https://tanod.dev/mcp, where the free tier is automatic.
Use it from Claude without writing code: in claude.ai or Claude Desktop, add https://tanod.dev/mcp/chain?via=proxy-contract-detection-api as a custom connector (steps), then ask in plain words, for example "Is the USDC contract on Ethereum a proxy, and where are its implementation and admin?" The free daily allowance is applied automatically over MCP. Beyond it a call needs an x402 payment, which these clients can make.
Related guides: How to check a contract or token address for risk before you transact, Smart contract security scanner API (Solidity source or address), How to get and decode a transaction's event logs on Base or Ethereum. Back to tanod.dev or the guide index. Results are automated and heuristic.