GET/performance/{identifier}
Advanced or higher

The return figures an issuer states about itself

Returns by financial year, plus whatever multi-year horizons the issuer publishes. NOTHING HERE IS CALCULATED. Every figure is one the issuer printed in its own annual report, and each carries a link to the announcement it came from. Where an issuer publishes no return this responds 404 rather than computing one — our figure differing from theirs on their own investor page is worse than no figure at all. Resolved to the SHARE CLASS, not the company. An issuer with a Sterling and a Euro line states a separate column for each, and they are different returns on different money. Read periodType before captioning a multi-year figure. cumulative is the total return across the whole period; annualised is the equivalent yearly rate. Issuers publish both, the numbers are far apart, and only the issuer knows which they meant. Read basis for the same reason — a return that reinvests dividends is not comparable with one that does not. Labels, captions and footnotes are supplied so a client renders rather than composes. Number formatting is not: decimals and separators depend on the reader's locale.

Code samples

curl -X GET 'https://api.tickerapp.net/v2/performance/GB00BLDYK618' \
  -H 'x-api-key: $TICKER_API_KEY'

Try it

Try it live
Send a real request to this endpoint with your API key. Sign in to try it from your browser.
Sign in to try →

Parameters

Path parameters

identifierrequired
string

An ISIN, or a symbol in bare (SMT) or MIC-qualified (XLON:SMT) form.

Responses

200The issuer's stated performance figures
{
  "instrument": {
    "isin": string
  },
  "entity": {
    "name": string
  },
  "listing": {
    "symbol": string | null,
    "mic": string
  },
  "data": {
    "asAt": string<date>,
    "asAtLabel": string,
    "financialYears": [object],
    "horizons": [any],
    "captions": {
      "financialYears": string,
      "horizons": string
    },
    "footnotes": [string]
  }
}
403The plan does not include performance data
404Instrument not found, or the issuer publishes no return figures