> ## 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.

# Changelog

> What changed in the Drip API — breaking changes first, then additions.

Newest first. Breaking changes say what to change; additions say what is now
available.

## Unreleased

### Breaking — stock-picks `stats` now the shared engine summary

`GET /api/v2/sources/{sourceSlug}/stock-picks`,
`GET /api/v2/publications/{slug}/stock-picks` and their wallet twins now report
the same `stats` as `GET /api/v2/sources/{sourceSlug}/profile`: `trades`,
`avgReturnPerTrade`, `winRate`, `winRateClosed`, `unpricedCalls`. One engine,
one win-rate definition.

The legacy `extras` block is removed — `avgReturnPct`,
`simulationReturnPct`, `benchmarkReturnPct`, `alphaPct`. Those were the banned
`Pct` vocabulary, and a second definition of performance; the numbers of record
are the shared `stats` and the time-weighted `benchmark`.

```diff theme={null}
- "stats": { "winRate": …, "winCount": …, "measurableCount": …, "trackedPickCount": …, … }
- "extras": { "avgReturnPct": …, "simulationReturnPct": …, "benchmarkReturnPct": …, "alphaPct": … }
+ "stats": { "trades": 12, "avgReturnPerTrade": 0.0841, "winRate": 0.5833,
+            "winRateClosed": 0.6, "unpricedCalls": 1 }
```

`takes`, `takesExplicitOnly`, `byKind` and the `source` envelope are unchanged.
The `/api/v2/publications/{slug}/stock-picks` route keeps its `deprecated` flag
and still answers.

### Added — five MCP profile tools

`search_profiles`, `get_profile`, `get_profile_picks`, `get_profile_trades` and
`get_profile_benchmark` on the hosted MCP server. Each takes one `profile`
argument (a CIK, a fund slug, or a source slug) and returns exactly the JSON its
HTTP twin returns; `search_profiles` finds both kinds by name (funds also by
CIK). Plan required, like the account mount. `search_sources` / `list_sources`
still return sources only — a fund search does not change their payloads.

### Breaking — the funds preview is gone

`GET /api/v2/funds` and `GET /api/v2/funds/{slug}` no longer answer a caller
without a plan. The `preview` payload shipped briefly on the SEC 13F routes —
`preview: true`, `locked`, `planRequired`, and the numbers withheld — has been
removed. A caller without a PRO or EXPERT plan now gets `401` with no body data,
exactly like every other account-mount route.

These routes are days old and preview-only, so there is no migration path to
keep: if you were reading the preview, subscribe, or pay per call on the wallet
twins (`/api/v2/x402/funds/…`, \$0.10 per call).

```diff theme={null}
- { "preview": true, "locked": ["stats", "benchmark", "trades"], … }
+ 401 { "error": "…", "code": "plan_required" }
```

### Added — investor profiles (picks, trades, benchmark)

Four endpoints per investor, on one vocabulary, for two kinds of source:

| Endpoint | 13F fund | Media source |
| - | - | - |
| profile | `/api/v2/funds/{slug}` | `/api/v2/sources/{sourceSlug}/profile` |
| picks | `/api/v2/funds/{slug}/picks` | `/api/v2/sources/{sourceSlug}/picks` |
| trades | `/api/v2/funds/{slug}/trades` | `/api/v2/sources/{sourceSlug}/trades` |
| benchmark | `/api/v2/funds/{slug}/benchmark` | `/api/v2/sources/{sourceSlug}/benchmark` |

* `stats` is the shared headline summary for both kinds: `trades`,
  `avgReturnPerTrade`, `winRate`, `winRateClosed`, `unpricedCalls`.
* `benchmark` is the time-weighted score against SPY bought once and held:
  `twr`, `spyTwr`, `difference`, drawdowns, `sharpe` / `volatility` / `alpha` /
  `beta`, `riskStatus` (`insufficient` under 6 months, `provisional` to 35,
  `standard` at 36+) with `months`, `periods[]` and the trailing-3-month `growth`
  lines.
* Every return is a **fraction** (`0.0521` is 5.21%) and every date is
  `YYYY-MM-DD`. Nothing ends in `Pct`. The only dollars are a 13F filing's
  as-filed `valueUsd`.
* `picks` list the raw record (filing diffs, or call mentions); `trades` are our
  reading of it — the `$1` lot each call became, its `return`, SPY over the same
  window, and the pieces it closed in. Every `pickId` in `/trades` resolves in
  `/picks`; an explicit exit call has no pick row, so its event carries
  `pickId: null`.
* The account mount requires a PRO or EXPERT plan (no free tier, no partial
  response). The wallet twins under `/api/v2/x402/…` charge **\$0.10 per call**,
  never per page.

`GET /api/v2/sources/{sourceSlug}/stock-picks` is superseded for stats by
`/profile` and `/benchmark`; `GET /api/v2/publications/{slug}/stock-picks` is
deprecated but still answers.

See [Investor Profiles](https://docs.dripstack.com/v2/profiles.md) for the fields, the fill rule, and
`opinions=exclude` ("Direct trades only").

### Added — profile routes on the wallet mount

Seven x402 / MPP twins at \$0.10 per call: the four fund paths above and the
media `profile`, `picks` and `trades` paths. One payment, one call, no
subscription; account credentials are rejected with `403 wallet_only`. An
unknown fund or source is a `404` **after** the payment challenge, never before
it — the endpoint does not confirm which slugs exist to a caller who has not
paid.


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