Block Pricing Data

Get Block Pricing

Changed on

Returns 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.

get/block-pricing/{iso}

Request

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 comma-separated market list. Allowed values: da, rt, dart. When omitted, day-ahead and real-time are returned. dart is omitted when the ISO has no published DART series.

blocksstring nullable

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

day_so_farboolean

When true, the current market day's day-ahead values (including month-to-date) only cover time up to the end of the latest reported real-time interval, including a partial final hour. Earlier days are unchanged. A null day-ahead price within that time makes the affected day-ahead block and summary null and incomplete. Cannot be combined with market="da".

api_keystring nullable

API key for authentication (query)

Headers

x-api-keystring nullable

API key for authentication (header)

Response

Successful response

Changes

    • breaking

      the response's body type changed from array to object for status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status