Retrieve BESS Analytics macro market data

get

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

Returns a daily time series of market-wide data for the selected category. The fields present in each record depend on the category requested, so read the response schema for the category you are querying. Full methodology is available here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

category

string

enum

required

The category of macro data to return. The structure and fields of the retrieved data vary depending on the selected category.

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.

rateType

string

enum

Defaults to spot

Specifies the type of rate to apply, either 30d avg for a 30-day rolling average or spot for the daily spot rate. This parameter only affects the Spreads category; it is ignored for all others. When 30d avg is selected the first 30 days of the series are consumed by the rolling window and are not returned.

Allowed:

Responses

200A daily time series for the requested category, in ascending date order. Every record carries a date; the remaining fields are category-specific.

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.