Peers

GET/api/company/peers

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 key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

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

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/company/peers?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

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

Response schema

revenue number | null
The subject company's latest annual revenue, reported in `currency`. Null if unavailable.
currency string | null
ISO currency code of the subject's `revenue` (e.g. "USD"), or null if unknown.
peers array of object
Peer companies, closest in revenue scale to the subject first; non-USD reporters and companies with no revenue last.
array of:
- symbol string
  The peer's stock ticker symbol.
- name string
  The peer's company name.
- exchange string | null
  Primary listing exchange of the peer, or null if unknown.
- revenue number | null
  The peer's latest annual revenue, reported in `currency`. Null if unavailable.
- currency string | null
  ISO currency code of the peer's `revenue` (e.g. "USD"), or null if unknown.

Example response

{
  "revenue": 5480717000,
  "currency": "USD",
  "peers": [
    {
      "symbol": "SNAP",
      "name": "Snap Inc",
      "exchange": "NYSE",
      "revenue": 5930000000,
      "currency": "USD"
    },
    {
      "symbol": "PINS",
      "name": "PINTEREST, INC.",
      "exchange": "NYSE",
      "revenue": 4220000000,
      "currency": "USD"
    }
  ]
}

400 Bad Request

Invalid parameters, symbol not found, or the symbol is not a stock

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}