StatPro Revolution Web API

Change Log

March 2019

  1. New section Client-defined resource pagination via $skip and $top OData system query options added to the Knowledge Base.
  2. The Time Series resource has been extended to support being able to extract security level results. To accommodate this feature the Segments Tree Node resource has been modified to additionally expose links to time series queries from within the securities section.
  3. The Compliance Total Results resource has been extended to additionally expose stressTesting and liquidityRisk properties under the commitment results.
  4. If a portfolio has been closed it will no longer be possible to extract analytics for them, either via the interactive resources or the child resources of the default portfolio analysis. The only exception to this is for previously signed-off results, where you can continue to extract analytics from within the non-interactive child resources of the Awaiting Sign-Off / Signed-Off Portfolio analyses.

Special Notice, Spring 2019

  1. The StatPro Revolution API Authorization Management website will cease to exist from the middle of May 2019. The website itself advertises this fact on its front page (without the need for the user to log in). The front page also describes the reasons for the termination, and describes how the functionality previously afforded by the website has become redundant, or is provided by other means. You can read this same text on the Web API documentation website.

  2. Related to the termination of the API Authorization Management website, and related also to the October 2018 introduction of the token-revocation endpoint, StatPro now has guidance for the authors of Server-Side Web apps and Native apps relating to the revocation of refresh tokens. If your app retains refresh tokens between application sessions, and doesn't prompt the user to grant access each time he/she uses your app, then your app SHOULD be updated to allow the user to drop / revoke the refresh token. Please see this page for full details.

December 2018

  1. The recommended practice for handling transient errors has been updated, please see Handling Transient Errors.
  2. The Interactive Risk Analysis resource has been enhanced with a new parameter benchmark1Performer parameter.
  3. All Analysis resources excluding the Compliance Analysis resource now support additional properties advancedRiskEnabled and fixedIncomeAttributionEnabled. The portfolioTier property no longer exposes a value of Platinum. Advanced Risk functionality that was previously enabled only for portfolios with a portfolioTier of Platinum is now enabled for portfolios with advancedRiskEnabled status equal to true.

October 2018

  1. Interactive applications (Server-Side Web apps and Native apps) can now programmatically revoke refresh tokens, according to RFC 7009. To this end, the StatPro Revolution OAuth2 Server now supports a token-revocation endpoint. StatPro's recommendation is that interactive applications that retain refresh tokens on behalf of end users beyond the lifetime of an application session (e.g. after the user has closed or logged out of the app) SHOULD allow the user to completely negate the app's access to his or her Web API data by revoking the retained refresh token. For full details, see Token Revocation.
  2. The Compliance Backtesting History resource has been enhanced with a new property history.
  3. The Whole Segments Tree resource and Segments Tree Node resource now support a more compact form of period code as an alias for period codes of the form "SpecificDate-yyyyMMdd:SpecificDate-yyyyMMdd". The new compact form supported in the query string is "yyyyMMdd:yyyyMMdd" and will be interpreted in the same way as the verbose form. This is to help alleviate issues when using the CustomTimePeriod Portfolio Analysis resource which makes extensive use of this period code format. When several periods are requested in one go with the verbose form, it can quickly cause the URI length to exceed the maximum limit of 4000 characters. See the Whole Segments Tree link relation for further details.
  4. Improvements have been made to the messages and an errors collections of the PortfolioAnalysis resource, the CompliancePortfolioAnalysis resource, the SignedOffPortfolioAnalysis resource, the AwaitingSign-OffPortfolioAnalysis resource and the CustomTimePeriodPortfolioAnalysis resource. These message collections have been enhanced with new attributes id and categories allowing the client application to respond intelligently to messages, for example by filtering out Risk related messages if Risk is not of interest. The EarliestDate property now supports the value CustomReportingStartDate.
  5. The Interactive Statistics Analysis resource has been enhanced to support compound period Identifiers of type startDateId:endDateId. So for example, it will now be possible to request a period with a baseId of "1W:Latest-5D" to represent a period of "1 week to Latest minus 5 days". For further details, see the corresponding link relation page.
  6. The Interactive Statistics Analysis resource now supports a couple of new forms of "Previous" periods. Specifically we have "Previous Week" ("W-1") and "Previous Day" ("D-1") etc. Refer to the Periods for use with Interactive Statistics Resource page for the full list. The newly added periods are:

    • Previous Day (D-1)
    • Previous Day but 2 (D-3)
    • Previous Day but one (D-2)
    • Previous Week (W-1)
    • Previous Week but 2 (W-3)
    • Previous Week but one (W-2)
  7. New Segments Tree Measures added:

    • LatestContinuousRb
    • LatestContinuousRbAnnual
    • LatestContinuousRp
    • LatestContinuousRpAnnual
    • LatestContNumberOfDaysHeld
  8. New Time Series Measures added:

    • LatestContinuousRb
    • LatestContinuousRp

July 2018

  1. The Segments Tree Node resource representation now includes a new property called totalFilteredItems indicating the total number of child segments or securities available across all pages (when multiple pages are available).
  2. The outgoing link on the Service resource to the Portfolio Analysis Status Bulk resource has been modified so that it doesn't hard-wire the analysis context to 'default'. It now shows a placeholder of {analysisContext}.

May 2018

  1. A new Portfolio Analysis Status Bulk resource has been added allowing for the efficient bulk extraction of one or more latest portfolio analysis calculations. Previously this could only be achieved one portfolio analysis at a time using the various portfolio analysis resources. For details of the usage of this resource, refer to the link relation.
  2. A new Portfolio Impact Dates resource has been added. This resource allows for identifying data changes that may have occurred for a set of one or more portfolios from a user specified date. For further details of the usage of this resource, refer to the link relation.
  3. An additional property statusUpdated added to the PortfolioAnalysis resource, the CompliancePortfolioAnalysis resource, the SignedOffPortfolioAnalysis resource, the AwaitingSign-OffPortfolioAnalysis resource and the CustomTimePeriodPortfolioAnalysis resource. This property signals when the analysis status was last changed.
  4. Parameters referenceDate and holdingsDate have been added to the InteractiveRiskAnalysis resource to enable risk in the past. To be used in conjunction with these two new parameters, a new ReferenceDates resource has been added.
  5. The Portfolio Analysis resource type has been enhanced with new optional property currencyOverlayClassifer.
  6. The Portfolios resource calculationType property supports a new value of TransactionalAggregate for any portfolios configured as this calculation type.

March 2018

  1. The original Fair Usage Policy has been removed. Under this policy, the total number of Web API requests that an application could make on behalf of a tenancy before being automatically blocked or throttled was a function of the number of portfolios that had been purchased for the tenancy. This policy has been deprecated in favour of a less specific and less formulaic approach whereby applications are implicitly trusted to behave sensibly - e.g. by not making too many concurrent requests per second for the same user (i.e. using a particular access token). Note that under the new scheme, the number of requests client applications make is still logged, and these logs are subject to review. Excessive (and unfair) usage may result in action being taken to limit an application's access to the Web API.

  2. An additional property marketValueDerivatives has been added to the commitment results under the Compliance Total Results resource. This property contains the sum of the market value of the derivatives within the portfolio.

  3. A new Compliance Securities link relation and resource type has been added. This is relevant for UCITS portfolios that use the Commitment approach.

  4. The Portfolio Analysis resource type has been enhanced with new optional properties fundInFund, currencyOverlay, and hedgeBenchmark.

  5. New Exchange Rate Sources and Exchange Rate Series link relations and resource types have been added.

December 2017

  1. New Segments Tree Measures added:

    • NetCashFlows
    • Redemptions
    • Subscriptions
    • CtTRR - Transparency Reconciliation Contribution
    • CtTRRGeom - Transparency Reconciliation Contribution (Geometric)

  2. New Time Series Measures added:

    • NetCashFlows
    • Redemptions
    • Subscriptions
    • CtTRR - Transparency Reconciliation Contribution
    • CtTRRGeom - Transparency Reconciliation Contribution (Geometric)

October 2017

  1. An additional property securityAllocationClassifiers has been added to the Portfolio Analysis resource and all other related portfolio analysis resources (except the compliance portfolio analysis for which these are not applicable). This property contains up to 14 security allocation classifiers where each one corresponds to one of the segment measures for AdditionalClassificationXCode and AdditionalClassificationXName.

  2. Additional properties for Time to Liquidate bands have been added to the UCITS results under the ComplianceTotalResults resource.

August 2017

  1. Additional properties InvestmentRegion and InvestmentStrategy added to the PortfolioAnalysis resource, the CompliancePortfolioAnalysis resource, the SignedOffPortfolioAnalysis resource and the AwaitingSign-OffPortfolioAnalysis resource.

June 2017

  1. Following on from February 2017's changes with respect to batch-mode access using Batch applications (see below), the ability for users to create new batch authorizations via the StatPro Revolution API Authorization Management website has been removed. All new batch authorizations are now created by StatPro Client Services for Data Feed User accounts. Note that existing batch authorizations for normal (aka interactive) users will still work, and they can be reviewed / revoked via the API Authorization Management website. It is recommended that existing batch authorizations be phased out, and replaced with batch authorizations for Data Feed User accounts; please talk to your StatPro Client Services representative for further help.

  2. New Portfolio Analysis Controller resource added allowing for the triggering of a re-calculation of one or more custom time periods for default, awaiting sign-off and signed-off analyses. This enables clients of the Web API to extract analysis results at any level (total, segment or security level) for any combination of requested dates on-the-fly.

  3. New Custom Time Period Portfolio Analysis resource added to represent the resulting analysis type produced from the new Portfolio Analysis Controller resource when triggering the calculation of custom time periods.

  4. New Compliance Backtesting History resource added allowing access to the compliance backtesting history of a particular portfolio.

  5. New Compliance Validation History resource added allowing access to the compliance validation history of a particular portfolio.

  6. New Historical Risk Trends resource added allowing access to the historical risk trends of a particular portfolio.

  7. New Liquidity Risk History resource added allowing access to the liquidity risk history of a particular portfolio.

  8. New Portfolio Comments resource added allowing access to the portfolio comments for both compliance validation history and compliance backtesting history, for a particular portfolio.

  9. New Segments Tree Measures added:

    • PercentPositivePeriodsRel
    • ABMVLocal
    • AccruedInterestEnd
    • AccruedInterestLocalEnd
    • AccruedInterestLocalStart
    • AccruedInterestStart
    • BookValueLocalEnd
    • BookValueLocalStart
    • CapitalGain
    • CapitalGainLocal
    • CtpCapitalAnnual
    • CtpCapitalLocalAnnual
    • CtpIncomeAnnual
    • CtpIncomeLocalAnnual
    • IncomeGain
    • IncomeGainLocal
    • PandLLocal
    • RpCapitalAnnual
    • RpCapitalLocalAnnual
    • rpDerivedCur
    • RpDerivedCurAnnual
    • RpIncomeAnnual
    • RpIncomeLocalAnnual
    • RpTrueLocal
    • RpTrueLocalAnnual
    • WeightedTransactions
    • WeightedTransactionsLocal

  10. New Time Series Measures added:

    • AccruedInterestEnd
    • AccruedInterestStart
    • CapitalGain
    • IncomeGain
    • rpDerivedCur
    • RpTrueLocal
    • WeightedTransactions

  11. Additional properties GrossLeverageFlag and UCITSLeverageFlag added to the ComplianceTotalResults resource.

  12. Additional properties leverageWarningThreshold, leverageMaximumThreshold, stressTestList, stressTestWarningThreshold and stressTestMaximumThreshold added to the commitmentLeverageMonitoring section of the CompliancePortfolioAnalysis resource.

February 2017

  1. For batch-mode access using Batch applications, it is no longer recommended that users manually create their own "batch authorizations" using the StatPro Revolution API Authorization Management website. Instead, the preferred method is to use Data Feed User accounts for batch access. Data Feed User accounts are long-lived, non-interactive and inherently "batch" in nature. Data Feed User (DFU) accounts are created and administered by StatPro Client Services. Client Services, as opposed to users, create batch authorizations for DFUs, and email the details of these batch authorizations to owners of the tenancies involved.

  2. Following on from point 1:- the previous method of users creating their own batch authorizations is deprecated, and should no longer be used. The ability for users to create their own (new) batch authorizations still exists, but will be removed in the future. Existing batch authorizations for normal users (i.e. non-DFU accounts) will continue to work for the time being, but may become unsupported in the longer-term future. For more details about this change, and how you should plan to migrate existing batch authorizations, see Using Data Feed User accounts for batch access.

  3. New Segments Tree Measures added:

    • CtpCapital
    • CtpCapitalLocal
    • CtpIncome
    • CtpIncomeLocal
    • RpCapital
    • RpCapitalLocal
    • RpIncome
    • RpIncomeLocal

December 2016

  1. Interactive applications (Server-Side Web apps and Native apps) can now opt-in to a new feature that allows the user to grant access to data in one of his/her alternative tenancies (i.e. a tenancy that the user is a member of, where the tenancy is not the user's home, or primary, tenancy). See the Authorization section's Tenancy Selection page for full details.

  2. The Revolution OAuth2 Server and the API Authorization Management website can no longer be used to view and/or accept the latest Terms of Use that cover the Revolution Web API. The correct place to view/accept the Terms of Use is in the Revolution website, since the Revolution website and Web API share the same Terms of Use.

  3. New Benchmarks resource added allowing access to all available benchmarks.

  4. New Risk Free Rates resource added allowing access to all available risk free rates.

  5. New Portfolio Share Classes resource added allowing access to all available portfolio share classes.

  6. New Portfolio Return Definitions resource added allowing access to all available portfolio return definitions.

  7. In the Portfolio Analysis resource (and other related portfolio analysis resources) some new properties have been added.

  8. New Interactive Statistics Analysis resource added .

  9. New Segments Tree Measures added:

    • ABMV
    • AdditionalClassification1Code
    • AdditionalClassification2Code
    • AdditionalClassification3Code
    • AdditionalClassification4Code
    • AdditionalClassification5Code
    • AdditionalClassification6Code
    • AdditionalClassification7Code
    • AdditionalClassification8Code
    • AdditionalClassification9Code
    • AdditionalClassification10Code
    • AdditionalClassification1Name
    • AdditionalClassification2Name
    • AdditionalClassification3Name
    • AdditionalClassification4Name
    • AdditionalClassification5Name
    • AdditionalClassification6Name
    • AdditionalClassification7Name
    • AdditionalClassification8Name
    • AdditionalClassification9Name
    • AdditionalClassification10Name
    • ExcessKurtosis
    • rpCustom9
    • rpCustom10
    • rpCustom1Annual
    • rpCustom2Annual
    • rpCustom3Annual
    • rpCustom4Annual
    • rpCustom5Annual
    • rpCustom6Annual
    • rpCustom7Annual
    • rpCustom8Annual
    • rpCustom9Annual
    • rpCustom10Annual
    • rpGrossAnnual

  10. New Time Series Measures added:

    • ABMV
    • Fees
    • Income
    • NetTransactions
    • PandL
    • Purchases
    • rpCustom9
    • rpCustom10
    • Sales

February 2016

  1. Additional property IsBalanced added to the Classifiers resource.

  2. Added new optional properties to the Portfolios resource for Description, InceptionDate, CloseDate and PublicOpenDate.

  3. Added new property to the Portfolio Analysis resource (and other related portfolio analysis resources) for EarliestDate indicating the earliest date used by the portfolio analysis.

November 2015

  1. New Classifiers resource added allowing access to all of the available classifiers.

  2. Added support for overriding classifiers in the Interactive Risk Analysis resource.

  3. In the Portfolio Analysis resource (and other related portfolio analysis resources) the classifier 'id' is now also exposed in the resource representation (previously only the classifier names were exposed).

August 2015

  1. New Segments Tree Measures added:

    • Classification1Id
    • Classification2Id
    • Classification3Id
    • EGSLAllocAnnual
    • EGSLTimingAnnual
    • EGSLTotalAnnual
    • ESLAllocAnnual
    • ESLAllocLocalAnnual
    • ESLCurrencyAnnual
    • ESLTimingAnnual
    • ESLTimingLocalAnnual
    • ESLTotalAnnual
    • ESLTotalMCAAnnual
    • InstrumentId
    • SecurityId
    • SegmentSortOrder
    • ValueAtRiskPercentDrift

  2. A new Interactive Risk Analysis resource has been added.

  3. Added new analysis code property to Portfolio Analysis resources.

  4. Added new benchmark code and description properties to Portfolio Analysis resources.

  5. Added new 'portfolioTier' property to Portfolio Analysis resources. This is property supercedes the 'portfolioType' property which is retained for backwards compatibility.

  6. Fixed issue with total level currency overlay not showing results when applying custom time periods in the Mutiple OCP Time Series resource.

June 2015

  1. Start/End Time Series measures are now compoundable via Time Series and Multiple OCP Time Series resources (57 measures affected - for example, WpEnd, WpStart etc). Previously, they would show no value, now they show the earliest or latest value accordingly over the time period requested.

  2. New Segments Tree Measures added:

    • ASRM
    • ASRMAnnualFee
    • ASRMAverage
    • ASRMExpectedReturn
    • ASRMExpectedVolAnnual
    • ASRMExpectedVolAnnualPercent
    • ASRMInvestmentStyle
    • ASRMRiskBand
    • ASRMRiskFreeRate
    • RiskAliasCode

February 2015

  1. Additional portfolio properties for portfolio identifiers, reporting tags, calculation type and calculation context have been added to the Portfolios and Portfolio Reporting Components resources.

  2. A new Portfolio Reporting Tags resource has been introduced to enable the extraction of the available reporting tags within a tenancy.

December 2014

  1. Results can now be extracted for portfolios that have had specific start and end dates configured in the Portfolio Sign-Off Dashboard within the Revolution website (i.e. ones that have been proposed for sign-off and subsequently signed-off). Awaiting Sign-Off Portfolio Analysis and Signed-Off Portfolio Analysis are new resources very similar in structure to the default Portfolio Analysis allowing clients to extract these signed-off and/or awaiting sign-off analysis results.

  2. Portfolios which have been configured to be reporting component alternative settings portfolios are now no longer extracted from the Portfolios resource and are accessed via a new Portfolio Reporting Components resource from the parent portfolio. This better mirrors the way the Revolution website treats these portfolios and allows client applications to more easily interact with such portfolio configurations.

  3. New Segments Tree measures for classifications :

    • Parent Segment Name
    • Additional Classification Level 1 Code
    • Additional Classification Level 1 Name
    • Additional Classification Level 2 Code
    • Additional Classification Level 2 Name
    • Additional Classification Level 3 Code
    • Additional Classification Level 3 Name
    • Additional Classification Level 4 Code
    • Additional Classification Level 4 Name
    • Classification 1 Code
    • Classification 1 Name
    • Classification 2 Code
    • Classification 2 Name
    • Classification 3 Code
    • Classification 3 Name

  4. New Segments Tree and Time Series measures for Equity Risk Numbers:
    • Dividend Yield End
    • Dividend Yield Start
    • Earnings Yield End
    • Earnings Yield Start
    • Market Cap End
    • Market Cap Start
    • PB Ratio End
    • PB Ratio Start
    • PCF Ratio End
    • PCF Ratio Start
    • PE Ratio End
    • PE Ratio Start
    • PS Ratio End
    • PS Ratio Start

  5. New Segment Tree and Time Series measures for Currency Overlay:
    • Benchmark Residual ([CUR])
    • Benchmark Residual ([CUR]) (Geometric)
    • Hedged Currency Contribution ([CUR])
    • Hedged Weight Mean
    • Hedged Weight Start
    • Hedged Weight End
    • Unhedged Currency Contribution ([CUR])
    • Unhedged Weight Mean
    • Unhedged Weight Start
    • Unhedged Weight End

September 2014

  1. Compliance Portfolio Analysis and Compliance Total Results are new resources that allow calling applications to get information relating to portfolios that have been activated for compliance. For each of these portfolios (only), the Portfolios resource exposes a link to the Compliance Portfolio Analysis resource. From there, depending on the status of the compliance analysis, an additional link is exposed to access the Compliance Total Results resource, which contains a large number of total level, compliance-related analytics. For further details, please see the specific documentation pages for the Compliance Portfolio Analysis's link relation and resource, and also the Compliance Total Results link relation and resource.

  2. Whole Segments Tree is a new resource that allows calling applications to get the whole Segments Tree (all segments and all securities) in one request, as opposed to accessing the tree one node at a time via the Segments Tree Node resource. Unlike other resources, the output representation is in a super-compact CSV format (only); XML and JSON formats are not supported. The Whole Segments Tree also publicly exposes segment identifiers, and these are required for requests to the new Multiple OCP Time Series resource (see below). For further details, please see the specific documentation pages for the Whole Segments Tree's link relation and resource.

  3. Multiple OCP Time Series is a new resource that allows calling applications to get Overall Custom Period compounded time series data for multiple measures, multiple segments and multiple time periods in one request. Generally, this will be more efficient than making multiple, separate requests for the same data from the Time Series resource. Unlike other resources, the query data for a request is too complex to be specified in a few URI query strings. For this reason, the query data is included in the entity body of the request, which - unlike other resources - must be sent to the web service via the HTTPS POST method. A request for data must identify one or more segments from the same finished portfolio analysis. For this reason, a request for Multiple OCP Time Series is typically preceded by a request for the Whole Segments Tree resource, which publicly exposes the segments' identifiers (see above). For further details, please see the specific documentation pages for the Multiple OCP Time Series's link relation, resource and special Fair Usage Policy implications.

  4. New Segments Tree measures:-

    • Fees ([CUR])
    • Income ([CUR])
    • Purchases ([CUR])
    • Sales ([CUR])

  5. Segments Tree measure with identifier IsinCode has changed name from Isin to ISIN.

  6. A new Knowledge Base article on how to display measure names correctly has been added.

July 2014

  1. For the Time Series resource, if the requested start date falls on a weekend or bank holiday, then - providing that at least one raw data point is available - the actual start date of the returned resource will be for the data point before the requested start date, as opposed to after (which was the previous behaviour). For example, if the requested start date falls on a Saturday, then previously the start date of the resource was the following Monday, but now it's the previous Friday (assuming that the Friday and Monday in question aren't bank holidays). This way of dealing with time periods' start dates will be used throughout Web API from now on (e.g. in potential future resources that contain time series).

  2. New Segments Tree Node and Time Series measures:-

    • Stock Allocation (local)
    • Stock Currency ([CUR])
    • Stock Timing and Trading Local
    • Stock Picking Effect MC

      Note that, for compounding time series data, measure Stock Picking Effect MC requires the other three as extra measures. All four measures are thus now listed in the table of extra measures required for compounding.

  3. New Segments Tree Node measures (but not Time Series):-
    • Net Transactions ([CUR])
    • Profit & Loss ([CUR])

January 2014

  1. Web API's extended Beta period has finished, and Web API is now a 1.0, officially released, product.

  2. The Time Series resource's functionality has been greatly extended:-

    • 143 measures are now available, up from the previous 7
    • Cumulative compounding of measure values is now supported, in addition to Cumulative Indexed
    • a variation of Cumulative compounding - Overall Custom Period - gives the final, or overall, values in a compounded time series
    • for a Cumulative, Overall Custom Period or Cumulative Indexed time series, requesting measures that cannot be compounded no longer results in a 400 (i.e. Bad Request) error response; instead, null values are returned for such measures.

The new version of the Time Series resource (and its associated time-series-query link relation) is backwardly compatible with the previous version, meaning that existing applications will work exactly as before.

Although 143 measures are now available in the Time Series resource, the maximum number of measures that can be requested in any one HTTPS request to the Web API for a time series is 10. This limit prevents overly large volumes of data being generated and manipulated in any one request.

For further details about this improvement, please see the revised documentation page for the time-series-query link relation, as well as the expanded requestable time series measures table. Note also that there is a very small revision to the Time Series resource's XML and JSON representations in that the seriesType element or member can now have values "Cumulative" and "OverallCustomPeriod", in addition to "CumulativeIndexed" and "Raw".

The Web API Explorer website has been updated to take advantage of these new capabilities, and its source code on GitHub has been similarly updated.

December 2013

  1. Results are now made available even if the Risk calculation failed. The execution of a portfolio's default analysis is comprised of two underlying calculations: the Performance calculation and the Risk calculation. The Risk calculation produces values for risk-related measures (for the Segments Tree Node resource), and the Performance calculation produces values for all the other measures. Previously, if either the Performance or the Risk calculation failed, the status of the portfolio analysis would be FailedWithErrors, and no results data would be made available. Now, if the Risk calculation fails (e.g. because the portfolio doesn't contain any assets that are covered for risk) but the Performance calculation succeeds, the status is FinishedWithMessages and results are made available. In this case:-

    • one or more messages exposed by the Portfolio Analysis resource will explain why the Risk calculation failed
    • requesting risk-related measures for a Segments Tree Node resource will result in null values being returned for those measures.

  2. Measure values returned for the Segments Tree Node resource and the Time Series resource have now been brought into alignment with the values that are displayed in the Revolution desktop website. For certain edge cases, values returned by the Web API used to reflect the raw, unprocessed, underlying data - whereas the website presented a processed, and semantically more correct, view of that data. Processing of the underlying data - where appropriate - is now done in exactly the same way for both the Web API and the website. The most important example of this is in respect to the Benchmark Return measure (id = Rb). Previously, for a portfolio that does not have a benchmark, Web API would return benchmark returns as zero, which in turn could lead to values being returned for relative measures such as Relative Return (= the difference between portfolio return and benchmark return). Now, in alignment with the desktop website, Web API returns null values for Benchmark Return and thus also null values for relative measures that are derived from Benchmark Return (to repeat: for a portfolio that doesn't have a benchmark).

September 2013

  1. End users can now manage the authorizations that allow access to the Web API in the first place, using the newly-introduced StatPro Revolution API Authorization Management website. If a user has granted a client application like the StatPro Revolution Excel Addin or the StatPro Revolution Web API Explorer access to his/her data, it is possible for the application to continue to get access tokens without prompting the user by using a refresh token. Using the new API Authorization Management website, the user can view and revoke their outstanding authorizations. Once an authorization has been revoked, the application in question cannot get an access token from a refresh token, and the app is forced to prompt the user for further access. See the Authorization section's Overview page for more details.

  2. The StatPro Revolution API Authorization Management website also allows end users to view the Fair Usage statistics for the client application that is associated with any one of their outstanding authorizations. Fair Usage stats are displayed for the application in conjunction with the logged-on user's tenancy. This allows users to determine if the application + tenancy is currently blacklisted or throttled, how close it is to being blacklisted, etc.

  3. In addition to Server-Side Web and Native applications, we have added a third type of application that is able to access Web API data via the OAuth2 Server: Batch applications. The authorizations for Server-Side Web and Native applications are interactive (the user is prompted at runtime to grant or deny access) and transient (a granted authorization is not stored in persistent storage, and has a limited lifetime). This is a problem for those applications that run in "batch mode", in that they cannot prompt the user for access at runtime. In order to support such applications, we have introduced the notion of Batch applications and 'batch' authorizations, which are created at setup time (on the API Authorization Management website), and are long-lived. See the Authorization section's Overview page for more details.

  4. We have added a new sample on GitHub to cater for Batch applications.

  5. The Authorization section on this website has been completely revamped to take into account the above changes. In particular, each of the three application types is catered for on its own page, especially with respect to the workflow that is taken to get an access token.

  6. All notion of End User License Agreement (EULA) has been removed from the Web API. I.e. the EULA resource, the eula link relation and the associated endpoint have all been removed. This is a breaking change, but not one that actually affects any client applications. The exposure of a user's EULA in the Web API has become redundant. Instead the user can view (and if necessary accept) the latest version of the Terms of Use that covers the Revolution Web API resource service - either at the time of granting access to an application at runtime on the StatPro Revolution OAuth2 Server, or when managing authorizations on the StatPro Revolution API Authorization Management website.

  7. A new Returns measure, Risk Free Rate Return, is now supported for time series data. Its identifier is Rfr. It is allowed when the series type is Cumulative Indexed. See the full list of time series measures for more details.

  8. New Segments Tree Node measures:-

    • Adjusted Information Ratio (Rel.)
    • Adjusted Information Ratio (XS)
    • Adjusted M-Squared (Ann.)
    • Appraisal Ratio Ann
    • Beta Timing
    • Bias Ratio
    • Burke Ratio
    • Security Currency ISO Code
    • Custom Security Code
    • Downside Potential
    • Ex-Post Expected Upside
    • Ex-Post Potential Upside
    • Ex-Post Rachev Ratio
    • Farinelli-Tibiletti Ratio
    • Half Variance
    • Hurst Index
    • Isin
    • Israelsen's Measure
    • Jarque Bera Test
    • Kappa 3
    • Kappa 4
    • Largest Uninterrupted Drawdown
    • End Local Price
    • Martin Ratio
    • Mean Absolute Deviation
    • Modified Sharpe
    • Omega Ratio
    • Pain Ratio
    • Risk Free Rate Return
    • Display Return ([CUR])
    • Sterling Ratio
    • Ulcer Index
    • Upside Potential
    • Upside PotentialRatio

      Measures Security Currency ISO Code, Custom Security Code and Isin are the first measures to be introduced that are of String data type. They belong to the newly introduced Titles category, and pertain to securities only (their values will be null for segments).

      See the full list of Segments Tree Node measures for more details.

  9. Changes to existing Segments Tree Node measures:-

    • Measure Profit & Loss (id = PandL) is no longer supported
    • Measure Relative Contribution (id = RelCt) is no longer supported
    • Measure Relative Contribution (Geometric) (id = RelCtGeom) is no longer supported
    • Measure Risk Free Return (id = RiskFreeReturnOut) is now called Statistic Risk Free Return

  10. Bug fix. Previously when requesting measures for a Segments Tree Node resource, if a specified measure identifier was valid but the results data didn't contain values for that measure, it was possible for nothing to be returned in the XML / JSON representation of the resource for that measure. The Web API now does the correct thing, which is to ensure that every requested, valid measure is present in the XML / JSON; if no underlying value is present, then the value in the XML / JSON is null.

July 2013

  1. Fair Usage Policy updated to allow organizations with Private Wealth, Advisor and/or NAV-only portfolios (in addition to zero or more Professional portfolios) to be able to access the Web API. Previously an organization had to have at least one Professional portfolio in order to access the Web API (this is no longer the case). Full details of the revised policy are given on the Fair Usage Policy documentation page (+ we added a new section to this page on Unblocking).

  2. Introduced the Web API Explorer website.

  3. Added sample code to GitHub showing how to access the Web API.

Last updated: February 2019

To Top