openapi: 3.2.0
info:
title: Miso Day Ahead API
version: '1.0'
description: 'Operations tagged Day Ahead across 2 of this provider''s published API definitions: miso-data-exchange-load-generation-interchange-api-openapi.json, miso-data-exchange-pricing-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://apim.misoenergy.org/lgi
- url: https://apim.misoenergy.org/pricing
security:
- {}
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Day Ahead
paths:
/v1/day-ahead/{date}/demand:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-demand
summary: Day-Ahead Cleared Demand
description: Demand cleared in the day-ahead market, by region in hourly or daily intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
- name: timeResolution
in: query
required: false
description: Time resolution of data
schema:
type: string
enum:
- hourly
- daily
default: hourly
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-DayAhead-DemandResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
fixed: 0
priceSens: 0
virtual: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/generation/cleared/physical:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-generation-cleared-physical
summary: Day-Ahead Cleared Generation, Physical
description: Physical generation cleared in the day-ahead market, in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Cleared-GenerationResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
supply: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/generation/cleared/virtual:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-generation-cleared-virtual
summary: Day-Ahead Cleared Generation, Virtual
description: Virtual generation cleared in the day-ahead market, in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Cleared-GenerationResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
supply: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/generation/fuel-type:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-generation-fuel-type
summary: Day-Ahead Generation Fuel Type
description: Generation fuel mix (in megawatts) of units cleared in the day-ahead market for the various fuel types in the MISO footprint, by region in hourly intervals. Available at 2pm EST the day before. 'Coal' includes combination coal/gas units; 'Gas' includes combination oil/gas units; 'Storage' includes pumped storage, ESR, and battery units. 'Solar' data is only available from 2022-01-01 onwards.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Generation-Fuel-TypeResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
fuelTypes:
coal: 0
gas: 0
nuclear: 0
water: 0
wind: 0
solar: 0
other: 0
storage: 0
totalMw: 0
interval: string
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/generation/offered/ecomax:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-generation-offered-ecomax
summary: Day-Ahead Offered Generation ECOMAX
description: The Economic Maximum offered by generators in the day-ahead market, by region in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Offered-GenerationResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
mustRun: 0
economic: 0
emergency: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/generation/offered/ecomin:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-generation-offered-ecomin
summary: Day-Ahead Offered Generation ECOMIN
description: The Economic Minimum offered by generators in the day-ahead market, by region in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Offered-GenerationResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
mustRun: 0
economic: 0
emergency: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/interchange/net-scheduled:
servers:
- url: https://apim.misoenergy.org/lgi
get:
operationId: get-v1-day-ahead-date-interchange-net-scheduled
summary: Day-Ahead Net Scheduled Interchange
description: Net scheduled interchange (NSI) that cleared the day-ahead market, by region in hourly intervals. Positive values indicate imports. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: region
in: query
required: false
schema:
type: string
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-Day-Ahead-Net-Scheduled-InterchangeResponse-json'
example:
data:
- timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
region: NORTH
nsi: 0
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/asm-exante:
servers:
- url: https://apim.misoenergy.org/pricing
get:
operationId: get-v1-day-ahead-date-asm-exante
summary: Day-Ahead Ex-Ante MCP
description: Historical ex-ante market clearing prices (MCP) for the day-ahead (DA) ancillary services market (ASM), by reserve zone in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: product
in: query
required: false
description: Filter to a specific product (e.g. "Regulation", "Spin", "Supplemental", "STR", "Ramp-up", "Ramp-down").
schema:
type: string
enum:
- Regulation
- Spin
- Supplemental
- STR
- Ramp-up
- Ramp-down
- name: zone
in: query
required: false
description: Filter to a specific Reserve Zone (e.g. "Zone 1", ..., "Zone 8").
schema:
type: string
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-MCPResponse-json'
example:
data:
- interval: '1'
timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
product: Regulation
zone: Zone 1
mcp: 6.48
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/asm-expost:
servers:
- url: https://apim.misoenergy.org/pricing
get:
operationId: get-v1-day-ahead-date-asm-expost
summary: Day-Ahead Ex-Post MCP
description: Historical ex-post market clearing prices (MCP) for the day-ahead (DA) ancillary services market (ASM), by reserve zone in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
- name: product
in: query
required: false
description: Filter to a specific product (e.g. "Regulation", "Spin", "Supplemental", "STR", "Ramp-up", "Ramp-down").
schema:
type: string
enum:
- Regulation
- Spin
- Supplemental
- STR
- Ramp-up
- Ramp-down
- name: zone
in: query
required: false
description: Filter to a specific Reserve Zone (e.g. "Zone 1", ..., "Zone 8").
schema:
type: string
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-MCPResponse-json'
example:
data:
- interval: '1'
timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
product: Regulation
zone: Zone 1
mcp: 6.48
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/lmp-exante:
servers:
- url: https://apim.misoenergy.org/pricing
get:
operationId: get-v1-day-ahead-date-lmp-exante
summary: Day-Ahead Ex-Ante LMP
description: Historical ex-ante locational marginal prices (LMP) for the day-ahead (DA) energy market, by commercial pricing node (CPNode) in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: node
in: query
required: false
description: Filter to a specific Commercial Pricing Node.
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-LMPResponse-json'
example:
data:
- interval: '1'
timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
node: ALTW.WELLS1
lmp: 21.6
mcc: 0.02
mec: 20.94
mlc: 0.64
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
/v1/day-ahead/{date}/lmp-expost:
servers:
- url: https://apim.misoenergy.org/pricing
get:
operationId: get-v1-day-ahead-date-lmp-expost
summary: Day-Ahead Ex-Post LMP
description: Historical ex-post locational marginal prices (LMP) for the day-ahead (DA) energy market, by commercial pricing node (CPNode) in hourly intervals. Available at 2pm EST the day before.
parameters:
- name: date
in: path
required: true
description: 'Market date in the form: yyyy-mm-dd'
schema:
type: string
format: date
- name: interval
in: query
required: false
description: Filter to a specific time interval (ex. "13:05", "13"), in Eastern Standard Time (UTC−05:00).
schema:
type: string
- name: node
in: query
required: false
description: Filter to a specific Commercial Pricing Node.
schema:
type: string
- name: pageNumber
in: query
required: false
schema:
type: integer
format: int32
default: 1
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/200-OK-LMPResponse-json'
example:
data:
- interval: '1'
timeInterval:
resolution: daily
start: '2023-06-28 00:00:00.000'
end: '2023-06-29 00:00:00.000'
value: '2023-06-29'
node: ALTW.WELLS1
lmp: 21.6
mcc: 0.02
mec: 20.94
mlc: 0.64
page:
pageNumber: 0
pageSize: 0
totalElements: 0
totalPages: 0
lastPage: true
'400':
description: Invalid date format
content:
application/json: {}
'401':
description: Invalid or missing Bearer Token in the Authorization header
content:
application/json: {}
'404':
description: Date not found
content:
application/json: {}
tags:
- Day Ahead
components:
schemas:
200-OK-MCPResponse-json:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/MarketClearingPrice'
page:
$ref: '#/components/schemas/PageInfo'
x-apim-inline: true
ClearedGeneration:
type: object
properties:
timeInterval:
$ref: '#/components/schemas/TimeInterval'
region:
$ref: '#/components/schemas/Region'
supply:
type: number
description: Total supply cleared (in megawatts) based on physical or virtual offers.
TimeInterval:
type: object
properties:
resolution:
enum:
- 5min
- hourly
- daily
type: string
example: daily
start:
pattern: ([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2}).([0-9]{3})
type: string
description: In Eastern Standard Time (UTC−05:00).
example: '2023-06-28 00:00:00.000'
end:
pattern: ([0-9]{4})-([0-9]{2})-([0-9]{2}) ([0-9]{2}):([0-9]{2}):([0-9]{2}).([0-9]{3})
type: string
description: In Eastern Standard Time (UTC−05:00).
example: '2023-06-29 00:00:00.000'
value:
type: string
description: 'Short hand value for time interval. Can be timestamp for 5min resolution (ex: 2023-06-28 00:00:00.000), hour ending value for hourly resolution, 1-24 (ex: 21), or date string for daily (ex: 2023-06-28). In Eastern Standard Time (UTC−05:00).'
example: '2023-06-29'
200-OK-Day-Ahead-Net-Scheduled-InterchangeResponse-json:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/DayAheadNetScheduledInterchange'
page:
$ref: '#/components/schemas/PageInfo'
x-apim-inline: true
200-OK-Offered-GenerationResponse-json:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/OfferedGeneration'
page:
$ref: '#/components/schemas/PageInfo'
x-apim-inline: true
200-OK-Cleared-GenerationResponse-json:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ClearedGeneration'
page:
$ref: '#/components/schemas/PageInfo'
x-apim-inline: true
OfferedGeneration:
type: object
properties:
timeInterval:
$ref: '#/components/schemas/TimeInterval'
region:
$ref: '#/components/schemas/Region'
mustRun:
type: number
description: The economic minimum/maximum (in megawatts) offered by generators with the must run commit status in the day-ahead market.
economic:
type: number
description: The economic minimum/maximum (in megawatts) offered by generators as economic in the day-ahead market.
emergency:
type: number
description: The economic minimum/maximum (in megawatts) offered by generators as emergency in the day-ahead market.
200-OK-DayAhead-DemandResponse-json:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/DayAheadDemand'
page:
$ref: '#/components/schemas/PageInfo'
x-apim-inline: true
DayAheadNetScheduledInterchange:
type: object
properties:
timeInterval:
$ref: '#/components/schemas/TimeInterval'
region:
$ref: '#/components/schemas/Region'
nsi:
type: number
LocationalMarginalPrice:
type: object
properties:
interval:
type: string
example: '1'
timeInterval:
$ref: '#/components/schemas/TimeInterval'
node:
type: string
description: Commercial Pricing Node
example: ALTW.WELLS1
lmp:
type: number
description: Locational Marginal Price
example: 21.6
mcc:
type: number
description: Marginal Congestion Component
example: 0.02
mec:
type: number
description: Marginal Energy Component
example: 20.94
mlc:
type: number
description: Marginal Losses Component
example: 0.64
Region:
enum:
- NORTH
- CENTRAL
- SOUTH
- MISO
- NO_REGION
type: string
GenerationFuelType:
type: object
properties:
timeInterval:
$ref: '#/components/schemas/TimeInterval'
region:
$ref: '#/components/schemas/Region'
fuelTypes:
$ref: '#/components/schemas/FuelType'
totalMw:
type: number
interval:
type: string
DayAheadDemand:
type: object
properties:
timeInterval:
$ref: '#/components/schemas/TimeInterval'
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/miso/refs/heads/main/openapi/miso-day-ahead-api-openapi.yml