ISO New England provides most of our real-time and historic data through web services, as well as downloadable reports and custom views through ISO Express.
General Information
Web services are XML-formatted application components that are written for computer-to-computer communication using open protocols. Please see these resources for more:
The ISO’s Web Services
See a complete list of ISO web services. Examples of information available include:
- Preliminary real-time locational marginal prices (LMPs)
- Preliminary hourly LMPs
- Final hourly LMPs
- Day-ahead hourly LMPs
- Actual system demand
- Day-ahead constraints
- Real-time constraints
- Interchanges
- Ancillary services
- LMP indices
To apply for automated data access to ISO web services, see the Requests to Access Software and Systems page.
More information about the ISO’s web services:
- Current version: 1.1 deployed November 2013.
- The ISO provides a RESTful interface for energy and market data. The base path is https://webservices.iso-ne.com/api/v1.1
- A WADL description is available at https://webservices.iso-ne.com/api/v1.1?_wadl&_type=xml (you will need to be signed up for Web Services to access the WADL, see the Requests to Access Software and Systems page.)
- All data feeds are available in XML and JSON formats. The desired format can be specified either by adding the appropriate file extension to the request URL (.xml or .json), or by including the appropriate HTTP Accept Header (application/xml or application/json).
Report Information
In order to understand what reports are available from ISO web services, download the ISO Web Services Business Documentation Spreadsheet (updated August 2019). It outlines all of the available reports, descriptions of those reports, the web service address of each report, and information about any available parameters that can be used to pull specific data from those reports. Please see an updated list of available parameters and formatting below.
Parameters and Formats for ISO Web Services
Last updated: 02/02/17 – Added NCPC Type Parameters
| Parameter Formats for Web Services |
|
|
|
|
| Parameter |
Format Mask |
Example |
|
Description |
| Day Parameter |
yyyymmdd |
20140702 |
for |
July 2, 2014 |
|
|
|
|
|
| Month Parameter |
yyyymm |
201312 |
for |
December 2013 |
|
|
|
|
|
| Year Parameter |
yyyy |
2013 |
for |
2013 |
|
|
|
|
|
| Load Zone Parameter |
nnnn |
4000 |
for |
Hub |
|
|
4001 |
for |
Maine Load Zone |
|
|
4002 |
for |
New Hampshire Load Zone |
|
|
4003 |
for |
Vermont Load Zone |
|
|
4004 |
for |
Connecticut Load Zone |
|
|
4005 |
for |
Rhode Island Load Zone |
|
|
4006 |
for |
Southeastern Massachusetts Load Zone |
|
|
4007 |
for |
Western/Central Massachusetts Load Zone |
|
|
4008 |
for |
Northeastern Massachusetts Load Zone |
|
|
|
|
|
| Location Type Parameter (DA Demand) |
XXX, XXXX XXXX |
HUB |
for |
Hub (Note: Only works with "/current" call) |
|
|
LOAD ZONE |
for |
All load zones |
|
|
|
|
|
| Locations Parameter |
[n]nnn |
321 |
for |
Node 321 (internal) |
|
|
4000 |
for |
Hub |
|
|
4001 |
for |
Maine Load Zone |
|
|
4010 |
for |
New Brunswick External Node |
|
|
|
|
(Note: Some internal nodes have, by rule, opted out of publishing - see \locations endpoint) |
|
|
|
|
|
| Dispatch Zone Parameter |
nnnn |
7500 |
for |
Eastern CT |
|
|
7501 |
for |
Northern CT |
|
|
7502 |
for |
Norwalk - Stamford |
|
|
7503 |
for |
Western CT |
|
|
7504 |
for |
Bangor Hydro |
|
|
7505 |
for |
Maine |
|
|
7506 |
for |
Portland Maine |
|
|
7507 |
for |
Boston |
|
|
7508 |
for |
North Shore |
|
|
7509 |
for |
New Hampshire |
|
|
7510 |
for |
Seacoast |
|
|
7511 |
for |
Lower SEMA |
|
|
7512 |
for |
SEMA |
|
|
7513 |
for |
Northwest Vermont |
|
|
7514 |
for |
Vermont |
|
|
7515 |
for |
Central MA |
|
|
7516 |
for |
Springfield MA |
|
|
7517 |
for |
Western MA |
|
|
7518 |
for |
Rhode Island |
|
|
|
|
|
| External Node Parameter |
nnnn |
4010 |
for |
New Brunswick |
|
|
4011 |
for |
New York Northern AC |
|
|
4012 |
for |
HQ Phase II |
|
|
4013 |
for |
HQ - Highgate |
|
|
4014 |
for |
NY Cross Sound Cable |
|
|
4017 |
for |
NY Norwalk-Northport |
|
|
|
|
|
| Location Type Parameter |
XXX. XXXX |
EXT. NODE |
for |
All external nodes |
|
|
INT. AREA |
for |
All internal nodes |
|
|
|
|
|
| Reserve Zone Parameter |
nnnn |
7000 |
for |
Rest Of System |
|
|
7001 |
for |
Southwest Connecticut |
|
|
7002 |
for |
Connecticut |
|
|
7003 |
for |
NEMA/Boston |
|
|
|
|
|
| Capacity Zone Parameter |
[n]nnnn |
8500 |
for |
Rest-of-Pool |
|
|
8501 |
for |
Connecticut |
|
|
8502 |
for |
NEMA-Boston |
|
|
8503 |
for |
Maine |
|
|
8504 |
for |
SEMA/Rhode Island |
|
|
|
|
|
| Interface Name Parameter |
|
NY Oakdale 345KV |
for |
NY Oakdale 345KV |
|
|
NY Central-East |
for |
NY Central-East |
|
|
NY Oakdale 230KV |
for |
NY Oakdale 230KV |
|
|
NY Rochester 345KV |
for |
NY Rochester 345KV |
|
|
PJM 5004/5005 |
for |
PJM 5004/5005 |
|
|
PJM Central |
for |
PJM Central |
|
|
PJM East |
for |
PJM East |
|
|
PJM West |
for |
PJM West |
|
|
|
|
|
| NCPC Type Parameter |
XXXXXXXX |
economic |
for |
Economic |
|
|
highvar |
for |
High VAR |
|
|
var |
for |
VAR |
|
|
gpa |
for |
GPA |
|
|
extloceconomic |
for |
External Location Economic |
|
|
lscpr |
for |
LSCPR |
|
|
rrp |
for |
Rapid Response Pricing Opportunity Cost |
|
|
dloc |
for |
Dispatch Lost Opportunity Cost |
|
|
|
|
|
| Fuel Category (Rollup) Parameter |
[XXXXX]XXX |
Coal |
for |
Coal |
|
|
Hydro |
for |
Hydro |
|
|
Natural Gas |
for |
Natural Gas |
|
|
Nuclear |
for |
Nuclear |
|
|
Oil |
for |
Oil |
|
|
Renewables |
for |
Renewables |
|
|
|
|
|
| Bid Type Parameter |
[XX]XXX |
FIXED |
for |
Fixed Demand Bid |
|
|
PRICE |
for |
Price Sensitive Demand Bid |
|
|
DEC |
for |
Decrement (virtual demand) Bid |
|
|
INC |
for |
Increment (virtual supply) Offer |
|
|
|
|
|
| ARA Parameter |
XXXn |
ARA1 |
for |
First annual reconfiguration auction (FCA 6 and following) |
|
|
ARA2 |
for |
Second annual reconfiguration auction |
|
|
ARA3 |
for |
Third annual reconfiguration auction |
|
|
|
|
|
| CP (Commitment Period) Parameter |
nnnn-nn |
2010-11 |
for |
e.g., 2010-11 Commitment Period, or FCA1 |
|
|
|
|
|
| Market Type Parameter |
XX |
DA
|
for |
Day-Ahead Market |
|
|
RT
|
for |
Real-Time Market |
|
|
|
|
|
| Outage Type Parameter |
[x]xxxx-xxxx |
short-term |
for |
Short-Term Outages |
|
|
long-term |
for |
Long-Term Outages |
|
|
|
|
|
| Equipment Type Parameter |
[XXXXXXXXXXXX]XXXX |
Breaker |
for |
Break |
|
|
Line |
for |
Line |
|
|
PowerTransformer |
for |
Power Transformer |
|
|
|
|
|
| Company Parameter |
[XXXX]XX_XX |
CMP_CC |
for |
Central Maine Power Control Center |
|
|
CONVEX_CC |
for |
Convex Control Center (Northeast Utilities) |
|
|
ME_CC |
for |
Maine Control Center |
|
|
NH_CC |
for |
New Hampshire Control Center |
|
|
NSTAR_CC |
for |
NSTAR Control Center |
|
|
NYISO_CC |
for |
New York ISO Control Center |
|
|
PSNH_CC |
for |
Public Service of New Hampshire Control Center |
|
|
REMVEC_CC |
for |
REMVEC Control Center (National Grid) |
|
|
VELCO_CC |
for |
Vermont Electric Power Control Center |
|
|
|
|
|
|
Xxx |
Eco |
for |
Economic Flag |
| Flags Parameter |
|
Mto |
for |
Major Transmission Outage Flag |
|
|
Ovr |
for |
Overrun Flag |
|
|
|
|
|
|
[XXXXXXXXXX]XXXXX |
Approved |
for |
Approved |
| Status Parameter |
|
Implemented |
for |
Implemented |
|
|
Interim Approved |
for |
Interim Approved |
|
|
Negotiate |
for |
Negotiate |
|
|
Preliminary |
for |
Preliminary |
|
|
Study |
for |
Study |
|
|
Submitted |
for |
Submitted |
|
|
|
|
|
| Request Type Parameter |
[XXX]XXXXXX |
Emergency |
for |
Emergency |
|
|
Forced |
for |
Forced |
|
|
Long Term |
for |
Long Term |
|
|
Opportunity |
for |
Opportunity |
|
|
Short Term |
for |
Short Term |
|
|
|
|
|
| Station Parameter |
XXXXXXXX |
AGAWAM |
for |
Agawam |
|
|
CHSTRSVC |
for |
Chester Static Var Compensator |
|
|
MERIMACK |
for |
Merrimack |
|
|
NORTHFLD |
for |
Northfield |
|
|
STONY_HL |
for |
Stony Hill |
|
|
WALTHAM |
for |
Waltham |
|
|
|
|
(Note: SEE HIGH VOLUME ENDPOINT FOR COMPLETE LISTING) |
| Report Type Parameter |
xxxxxx |
final |
for |
Final data
|
|
|
prelim |
for |
Preliminary data
|
|
|
|
|
|
| ARABP Parameter |
|
ARA1 Bilateral Period 1 |
for |
Bilateral Period for first annual reconfiguration auction
|
|
|
ARA2 Bilateral Period 1 |
for |
Bilateral Period for second annual reconfiguration auction
|
|
|
ARA3 Bilateral Period 1 |
for |
Bilateral Period for third annual reconfiguration auction |
