Block Pricing Data

Get Block Pricing

get

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.

Path parameters

isostring · enumRequired

ISO identifier used to resolve the backing block pricing dataset.

Possible values:

Query parameters

api_keystring · nullableOptional

API key for authentication (query)

Header parameters

x-api-keystring · nullableOptional

API key for authentication (header)

Responses

200

Successful response

application/json

All block values for a single response column.

datestringRequired

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_holidaybooleanOptional

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

Default: false

422

Validation Error

application/json

get/block-pricing/{iso}

HTTPcURLJavaScriptPython

GET /v1/block-pricing/{iso}?params=[object+Object] HTTP/1.1
Host: api.gridstatus.io
Accept: */*

[
  {
    "date": "2024-01-01",
    "is_nerc_holiday": true,
    "data": [
      {
        "market": "da",
        "block": "7x24",
        "value": 31.42,
        "complete": true
      },
      {
        "market": "da",
        "block": "on-peak",
        "value": 38.15,
        "complete": true
      },
      {
        "market": "da",
        "block": "off-peak",
        "value": 24.69,
        "complete": true
      },
      {
        "market": "rt",
        "block": "7x24",
        "value": 29.87,
        "complete": true
      }
    ]
  },
  {
    "date": "2024-01-02",
    "is_nerc_holiday": false,
    "data": [
      {
        "market": "da",
        "block": "7x24",
        "value": 33.1,
        "pct_change": 5.35,
        "complete": true
      },
      {
        "market": "rt",
        "block": "7x24",
        "value": 30.55,
        "pct_change": 2.28,
        "complete": false
      }
    ]
  },
  {
    "date": "MTD",
    "is_nerc_holiday": false,
    "data": [
      {
        "market": "da",
        "block": "7x24",
        "value": 32.26,
        "complete": false
      },
      {
        "market": "da",
        "block": "on-peak",
        "value": 39.04,
        "complete": false
      }
    ]
  },
  {
    "date": "Jan-2024",
    "is_nerc_holiday": false,
    "data": [
      {
        "market": "da",
        "block": "7x24",
        "value": 32.26,
        "complete": false
      }
    ]
  }
]