{"uid":"cap_owtHc_2uIEUg1DLhRIfpr","slug":"blockscout-chain-stats-api-639bcb2c","name":"Blockscout Chain Stats API","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/stats","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"tvl":"string","coin_image":"string","coin_price":"string","gas_prices":{},"market_cap":"string","total_blocks":"string","gas_used_today":{},"total_gas_used":"string","total_addresses":"string","static_gas_price":"string","average_block_time":0,"total_transactions":"string","transactions_today":"string","gas_price_updated_at":"string","gas_prices_update_in":0,"secondary_coin_image":"string","secondary_coin_price":"string","coin_price_change_percentage":0,"network_utilization_percentage":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qXX1t2ktsRWZaUfplVtXG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregate blockchain statistics for a specific chain including gas prices, market cap, total transactions, and network utilization","exampleAgentPrompt":"Pull the current chain stats for Ethereum from Blockscout — I want to see gas prices, total transactions, market cap, and network utilization right now.","exampleUseCases":[{"title":"Gas price monitoring for transaction timing","prompt":"Check the current gas prices on Ethereum using Blockscout so I know if it's a good time to send a transaction right now."},{"title":"DeFi dashboard network health snapshot","prompt":"Get me the latest stats for the Polygon chain — total transactions, average block time, network utilization, and the native coin price with its 24h change."},{"title":"Cross-chain TVL and market cap comparison","prompt":"Fetch the Blockscout stats for Arbitrum so I can see its total value locked, market cap, and how many addresses have been active on the network."}],"resultDescription":"A JSON object containing chain-level statistics including TVL, native coin price and image, coin price change percentage, gas prices object, static gas price, gas used today, total gas used, total blocks, total addresses, total transactions, transactions today, average block time, network utilization percentage, and timestamps for gas price updates.","failureModes":["Invalid or unsupported chain_id returns 404 or empty response","Chain not indexed by Blockscout returns error or null fields","Rate limiting or payment failure returns 402 or 429","Temporary data staleness if gas price update interval has not elapsed","Some fields like TVL or secondary_coin_price may be null for chains without those metrics"],"whenToPreferThis":"Use this endpoint when you need a comprehensive snapshot of a specific blockchain network's health and activity metrics — gas prices, transaction volumes, coin pricing, and network utilization — in a single call. Prefer this over individual metric endpoints when you need multiple stats at once, or when building dashboards that monitor chain-level KPIs. It is especially useful for gas price awareness before submitting transactions, or for comparing network activity across chains supported by Blockscout.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:39:18.280Z","isFirstParty":false}