insider.clusters
5 crread-onlyMarket-wide insider cluster scan: companies where several distinct insiders made open-market buys (or sells) inside a window — the high-conviction cluster signal. Each cluster names who traded (`who`: "CEO, CFO + 3 directors", plus a `buyers` roster with role, dollars, shares and `stake_change_pct`: shares bought as a share of what that insider already held, from the filing's own post-transaction balance), the largest buyer, and per-day `activity`. Ranked by distinct-insider count, then total value. Clusters that are an allocation rather than independent open-market decisions (every purchase at one price on one day, or an issuer whose first Form 4 on record is within 14 days of the buys: IPO allocations, placements, offerings) are returned separately as `offering_clusters`, never inside `clusters`. Cost: 5 credits per call.
Parameters#
| Parameter | Type | Description |
|---|---|---|
daysopt | number | Lookback window in days (default 30, max 180) |
min_insidersopt | number | Minimum distinct insiders to qualify (default 2) |
sideopt | string | Cluster direction (default 'buy')one of: buy, sell |
limitopt | number | Max tickers (1-100, default 25) |
detailopt | boolean | Also return each buyer's individual purchases (date, shares, price, value, accession number) under buyers[].transactions (default false; the roster, roles and stake change are always included) |
Example call#
curl -X POST https://arkolith.com/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "insider.clusters",
"arguments": {
"side": "buy",
"days": 30,
"min_insiders": 3
}
}
}'Example response#
{
"side": "buy",
"window_days": 30,
"as_of": "2026-09-05",
"clusters": [
{
"ticker": "AMRZ", "issuer": "Amrize Ltd", "distinct_insiders": 10, "transactions": 16,
"total_value_usd": 2638162, "latest_transaction_date": "2026-09-02",
"who": "CEO, CFO + 8 directors",
"top_buyer": { "name": "...", "role": "CEO", "value_usd": 1010000 },
"median_stake_change_pct": 12.4,
"activity": [{ "date": "2026-08-11", "purchases": 3, "value_usd": 410000 }],
"flags": [],
"buyers": [
{ "name": "...", "role": "CEO", "value_usd": 1010000, "shares": 20000, "stake_change_pct": 4.1, "new_position": false }
]
}
],
"offering_clusters": [
{ "ticker": "BRVE", "distinct_insiders": 10, "total_value_usd": 159034950,
"flags": ["one_print", "newly_reporting"],
"flag_reasons": ["One price, one day: 10 buyers at $18.00 on Aug 7", "First Form 4 on record for this issuer: Aug 5"] }
]
}