get_peers | Fundalyze API docs

RESTGET https://api.fundalyze.ai/api/public/v1/get_peersMCPget_peers

Parameters

Parameter	Type	Default	Description
`ticker`required	stringup to 12 characters	—	US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure.

Example

A real call and its answer. Replace fdz_live_YOUR_KEY with your key, or set FUNDALYZE_API_KEY for the Python and JavaScript versions.

get_peers: curl

curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/get_peers?ticker=AAPL"

get_peers: Python

import os

import requests

response = requests.get(
    "https://api.fundalyze.ai/api/public/v1/get_peers",
    params={
        "ticker": "AAPL",
    },
    headers={"Authorization": f"Bearer {os.environ['FUNDALYZE_API_KEY']}"},
    timeout=60,
)
response.raise_for_status()
answer = response.json()
print(answer["text"])
print("Calls left today:", response.headers.get("X-Quota-Remaining"))

get_peers: JavaScript

const params = new URLSearchParams()
params.append("ticker", "AAPL")

const response = await fetch(`https://api.fundalyze.ai/api/public/v1/get_peers?${params}`, {
  headers: { Authorization: `Bearer ${process.env.FUNDALYZE_API_KEY}` },
})
const answer = await response.json()
if (!response.ok) throw new Error(`${response.status}: ${answer.detail}`)
console.log(answer.text)
console.log('Calls left today:', response.headers.get('X-Quota-Remaining'))

get_peers: MCP

The same call as an MCP tools/call: what an assistant sends.

{
  "name": "get_peers",
  "arguments": {
    "ticker": "AAPL"
  }
}

Response

Generated from live data on Oct 7, 2026; figures change as filings arrive. Rows trimmed to the first 5 for the docs: peers had 7.

get_peers: response text

What an assistant reads (and what MCP returns).

AAPL · researched peers (business first, size second) · as of 2026-10-01
ticker,name,exchange,cik
MSFT,MICROSOFT CORP,NASDAQ,789019
GOOG,Alphabet Inc.,NASDAQ,1652044
SONY,Sony Group Corp,NYSE,313838
DELL,Dell Technologies Inc.,NYSE,1571996
HPQ,HP INC,NYSE,47217
... 2 more rows in the full answer (trimmed for the docs)
Basis: Consumer hardware plus a services ecosystem: devices, PCs and platform software.
Unlisted competitors: Samsung Electronics; Xiaomi; Huawei; Lenovo
More: https://fundalyze.ai/stocks/nasdaq/aapl?tab=comps

get_peers: response data

The same content as JSON (REST).

{
  "ticker": "AAPL",
  "peers": [
    {
      "ticker": "MSFT",
      "name": "MICROSOFT CORP",
      "exchange": "NASDAQ",
      "cik": 789019,
      "url": "https://fundalyze.ai/stocks/nasdaq/msft"
    },
    {
      "ticker": "GOOG",
      "name": "Alphabet Inc.",
      "exchange": "NASDAQ",
      "cik": 1652044,
      "url": "https://fundalyze.ai/stocks/nasdaq/goog"
    },
    {
      "ticker": "SONY",
      "name": "Sony Group Corp",
      "exchange": "NYSE",
      "cik": 313838,
      "url": "https://fundalyze.ai/stocks/nyse/sony"
    },
    {
      "ticker": "DELL",
      "name": "Dell Technologies Inc.",
      "exchange": "NYSE",
      "cik": 1571996,
      "url": "https://fundalyze.ai/stocks/nyse/dell"
    },
    {
      "ticker": "HPQ",
      "name": "HP INC",
      "exchange": "NYSE",
      "cik": 47217,
      "url": "https://fundalyze.ai/stocks/nyse/hpq"
    }
  ],
  "unlisted_competitors": [
    "Samsung Electronics",
    "Xiaomi",
    "Huawei",
    "Lenovo"
  ],
  "rationale": "Consumer hardware plus a services ecosystem: devices, PCs and platform software.",
  "researched_at": "2026-10-01T22:12:02.782161+00:00"
}

Fields of data

What each field of data means. rows[].field is a field of each row in the rows list.

Field	Meaning
`peers`	The researched peers (list; see peers[]).
`ticker`	The subject's ticker.
`peers[].ticker`	Peer's ticker, most comparable first.
`peers[].name`	Peer's name from the SEC directory.
`peers[].exchange`	Peer's exchange.
`peers[].cik`	Peer's SEC CIK.
`peers[].url`	Peer's page on fundalyze.ai.
`unlisted_competitors`	Competitors with no US listing, as names.
`rationale`	How the set was chosen.
`researched_at`	When the set was researched (ISO timestamp).

The link

Every answer ends with More: <link>, and REST returns the same URL as link: the fundalyze.ai page where the figures can be checked (here, fundalyze.ai/stocks/nasdaq/aapl?tab=comps). Cite it when you show the data to others, as the attribution rules ask.

Errors

A bad parameter is a 400 naming it, an unknown ticker a 404, a busy key or a used-up day a 429. Every status and message: Errors.

This page as Markdown, for language models and scripts: /developers/md/reference/get_peers