Get Block Pricing
Changed onReturns block-averaged prices for an ISO over the requested date range.
dataset_metadata names the day-ahead, real-time, and DART dataset ids configured for the ISO. dart is null when the ISO has no DART series. These ids do not change with the market filter.
data is the list of columns. Daily columns (keyed by ISO date) cover the requested range, and additional summary columns are appended: MTD (month-to-date) and a Month-Year label for each full month spanned. Each column's value is the time-weighted average price for the block over that window.
Each datum includes pct_change, the percent change of value relative to the previous period for the same market and block (prior market day for daily columns; prior calendar month for summary columns). It is null when the previous period has no value or when the prior value is zero.
The complete flag indicates whether every interval in the window has reported data; it is false for in-progress windows such as the current day or month-to-date.
Pass market as a comma-separated list of da, rt, and/or dart. When omitted, day-ahead and real-time are returned. dart is the block average of the published DART series built from the same day-ahead and real-time datasets; markets without that series omit those rows. Its complete flag follows real-time publication.
Request
- Base URLhttps://api.gridstatus.io/v1
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
ISO identifier used to resolve the backing block pricing dataset.
Query parameters
API key for authentication (query)
Headers
API key for authentication (header)
Response
Successful response
Changes
- breaking
the response's body type changed from
arraytoobjectfor status - info
added the required property
to the response with the status - info
added the required property
to the response with the status
- breaking