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:statsis the shared headline summary for both kinds:trades,avgReturnPerTrade,winRate,winRateClosed,unpricedCalls.benchmarkis the time-weighted score against SPY bought once and held:twr,spyTwr,difference, drawdowns,sharpe/volatility/alpha/beta,riskStatus(insufficientunder 6 months,provisionalto 35,standardat 36+) withmonths,periods[]and the trailing-3-monthgrowthlines.- Every return is a fraction (
0.0521is 5.21%) and every date isYYYY-MM-DD. Nothing ends inPct. The only dollars are a 13F filing’s as-filedvalueUsd. pickslist the raw record (filing diffs, or call mentions);tradesare our reading of it — the$1lot each call became, itsreturn, SPY over the same window, and the pieces it closed in. EverypickIdin/tradesresolves in/picks; an explicit exit call has no pick row, so its event carriespickId: 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 mediaprofile, 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.
