{"uid":"cap_f9uXUigO6TojIlEtxyuKx","slug":"tracefast-proxy-contract-implementation-history-035929f9","name":"TraceFast Proxy Contract Implementation History","description":"TraceFast live Ethereum data: the implementations a proxy contract has been observed delegating to — from its EIP-1167 bytecode, its EIP-1967 implementation or beacon slot, or its OpenZeppelin v1 slot — newest first, each with the blocks it was seen at and whether it has since been replaced. Path address: The proxy contract address, `0x`-prefixed, 40 hex characters, any case. Docs: https://docs.tracefast.xyz/api/contract-proxy.md","url":"https://mpp.tracefast.xyz/api/v1/chains/1/contracts/:address/proxy?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-ysTGDPdgwkkoOn5D2HZS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ordered history of implementation contracts a proxy has delegated to, detected via EIP-1167, EIP-1967, or OpenZeppelin v1 slots, with block ranges and replacement status.","exampleAgentPrompt":"Can you pull the full implementation history for Ethereum proxy contract 0x1F98431c8aD98523631AE4a59f267346ea31F984 — I want to see every implementation it's delegated to, what blocks they were active, and whether any have been replaced?","exampleUseCases":[{"title":"Audit upgradeable DeFi protocol","prompt":"Show me every implementation contract that 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 has ever delegated to on Ethereum, including which blocks each implementation was active and whether it's been replaced — I'm auditing this protocol's upgrade history."},{"title":"Detect proxy standard used by contract","prompt":"What proxy standard does 0x7d2768dE32b0b80b7a3454c06BdAc94A69DDc7A9 use — is it EIP-1167, EIP-1967, or OpenZeppelin v1 — and what implementation is it currently pointing to?"},{"title":"Monitor contract for unexpected upgrades","prompt":"Has the proxy contract at 0xc3d688B66703497DAA19211EEdff47f25384cdc3 had its implementation changed recently? Give me its full delegation history with block numbers so I can check if anything changed in the last few weeks."}],"resultDescription":"An ordered list (newest first) of implementation contract addresses the proxy has delegated to, each entry including the implementation address, the block numbers at which it was first and last observed, the proxy detection method used (EIP-1167 bytecode, EIP-1967 implementation slot, EIP-1967 beacon slot, or OpenZeppelin v1 slot), and a flag indicating whether that implementation has since been superseded by a newer one.","failureModes":["Address is not a proxy contract — returns empty list or no-proxy indicator","Invalid address format — returns 400 bad request","Contract not indexed yet or very recent deployment — may return incomplete history","Non-Ethereum chain ID — endpoint is scoped to chain ID 1 only","Payment failure via x402 protocol — returns 402 Payment Required","Network timeout on live chain data fetch — returns 503 or timeout error"],"whenToPreferThis":"Use this endpoint when you need the full historical record of proxy delegations for a specific Ethereum contract address, including detection across multiple proxy standards (EIP-1167, EIP-1967 implementation/beacon, OpenZeppelin v1). Prefer this over static code analysis tools when you need live, on-chain observed data with block-level granularity. Ideal for security audits, protocol research, upgrade monitoring, and any workflow that needs to know not just the current implementation but the complete lineage of implementations a proxy has used.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T18:42:35.227Z","isFirstParty":false,"canonicalSlug":"tracefast-proxy-contract-implementation-history-035929f9"}