Skip to main content
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.
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).

Added — investor profiles (picks, trades, benchmark)

Four endpoints per investor, on one vocabulary, for two kinds of source:
  • 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 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.