API Documentation

Native Endpoints

All native endpoints accept an optional ?chainId=369|943 query parameter and return {"success":true,"data":...} (or {"success":true,"data":[],"meta":{...}} for lists).

• GET /health — Health check
• GET /stats — Platform stats
• GET /networks — Supported networks and compiler versions
• POST /verify — Submit verification
• GET /verify/status?guid=... — Verification status
• GET /verify/jobs/{id} — Verification job details
• POST /verify/etherscan — Import from Etherscan
• GET /contracts — Verified contracts list
• GET /contracts/{address} — Contract details
• GET /contracts/{address}/abi — ABI JSON
• GET /contracts/{address}/source — Source code and metadata
• GET /contracts/{address}/bytecode — Bytecode and creation bytecode
• GET /contracts/{address}/events — Events for this contract
• GET /contracts/{address}/similar — Contracts with identical bytecode
• GET /contracts/{address}/dependencies — Imported dependencies
• GET /contracts/{a}/diff/{b} — Side-by-side source diff
• GET /logs — Event logs
• GET /search?q=... — Search contracts by name/address
• GET /source-search?q=... — Full-text search verified source code
• POST /decode/calldata — Decode calldata
• POST /encode/calldata — Encode function call
• POST /simulate — Simulate a transaction
• POST /analyze — Static analysis scaffolding
• POST /storage — Storage variable inspector
• POST /deploy/estimate — Estimate deployment gas
• GET /signature/{selector} — Function signature lookup
• GET /event-signature/{topic} — Event signature lookup
• GET /watchtower/subscriptions — List alert subscriptions
• POST /watchtower/subscriptions — Create alert subscription

List Response Format

List endpoints (/contracts, /logs, /search, /source-search, /contracts/{address}/events) use the native envelope with top-level meta:

{"success":true,"data":[...],"meta":{"limit":50,"offset":0,"total":10}}

Etherscan-Compatible Endpoints

These endpoints return the flat {"status":"1","message":"OK","result":...} shape expected by Etherscan clients.

• /api?module=contract&action=getabi&address=0x...
• /api?module=contract&action=getsourcecode&address=0x...
• /api?module=contract&action=getcontractcreation&contractaddresses=0x...
• /api?module=contract&action=verifysourcecode
• /api?module=contract&action=checkverifystatus&guid=...
• /api?module=contract&action=verifyfrometherscan
• /api?module=logs&action=getLogs&fromBlock=...&toBlock=...&address=0x...&topic0=0x...

Example

curl "https://contractlab.g4mm4.net/api/v1/contracts/0x..."