Insider clustersLegacy route

Clusters of insider buying across companies: tickers where two or more distinct insiders made purchases (Form 4 code P) in the last 30 days. Call it when the user asks 'where are insiders buying?' or wants market-wide insider conviction rather than one company's filings. Each cluster's as_of_ts is its latest purchase date; complete=false would mean the 30-day scan hit its row cap. Clusters computed from the insider feed also carry n_purchases, n_purchases_priced and total_shares: a purchase re-carried by a later ingest or restated in a later filing (a Form 4/A) counts once. Three or more buyers filled on one day at one identical price are one execution on their behalf (an employee purchase plan, a compensation program or an offering), not separate decisions: n_buyers_same_day_price counts them, cluster_score (n_buyers_discretionary / 5, capped at 1) counts only buyers with a purchase of their own, and plan_purchase=true marks a cluster that is mostly such an execution; plan clusters rank after every discretionary one. total_value_usd is shares times the price as filed, served only for a US-incorporated issuer, or a US line that is not an ADR of an issuer with no traded common listing in Canada (a foreign-incorporated US-only listing files in dollars), and only when every purchase is priced. The reference covers US and Canadian lines only, so a home listing outside North America (London, say) is not seen and such an issuer's total is still served as USD, even where a trade was filed at the home-market price; otherwise it is null and total_value_usd_reason says why: adr_home_market_shares (an ADR's filings report the home-market shares, priced in the home currency, and total_shares counts those shares, not ADRs), foreign_issuer_currency_unknown (a foreign issuer with a listing in Canada), issuer_not_identified, issuer_reference_unavailable or unpriced_purchases. No exchange rate is applied. A 503 dataset_unavailable (refunded) means the feed could not be read, not that nobody bought.

A 200 is a JSON envelope: ok: true and this endpoint's own fields (see Funds & Institutional). It carries X-Request-ID, the credit headers (X-Credits-Cost, X-Credits-Remaining, X-Credits-Receipt, X-Credits-Settlement) and the rate-limit headers.

A 200 is billed even when it holds no data (an empty list, null, found: false), so check those fields. Pricing & credits explains the credit headers.

No error is billed. The body is { "ok": false, "error", "detail", "request_id" }; read the code from error.

This table lists what the spec declares for this route. Error responses lists every code FIRM sends, with when to retry.

Read the Funds & Institutional guide for this endpoint's fields and examples.