v2

latestOpenAPI 3.1.02026-07-312954143.9 KB
Block Pricing Data

Get Block Pricing

Returns block-averaged prices for an ISO over the requested date range.

The response is a 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 volume-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.

get/block-pricing/{iso}

Path parameters

iso'CAISO' | 'ERCOT' | 'IESO' | 'ISONE' | 'MISO' | 'NYISO' | 'PJM' | 'SPP' required

ISO identifier used to resolve the backing block pricing dataset.

Query parameters

start_datestring date required

Start of date range (inclusive), interpreted in the ISO market timezone.

end_datestring date required

End of date range (exclusive), interpreted in the ISO market timezone.

locationstring required

Location filter.

marketstring nullable

Optional market filter. Allowed values: "da" or "rt".

blocksstring nullable

Optional comma-separated list of block values. Allowed values: 7x24, 7x8, 2x16h, on-peak, off-peak.

api_keystring nullable

API key for authentication (query)

API key for authentication (query)

Headers

x-api-keystring nullable

API key for authentication (header)

API key for authentication (header)

Response

Successful response

datestring required

Column identifier: an ISO date (YYYY-MM-DD) for a daily column, "MTD" for month-to-date, or a "Month-Year" label for a full-month summary.

is_nerc_holidayboolean

Whether the daily column is a NERC holiday. False for summary columns.