get_insider_scorecard
Assess an insider's buy track record using hit rate and average return scores. Only reports statistics when sufficient sample size exists to prevent misleading results.
Instructions
Get insider buy track-record scorecard (Pro plan+). Returns the historical hit rate and average/median return of an insider's discretionary open-market buys (TransactionCode=P, excluding 10b5-1 plans and derivatives), plus their best and worst scored buy. Scores use absolute return (NOT market-adjusted) anchored at the filing-date close. A 'hit' is a scored buy whose 3m (or 6m) return is positive. Use this over GET /v1/insiders/{cik}/summary when you specifically want a scored track record (with a sample-sufficiency guard) rather than raw totals; use GET /v1/insiders/leaderboard (Business+) to rank many insiders by this same methodology. Score fields (hitRate3m, avgReturn3m, etc.) are null when the insider has fewer than 5 matured scored buys (sampleSufficient=false), preventing misleading statistics from small samples. Requires Pro plan or higher (402 PLAN_REQUIRED on Free/Starter). Returns 404 NOT_FOUND if the CIK isn't tracked. Computed live — no caching. Note: all return fields (HitRate3m, AvgReturn3m, MedianReturn3m, etc.) are stored as FRACTIONS — 0.05 means +5%, -0.10 means -10%.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | Insider's SEC CIK, exact match. |