---
title: "Insider clusters"
method: GET
path: "/api/v1/insiders/clusters"
tags: ["AlphaYou"]
---

# Insider clusters

`GET /api/v1/insiders/clusters`

## Request

- Base URL: `https://api.alphayou.net`
- URL: `https://api.alphayou.net/api/v1/insiders/clusters`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Companies where several different insiders filed an open-market buy (or sale) on SEC Form 4 inside a short window: how many insiders, how many filings, how many under a 10b5-1 plan, and who. A plain count with its parameters shown, not a score or a prediction.

Plans: Pro.

## Query parameters

- `side` string
- `days` string
- `min` string
- `limit` string

## Response `200`

The requested records.

## Other responses

- `401`: Missing, unrecognised or revoked API key (error key_revoked).
- `403`: This key's plan does not include this endpoint, or the key has been suspended (error key_suspended).
- `404`: Not an endpoint an API key may call.
- `429`: Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again.
- `503`: The request budget could not be checked right now. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/alphayou/apis/alphayou-api.md) · [All operations](https://skmtc.dev/alphayou/apis/alphayou-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphayou/apis/alphayou-api/revisions/cde9e990c368?raw)