{"uid":"cap_-adACMOei7dMERW6N64t_","slug":"gas-history-export-lab-paidapis-net-a31a35d4","name":"Gas History Export (lab.paidapis.net)","description":"Historical data export: raw Ethereum gas price samples over a date range (?from=, ?to=, ISO 8601, max 24h; ?format=json|csv). Priced at $0.0005/sample (min $0.005) — the real row count for your range, not a flat fee.","url":"https://lab.paidapis.net/api/gas-history-export","method":"GET","headers":{},"bodySchema":{"type":"object","required":["to","from"],"properties":{"to":{"type":"string","description":"ISO 8601 range end."},"from":{"type":"string","description":"ISO 8601 range start."},"format":{"enum":["json","csv"],"type":"string","description":"Either \"json\" (default) or \"csv\"."}}},"responseSchema":{"type":"object","properties":{"to":{"type":"string"},"from":{"type":"string"},"samples":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string"},"gasPriceGwei":{"type":"number"}}}},"sampleCount":{"type":"integer"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Qm-K3S5fD7sUmnvYcBNAX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical Base mainnet gas price samples (in Gwei) for a specified time range, exportable as JSON or CSV.","exampleAgentPrompt":"Can you pull the Base mainnet gas price history from January 1, 2025 to January 31, 2025 and give it to me as a CSV?","exampleUseCases":[{"title":"Monthly gas cost report for dApp","prompt":"I need to export Base mainnet gas prices for all of March 2025 in CSV format so I can include them in our monthly infrastructure cost report."},{"title":"Gas spike investigation","prompt":"Can you fetch the Base gas price history between 2025-02-10T00:00:00Z and 2025-02-11T00:00:00Z as JSON? I want to see if there was a spike during that day."},{"title":"Fee optimization research","prompt":"Pull Base mainnet gas price samples from 2024-12-01 to 2024-12-31 in JSON format — I'm trying to figure out the cheapest time windows to schedule transactions."}],"resultDescription":"A JSON object containing the requested date range boundaries, an array of timestamped gas price samples (each with a timestamp string and gasPriceGwei number), and a total sample count integer. If CSV format is requested, output is formatted accordingly.","failureModes":["Missing required 'from' or 'to' fields returns a 400 validation error","Invalid ISO 8601 date strings cause a parsing error","Date range with no available data may return an empty samples array with sampleCount 0","Very large date ranges may time out or return truncated results","Payment failure (insufficient USDC or x402 handshake issue) results in 402 response before data is returned"],"whenToPreferThis":"Choose this endpoint when you need historical gas price time-series data specifically from the Base mainnet chain, particularly when you want flexible date-range querying and the option to export as CSV for downstream analytics or reporting. Prefer it over generic blockchain explorers when you need clean, structured gas history data consumable by an agent or pipeline without scraping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:51:38.972Z","isFirstParty":false}