The Time Series resource represents data points in a time series, for a specific segment or security in a portfolio analysis’s results data. Each data point contains values for one or more requested measures. The data points are either periodic (each has a start date and end date) or non-periodic (each exists at a single date).
The key to understanding the Time Series resource is knowing what data can be included in any one request, and how to formulate a query for that data. To this end, please see the documentation for the
time-series-query link relation, which contains the full details.
As of the March 2019 release it is now possible to extract time series data for individual securities via this resource (using new link relations from the segments tree node resource). Prior to this release it had only been possible to extract segment level results. However, when requesting time series data for a security it is possible that the time series results are not immediately available in the returned representation. A
status property is emitted which indicates whether or not time series results are being calculated (= InProgress) or are ready (= Finished). This status is completely independent of the portfolio analysis’s status and only represents that status of this specific request for a single security’s time series. When the
status is returned as Finished status then the data points are emitted as normal. When the
status is returned as InProgress the caller should back-off for a period of time and poll using the
self link until results are available. This is because security level results represent a more heavy duty calculation and as such may not always be immediately available on request. For segment level time series results the
status is always emitted as Finished and so no such polling is required if only interested in segment levels.
See the annotated representations below for details of how the requested information is contained in XML and JSON representations of the resource.
The Time Series resource is exposed via XML and JSON representations, which have the following media type names:- > application/vnd.statpro.revolution.api.time-series+json
When a response is received from the web service with status 200 (= OK), the fact that the response contains a Time Series resource representation is indicated by the presence of one of these two response headers:- > Content-Type: application/vnd.statpro.revolution.api.time-series+json; charset=utf-8
Content-Type: application/vnd.statpro.revolution.api.time-series+xml; charset=utf-8
The Time Series resource links to the Service resource (and to itself). To do so, its resource representations use link relations:-
self link relation identifies the Time Series resource link, in which the representation is the same as the one that has been currently retrieved (so long as the underlying data on the server hasn’t changed).
service link relation identifies the Service resource link.
time-series-query link relation identifies the link that allows a new query for time series data to be made, for the same segment or security (= the segment/security for which the current resource representation contains time series data).
All related resources are accessed using the HTTP GET method.
statuswas added since security level results are not necessarily available immediately. (See Extracting Security Level Time Series for further details) - Mar 2019
seriesTypeXML element and JSON member can have values “Cumulative” and “OverallCustomPeriod”, in addition to “Raw” and “CumulativeIndexed” - January 2014
eulalink relation removed - September 2013
Last updated: Mar 2019