---
title: "Api Peers Get"
method: GET
path: "/api/peers"
tags: ["Portfolio"]
---

# Api Peers Get

`GET /api/peers`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/peers`
- Auth: none declared

Peer comparison data.

## Query parameters

- `ticker` string, nullable

## Response `200`

Successful Response

- PeersResponse: `GET /api/peers` response. F4 schema addition (2026-04-30): `ticker`, `subject`, `peers`, `peerTickers` REQUIRED. Both the 200 success path (data/peers.py:fetch_peer_comparison) and the 500 fallback include the same 4 keys. Frontend peer-comparison panel reads `data.ticker` for the header, iterates `data.peers.forEach(...)` for the comparison table, and `data.peerTickers` for the chip rail.
  - `ticker` string, required
  - `subject` object, required
  - `peers` PeerEntry[], required
    - `ticker` string, nullable
    - `company` string, nullable
    - `price` number, nullable
    - `marketCap` number, nullable
    - `sector` string, nullable
  - `peerTickers` string[], required
  - `error` string, nullable

## Other responses

- `400`: Bad Request
- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)