latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

Company

Peers

Stock Pro

Returns up to 6 comparable public companies ("peers") for a stock, alongside the subject's own latest annual revenue so you can judge comparability.

Peers are companies operating in the same industry as the subject, ranked by how close their latest annual revenue is to the subject's (most comparable in scale first). Companies that report in a non-USD currency (or whose revenue is unavailable) are listed last, since their figures aren't directly comparable. Each peer includes its revenue and the currency that revenue is reported in. The subject company is never included in its own peer list.

Only available for stock symbols. Requesting peers for an ETF, mutual fund, or other non-stock symbol returns HTTP 400.

get/api/company/peers

Query parameters

symbolstring

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

Response

The subject's latest annual revenue plus up to 6 peer companies. The peers array is empty if no comparable companies are found.

revenuenumber nullable required

The subject company's latest annual revenue, reported in currency. Null if unavailable.

currencystring nullable required

ISO currency code of the subject's revenue (e.g. "USD"), or null if unknown.

Example response

{
  "revenue": 416161000000,
  "currency": "USD",
  "peers": [
    {
      "symbol": "MSFT",
      "name": "MICROSOFT CORP",
      "exchange": "Nasdaq",
      "revenue": 281724000000,
      "currency": "USD"
    }
  ]
}