{"uid":"cap_AsSTOjxG2-wVEab86CbXh","slug":"chainsize-historical-evm-chain-size-c486fd09","name":"Chainsize - Historical EVM Chain Size","description":"Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.","url":"https://stablecrypto.dev/api/etherscan/stats/chainsize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["asc","desc"],"type":"string"},"chainid":{"type":"number","description":"EVM chain ID (1=Ethereum, 137=Polygon, 8453=Base, etc.)"},"enddate":{"type":"string","description":"End date (YYYY-MM-DD)"},"syncmode":{"enum":["default","archive"],"type":"string"},"startdate":{"type":"string","description":"Start date (YYYY-MM-DD)"},"clienttype":{"enum":["geth","parity"],"type":"string"}}},"responseSchema":null,"example":{"request":{"sort":"asc","chainid":1,"enddate":"2023-01-31","syncmode":"default","startdate":"2023-01-01","clienttype":"geth"},"response":[{"syncMode":"Default","chainSize":"1204461126556","clientType":"Geth","blockNumber":"16308239","chainTimeStamp":"2023-01-01"},{"syncMode":"Default","chainSize":"1207376092475","clientType":"Geth","blockNumber":"16315411","chainTimeStamp":"2023-01-02"},{"syncMode":"Default","chainSize":"1209919466372","clientType":"Geth","blockNumber":"16322582","chainTimeStamp":"2023-01-03"},{"syncMode":"Default","chainSize":"1212762642257","clientType":"Geth","blockNumber":"16329750","chainTimeStamp":"2023-01-04"},{"syncMode":"Default","chainSize":"1215572359186","clientType":"Geth","blockNumber":"16336918","chainTimeStamp":"2023-01-05"},{"syncMode":"Default","chainSize":"1218477815033","clientType":"Geth","blockNumber":"16344073","chainTimeStamp":"2023-01-06"},{"syncMode":"Default","chainSize":"1217608256990","clientType":"Geth","blockNumber":"16351233","chainTimeStamp":"2023-01-07"},{"syncMode":"Default","chainSize":"1220382388056","clientType":"Geth","blockNumber":"16358396","chainTimeStamp":"2023-01-08"},{"syncMode":"Default","chainSize":"1222185422578","clientType":"Geth","blockNumber":"16365561","chainTimeStamp":"2023-01-09"},{"syncMode":"Default","chainSize":"1225064318274","clientType":"Geth","blockNumber":"16372728","chainTimeStamp":"2023-01-10"},{"syncMode":"Default","chainSize":"1227279094929","clientType":"Geth","blockNumber":"16379894","chainTimeStamp":"2023-01-11"},{"syncMode":"Default","chainSize":"1225228230208","clientType":"Geth","blockNumber":"16387048","chainTimeStamp":"2023-01-12"},{"syncMode":"Default","chainSize":"1227750909907","clientType":"Geth","blockNumber":"16394204","chainTimeStamp":"2023-01-13"},{"syncMode":"Default","chainSize":"1230098335815","clientType":"Geth","blockNumber":"16401367","chainTimeStamp":"2023-01-14"},{"syncMode":"Default","chainSize":"1232806906208","clientType":"Geth","blockNumber":"16408537","chainTimeStamp":"2023-01-15"},{"syncMode":"Default","chainSize":"1235646037417","clientType":"Geth","blockNumber":"16415683","chainTimeStamp":"2023-01-16"},{"syncMode":"Default","chainSize":"1238455100486","clientType":"Geth","blockNumber":"16422843","chainTimeStamp":"2023-01-17"},{"syncMode":"Default","chainSize":"1240057351667","clientType":"Geth","blockNumber":"16430014","chainTimeStamp":"2023-01-18"},{"syncMode":"Default","chainSize":"1242425077910","clientType":"Geth","blockNumber":"16437179","chainTimeStamp":"2023-01-19"},{"syncMode":"Default","chainSize":"1245868486531","clientType":"Geth","blockNumber":"16444338","chainTimeStamp":"2023-01-20"},{"syncMode":"Default","chainSize":"1247750937825","clientType":"Geth","blockNumber":"16451507","chainTimeStamp":"2023-01-21"},{"syncMode":"Default","chainSize":"1250370854000","clientType":"Geth","blockNumber":"16458670","chainTimeStamp":"2023-01-22"},{"syncMode":"Default","chainSize":"1252423558638","clientType":"Geth","blockNumber":"16465829","chainTimeStamp":"2023-01-23"},{"syncMode":"Default","chainSize":"1255298604969","clientType":"Geth","blockNumber":"16472995","chainTimeStamp":"2023-01-24"},{"syncMode":"Default","chainSize":"1254094202597","clientType":"Geth","blockNumber":"16480161","chainTimeStamp":"2023-01-25"},{"syncMode":"Default","chainSize":"1257042911795","clientType":"Geth","blockNumber":"16487319","chainTimeStamp":"2023-01-26"},{"syncMode":"Default","chainSize":"1259590989006","clientType":"Geth","blockNumber":"16494485","chainTimeStamp":"2023-01-27"},{"syncMode":"Default","chainSize":"1262459166362","clientType":"Geth","blockNumber":"16501638","chainTimeStamp":"2023-01-28"},{"syncMode":"Default","chainSize":"1265391272539","clientType":"Geth","blockNumber":"16508807","chainTimeStamp":"2023-01-29"},{"syncMode":"Default","chainSize":"1268193104772","clientType":"Geth","blockNumber":"16515966","chainTimeStamp":"2023-01-30"},{"syncMode":"Default","chainSize":"1271027886372","clientType":"Geth","blockNumber":"16523134","chainTimeStamp":"2023-01-31"}]},"exampleRequest":{"sort":"asc","chainid":1,"enddate":"2023-01-31","syncmode":"default","startdate":"2023-01-01","clienttype":"geth"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_kF3WfQSpzAYE-Ppyb4qo-","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 historical blockchain chain size data for a given EVM chain over a specified date range, proxying Etherscan's chainsize stats API.","exampleAgentPrompt":"Can you pull the historical Ethereum mainnet chain size from January 1, 2023 to December 31, 2023, sorted ascending, for a geth client in default sync mode?","exampleUseCases":null,"resultDescription":"A time-series dataset of historical chain size measurements for the specified EVM chain and date range, including data points such as date and chain size in bytes or GB, sourced from Etherscan's stats API.","failureModes":["Invalid chain ID returns an error or empty result","Date range too broad may hit API limits or timeouts","Unsupported chain ID for Etherscan coverage returns no data","Malformed date format (not YYYY-MM-DD) causes validation error","Invalid enum values for sort, syncmode, or clienttype return errors","Payment not processed causes 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need historical on-chain storage growth data for EVM-compatible chains, particularly Ethereum. Prefer it over generic RPC endpoints when you need time-series chain size statistics rather than live block data. It is especially useful for infrastructure planning, node operator analysis, and blockchain growth research where archive vs. default sync mode distinction matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:48:28.262Z","isFirstParty":false}