> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chicago.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Peers

> Get a list of peer companies for a given stock, including valuation metrics, performance, and Parallax scores.

Get a list of peer companies for a given stock, including valuation metrics, performance, and Parallax scores.

## Query Parameters

| Parameter | Type   | Required | Description                         |
| --------- | ------ | -------- | ----------------------------------- |
| `symbol`  | string | Yes      | Stock symbol (e.g., `AAPL`, `MSFT`) |

## Response

Returns an array of peer companies (including the target stock):

```json theme={null}
[
  {
    "ric": "AAPL.O",
    "company_name": "Apple Inc",
    "market": "United States",
    "mtd": 0.0,
    "ytd": -6.35,
    "pe": 32.12,
    "ev_ebitda": 24.56,
    "roe": 170.68,
    "de": 1.35,
    "mktcap_b": 3731.4,
    "recommendation": "HOLD",
    "value": 2.0,
    "quality": 10.0,
    "momentum": 7.5,
    "defensive": 9.5,
    "tactical": 7.0,
    "total": 6.0
  },
  {
    "ric": "QCOM.O",
    "company_name": "Qualcomm Inc",
    "market": "United States",
    "mtd": 0.0,
    "ytd": -25.55,
    "pe": 26.26,
    "ev_ebitda": 10.2,
    "roe": 23.34,
    "de": 0.7,
    "mktcap_b": 137.41,
    "recommendation": "HOLD",
    "value": 4.5,
    "quality": 10.0,
    "momentum": 4.5,
    "defensive": 8.5,
    "tactical": 6.5,
    "total": 6.3
  }
]
```

## Key Fields

| Field                                                       | Description                                        |
| ----------------------------------------------------------- | -------------------------------------------------- |
| `ric`                                                       | Reuters Instrument Code                            |
| `company_name`                                              | Company name                                       |
| `market`                                                    | Country/market                                     |
| `mtd` / `ytd`                                               | Month-to-date and year-to-date returns (%)         |
| `pe`                                                        | Price-to-earnings ratio                            |
| `ev_ebitda`                                                 | Enterprise value to EBITDA                         |
| `roe`                                                       | Return on equity (%)                               |
| `de`                                                        | Debt-to-equity ratio                               |
| `mktcap_b`                                                  | Market cap in billions (USD)                       |
| `value` / `quality` / `momentum` / `defensive` / `tactical` | Parallax factor scores (0-10)                      |
| `total`                                                     | Composite Parallax score                           |
| `recommendation`                                            | `STRONG BUY`, `BUY`, `HOLD`, `SELL`, `STRONG SELL` |

## Example

```bash theme={null}
curl "https://api.chicago.global/v1/peers?symbol=AAPL" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml GET /v1/peers
openapi: 3.1.0
info:
  title: Parallax API
  description: >-
    Financial data and portfolio analytics API. Analyze portfolios with
    multi-currency support, rebalancing, and comprehensive metrics.
  version: 1.0.0
servers:
  - url: https://api.chicago.global
security:
  - bearerAuth: []
paths:
  /v1/peers:
    get:
      tags:
        - Company
      summary: Peers
      description: >-
        Get a list of peer companies for a given stock, including valuation
        metrics, performance, and Parallax scores.
      operationId: getPeers
      parameters:
        - name: symbol
          in: query
          required: true
          description: Stock symbol (e.g., AAPL, MSFT)
          schema:
            type: string
          example: AAPL
      responses:
        '200':
          description: Peer companies retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PeerCompany'
              example:
                - ric: AAPL.O
                  company_name: Apple Inc
                  market: United States
                  mtd: 0
                  ytd: -6.35
                  pe: 32.12
                  ev_ebitda: 24.56
                  roe: 170.68
                  de: 1.35
                  mktcap_b: 3731.4
                  recommendation: HOLD
                  value: 2
                  quality: 10
                  momentum: 7.5
                  defensive: 9.5
                  tactical: 7
                  total: 6
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PeerCompany:
      type: object
      properties:
        ric:
          type: string
          description: Reuters Instrument Code
        company_name:
          type: string
          description: Company name
        market:
          type: string
          description: Country/market
        mtd:
          type: number
          description: Month-to-date return (%)
        ytd:
          type: number
          description: Year-to-date return (%)
        pe:
          type: number
          description: Price-to-earnings ratio
        ev_ebitda:
          type: number
          description: Enterprise value to EBITDA
        roe:
          type: number
          description: Return on equity (%)
        de:
          type: number
          description: Debt-to-equity ratio
        mktcap_b:
          type: number
          description: Market cap in billions (USD)
        recommendation:
          type: string
          description: STRONG BUY, BUY, HOLD, SELL, STRONG SELL
        value:
          type: number
          description: Parallax value score (0-10)
        quality:
          type: number
          description: Parallax quality score (0-10)
        momentum:
          type: number
          description: Parallax momentum score (0-10)
        defensive:
          type: number
          description: Parallax defensive score (0-10)
        tactical:
          type: number
          description: Parallax tactical score (0-10)
        total:
          type: number
          description: Composite Parallax score
    Error:
      type: object
      properties:
        detail:
          type: string
          description: Error message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key passed as Bearer token

````