Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man contract-source-verified

/contract-source-verified(1)

agentutility / edge-market / contract-source-verified
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
uncategorized
STATUS
live
NAME
contract-source-verified verified contract source code / etherscan source / basescan abi / solidity source lookup / contract verification check / abi fetcher / et…
SYNOPSIS
POST https://x402.org/v1/contract-source-verified
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Verified contract source code / Etherscan source / Basescan ABI / Solidity source lookup / contract verification check / ABI fetcher / Etherscan-getsourcecode wrapper. For a deployed contract on Ethereum, Optimism, Polygon, Base, or Arbitrum, returns whether the source is verified, the contract name, compiler version, parsed ABI (as a JSON array, not a string), full Solidity source code (multi-file sources reassembled with '// File: ...' separators), license type, optimizer settings, constructor arguments, and — for proxy contracts — the implementation address. Wraps Etherscan v2's multichain getsourcecode endpoint.

INPUTrequest schema
propertytypedescriptionreq?
addressstring0x-prefixed 20-byte EVM contract address.required
chainstringEVM chain. Default 'base'. Other supported: 'ethereum', 'polygon', 'arbitrum', 'optimism'.
enum: base · ethereum · polygon · arbitrum · optimism
optional
OUTPUTresponse shape
fieldtypedescription
addressstringDeployed contract address that was looked up.
chainstringChain the contract lives on (ethereum, optimism, polygon, base, or arbitrum).
is_verifiedstringWhether the contract source has been verified on the chain's explorer.
namestringContract name as declared in the verified Solidity source.
compiler_versionstringSolidity compiler version used to build the verified contract (e.g. v0.8.20+commit.a1b79de6).
abistringParsed contract ABI as a JSON array of function, event, and error definitions.
source_codestringFull Solidity source code; multi-file contracts are reassembled with '// File: ...' separators.
licensestringSPDX license identifier declared in the verified source (e.g. MIT, GPL-3.0, UNLICENSED).
optimizationstringOptimizer settings used at compile time, including whether enabled and the runs value.
constructor_argumentsstringABI-encoded constructor arguments passed when the contract was deployed.
proxystringFor proxy contracts, the implementation address the proxy delegates calls to.
sourcestringUpstream data source for the lookup (Etherscan v2 multichain getsourcecode).
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/contract-source-verified \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the contract-source-verified tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
edge-marketcontract-verificationetherscanabi-fetchersolidity-sourceproxy-implementationgetsourcecode
methods
POST
cluster
edgemarket
price
$0.01 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
contract-sourceVerified contract source code / Etherscan source / contract ABI fetcher / Solidity source lookup.$0.01
dex-liquidity-depthDEX liquidity depth / pool TVL aggregator / total liquidity per token / on-chain liquidity audit.$0.01
eth-logseth_getLogs / on-chain event logs / EVM event reader / Transfer event scan / ERC20 Transfer logs / NFT mint logs / DEX swap events / mult…$0.01
lp-lock-checkLP lock check / liquidity-lock auditor / Unicrypt + Team Finance + burn-address detection.$0.01
nft-floorNFT collection floor + recent sales via Reservoir.$0.01
agent-card-resolveAgent card resolver / ERC-8004 Identity Registry lookup / Trustless Agents / agentId → owner + agentURI / A2A identity / agent.json fetch…$0.005
arbitrage-spreadCross-exchange arbitrage spread / max-min price / CEX price dispersion / spread % calculator.$0.005
basename-resolveBasename resolver / Coinbase Basenames / .base.eth lookup / Base name service / on-chain name resolution.$0.005
SEE ALSO
agentutility(7) · edgemarket(7) · x402(7) · mcp(7) · llms.txt · registry.json · bazaar.x402.org