Retrieve revenue performance for a single BESS asset

get

https://api.cornwall-insight.com/external/v1/bess/assets

Returns a daily revenue time series for one named asset, alongside that asset's static metadata. Revenue is reported in £/MW/hr by default. Set metric=energy to normalise each revenue stream by asset duration and report in £/MWh/hr instead. Full methodology is available here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

asset

string

enum

required

The name of the asset to return. Asset names can also be discovered from the name field of the /bess/projects response.

pricetype

string

enum

required

Trading revenue can be returned using BESS Analytics' Smart Price, Elexon's market price or the dayahead price.

Allowed:

cm_included

string

enum

required

Whether Capacity Market revenue is included in the totals. When true, the Capacity revenue stream is included in total; when false, only Response, Reserve, Trading and Balancing are included and the Capacity field is omitted from each record.

Allowed:

metric

string

enum

Controls how revenue is expressed. power (the default) reports revenue per MW of nameplate capacity. energy divides each revenue stream by the asset duration, reporting revenue per MWh of energy capacity.

Allowed:

rateType

string

enum

Specifies the type of rate to apply, either 30d avg for a 30-day rolling average or spot for the daily spot rate. When 30d avg is selected the first 30 days of the series are consumed by the rolling window and are not returned.

Allowed:

from_date

date

Retrieves data starting from the specified date onward. Can be used together with to_date to fetch data within a defined date range.

to_date

date

Retrieves data up to and including the specified date. Can be used together with from_date to fetch data within a defined date range.

Responses

200Asset metadata together with its daily revenue records.

400The request contained a parameter that is not part of this specification, or omitted a required parameter. The message field lists the offending parameter names.

401Authentication credentials missing or invalid.