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

# Funds

> GET /api/v2/funds — SEC 13F fund profiles, their inferred trades, and how they did against the S&P 500.

A 13F filing is a **snapshot**, not a transaction: each quarter a fund reports
what it held, not what it bought. Drip diffs consecutive filings, so one stock's
change in one quarter becomes one trade, and a buy plus its later sale becomes a
round trip with a return. Every trade is priced at its own fill, and the whole
ledger is measured against **SPY bought once and held** over the same days.

Numbers are fractions, never dollars — no P\&L, no peak capital, no account
return, on the API or the page.

| Route | Access |
| - | - |
| `GET /api/v2/funds` | PRO/EXPERT plan (`401` otherwise, no data) |
| `GET /api/v2/funds/{slug}` | PRO/EXPERT plan (`401` otherwise, no data) |
| `GET /api/v2/funds/{slug}/picks` | PRO/EXPERT plan — see [Investor Profiles](https://docs.dripstack.com/v2/profiles.md) |
| `GET /api/v2/funds/{slug}/trades` | PRO/EXPERT plan — see [Investor Profiles](https://docs.dripstack.com/v2/profiles.md) |
| `GET /api/v2/funds/{slug}/benchmark` | PRO/EXPERT plan — see [Investor Profiles](https://docs.dripstack.com/v2/profiles.md) |

There is no free tier and no partial response on the account mount: no
credential, a rejected credential, or a credential without a plan is `401` and
returns no data. There is no per-call price either — the plan is the only door.
The wallet twins under `/api/v2/x402/funds/…` are the pay-per-call surface:
**\$0.10 per call, never per page**.

The profile, picks, trades and benchmark shapes are documented once, for both
funds and media sources, in [Investor Profiles](https://docs.dripstack.com/v2/profiles.md).

## Coverage comes with the data

Fills are resolved by a background pipeline, so a fund's numbers are only as
complete as its priced legs. Every profile says so in `coverage`:

* `unpriced` — legs waiting on a price fill
* `heldOut` — fund-group book moves, not trades
* `notReported` — legs that asserted nothing new
* `unbenchmarked` — slices whose SPY leg never resolved
* `unpricedTickers` — the symbols behind `unpriced`

An unscoreable trade stays visible with `stats.unpricedCalls` counting it, never
scored as 0%.

## `GET /api/v2/funds`

Every fund scope the derivation has reached, biggest book first.

```bash theme={null}
curl "https://dripstack.com/api/v2/funds?limit=20&q=berkshire" \
  -H "Authorization: Bearer pk_drip_..."
```

Query parameters:

* `q` (optional): fund name or CIK fragment
* `limit` (optional): 1-100, defaults to 50
* `offset` (optional): rows to skip; `total` says how many matched

```json theme={null}
{
  "tier": "PRO",
  "total": 9221,
  "limit": 1,
  "offset": 0,
  "funds": [
    {
      "cik": "0001067983",
      "ciks": ["0001067983"],
      "name": "Berkshire Hathaway Inc",
      "scope": "CIK",
      "legs": 115,
      "priced": 115,
      "pricedPct": 1,
      "firstTradeDate": "2026-02-17",
      "lastTradeDate": "2026-08-14"
    }
  ]
}
```

## `GET /api/v2/funds/{slug}`

One fund's profile: identity (`profile`), the shared `stats`, the chosen
quarter's `holdings` with each row's change, and one `assets` summary row per
ticker. `{slug}` is a bare CIK (`1067983`) or a name slug ending in the CIK
(`berkshire-hathaway-1067983`).

```bash theme={null}
curl "https://dripstack.com/api/v2/funds/berkshire-hathaway-1067983?quarter=2026-06-30" \
  -H "Authorization: Bearer pk_drip_..."
```

The full shape, plus `/picks`, `/trades` and `/benchmark`, lives in
[Investor Profiles](https://docs.dripstack.com/v2/profiles.md) — one document for both profile kinds.

## Without a plan

There is no preview. The account mount answers `401` with no data when the
credential is missing, rejected, or has no PRO/EXPERT plan — the preview payload
these routes used to serve is gone. Withheld numbers were never fabricated, and
now there is nothing withheld: either the plan reads the record or the call does
not happen.

For a one-off read without a plan, pay per call on the wallet twins
(`/api/v2/x402/funds/{cik}`, `/picks`, `/trades`, `/benchmark`): \$0.10 each,
x402 or MPP, no subscription.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.