{"uid":"cap_vnlnLX4DxjlDQFFulDoWl","slug":"blockscout-stats-line-chart-data-e75b77d3","name":"Blockscout Stats Line Chart Data","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/stats-service/api/v1/lines/%7Bname%7D","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":{"name":{"type":"string"},"chain_id":{"type":"string"}}},"queryParams":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"resolution":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"info":{"id":"string","title":"string","units":"string","description":"string","resolutions":["string"]},"chart":[{"date":"string","value":"string","date_to":"string","is_approximate":true}]}},"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_5VDYHu7O_r9wLN55rQd7A","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":"Retrieves time-series chart data for a named statistical metric on a specific blockchain network via Blockscout's stats service","exampleAgentPrompt":"Show me the daily transaction count trend on Ethereum (chain_id eth) from Blockscout's stats service for the past 30 days, using a daily resolution.","exampleUseCases":[{"title":"Track daily active addresses on Polygon","prompt":"Pull me the daily active addresses chart for Polygon from Blockscout stats for the last 60 days, using day resolution — I want to see the trend over time."},{"title":"Monitor gas price trends on Ethereum","prompt":"Get me the average gas price time series for Ethereum mainnet from Blockscout for this past month, broken down by day, so I can see how fees have been moving."},{"title":"Analyze new contract deployments over time","prompt":"Fetch the new contracts deployed per day on Optimism from Blockscout's stats line endpoint for the past 90 days with daily resolution."}],"resultDescription":"Returns a JSON object with two top-level keys: 'info' (containing the metric's id, title, units, description, and available resolutions) and 'chart' (an array of time-series data points, each with a date, value, optional date_to, and is_approximate boolean flag indicating estimated values).","failureModes":["Invalid chain_id returns a 404 or error response","Unknown or misspelled metric name returns empty or error response","Date range outside available data returns empty chart array","Invalid resolution parameter may cause a 400 error","Rate limiting or payment failure ($0.002 USDC per call) blocks access","Network-specific stats may not be available for all supported chains"],"whenToPreferThis":"Use this endpoint when you need historical time-series statistical data for a specific on-chain metric (e.g. transaction counts, active addresses, gas prices) on a particular blockchain. Prefer it over raw block/transaction endpoints when you want aggregated, chart-ready data with configurable resolution and date ranges. Best for analytics dashboards, trend monitoring, and reporting use cases where aggregated stats are more useful than individual records.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T00:30:01.738Z","isFirstParty":false}