---
title: "Portfolio overlap"
method: GET
path: "/api/fund/overlap"
tags: ["ETF/MF"]
---

# Portfolio overlap

`GET /api/fund/overlap`

![ETF](https://img.shields.io/badge/ETF-14b8a6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Compares the holdings of two ETFs side by side. Returns overlap statistics (shared holdings count, exclusive counts) and per-holding detail showing weights in both portfolios. Uses CUSIP matching on the most recent N-PORT filing for each fund.

## Query parameters

- `symbol1` string, required
- `symbol2` string, required

## Response `200`

Portfolio overlap analysis

- object
  - `symbol1` string
  - `symbol2` string
  - `reportDate1` string — Report date for the first ETF
  - `reportDate2` string — Report date for the second ETF
  - `overlapCount` integer — Number of holdings in both portfolios
  - `onlyIn1Count` integer — Holdings only in the first ETF
  - `onlyIn2Count` integer — Holdings only in the second ETF
  - `overlapWeight1` number — Percentage of first fund's portfolio in shared holdings
  - `overlapWeight2` number — Percentage of second fund's portfolio in shared holdings
  - `holdings` object[] — Per-holding overlap detail (sorted by combined weight)
    - `cusip` string
    - `name` string
    - `mappedSymbol` string, nullable
    - `weight1` number, nullable — Weight in first ETF (%)
    - `weight2` number, nullable — Weight in second ETF (%)
    - `value1` number, nullable — Position value in first ETF (USD)
    - `value2` number, nullable — Position value in second ETF (USD)
    - `overlapStatus` 'both' | 'only_1' | 'only_2' — Whether the holding appears in both portfolios or only one

## Other responses

- `400` — Symbol not found or not a fund (ETF or mutual fund)
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)