{"uid":"cap_DOPfAXAQ8WFZA7SNVKz_p","slug":"gridhub-electricity-historical-price-series-afa9c641","name":"GridHub Electricity Historical Price Series","description":"Historical price time series for one electricity zone, oldest-first, max 31 days per call (start/end are Unix seconds; default last 24h; limit caps rows). Use for trends and backtests; use /v1/latest or /v1/brief for current values. Zone ids from /v1/zones.","url":"https://api.grid-hub.app/v1/price/:zone","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","pathParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["zone"],"properties":{"zone":{"enum":["US-CAISO","US-ERCOT","US-PJM","US-MISO","US-NYISO","US-ISONE","US-SPP","GB","AU-NSW","AU-QLD","AU-VIC","AU-SA","AU-TAS","DE-LU","FR","ES","IT-NO","NL","BE","PL","SE-3","NO-2","DK-1","AT","CH"],"type":"string","description":"Zone id from /v1/zones"}}},"queryParams":{"type":"object","properties":{"end":{"type":"string","description":"Window end, Unix seconds"},"limit":{"type":"string","description":"Max rows (up to 5000)"},"start":{"type":"string","description":"Window start, Unix seconds"},"sample":{"enum":["true"],"type":"string","description":"Free truncated sample, no payment or credentials"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"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_F9oKUCs6kxipDpRpS-3ll","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 a time-ordered historical wholesale electricity price series for a single zone, covering up to 31 days per call.","exampleAgentPrompt":"Pull the historical electricity wholesale prices for the CAISO zone in California for the last 7 days — I want to see the price trend hour by hour.","exampleUseCases":[{"title":"Energy trading strategy backtest","prompt":"Get me the historical electricity prices for ERCOT from January 1st to January 31st 2024 so I can backtest my trading algorithm against real Texas power market data."},{"title":"European power market trend analysis","prompt":"Fetch the wholesale electricity price history for Germany (DE-LU zone) over the past 30 days — I want to spot any price spikes or patterns."},{"title":"Renewable energy cost-benefit study","prompt":"Pull the last two weeks of electricity price data for the PJM zone, up to 5000 rows, so I can compare periods of high renewable generation against price dips."}],"resultDescription":"A time-ordered array of price data points for the specified electricity zone, each entry containing a timestamp (Unix seconds) and the wholesale electricity price. Covers up to 31 days per call, oldest entries first, with an optional row cap up to 5000.","failureModes":["Invalid or unsupported zone ID returns an error — use /v1/zones to list valid zone IDs","Date range exceeding 31 days is rejected or truncated","start/end timestamps provided in wrong format (non-Unix seconds) cause parsing errors","Payment failure (x402) if USDC not supplied correctly","Empty result if no data exists for the specified window","limit value above 5000 is capped or rejected"],"whenToPreferThis":"Use this endpoint when you need a historical time series of electricity prices for trend analysis, backtesting, or charting — up to 31 days of data per call. Prefer /v1/latest or /v1/brief when you only need the current or most recent price snapshot. This endpoint is the right choice when temporal depth matters more than recency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:27.807Z","isFirstParty":false}