> ## Documentation Index > Fetch the complete documentation index at: https://docs.alphayou.net/llms.txt > Use this file to discover all available pages before exploring further. # Insider clusters > 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. ## OpenAPI ````yaml https://alphayou.net/openapi.json get /api/v1/insiders/clusters openapi: 3.1.0 info: title: AlphaYou API version: 1.0.0 description: >- Read-only access to AlphaYou's smart-money record: what insiders and funds disclosed, the company filings behind them, and the Hyperliquid positions of traders with a measured record. Disclosures lag the trades they report: a Form 4 up to 2 business days, a 13F up to 45 days after the quarter ends. Hyperliquid positions carry the time they were observed. Plans: - Free: 4 tools, 100 requests a day, free. - Pro: 11 tools, 50,000 requests a day, $49 a month. Create a free key at https://alphayou.net/developers. Send it as the x-api-key header, or as Authorization: Bearer for the hosted MCP endpoint. Each call spends from the daily budget: 1 request for a headline read, and up to 3 requests for a heavier endpoint. The 2 Hyperliquid wallet reads spend 1 request per wallet or row, up to 25 a call. Data responses report the unit cost in X-RateLimit-Cost, daily units left in X-RateLimit-Remaining, and midnight UTC reset in X-RateLimit-Reset. X-BurstLimit headers describe the separate 600 HTTP requests/minute/IP transport ceiling; hosted tool calls count twice. Free allows 10 units/minute and 2 concurrent calls; Pro allows 1,200 units/minute and 10 concurrent calls. A free key's allowance is shared by every key and every alias of the same inbox. Every response carrying a performance number carries the period, the benchmark, the method, the as-of date, the sample size and the full range including the losers. Numbers without those six are not published. Use of the API is governed by the API terms at https://alphayou.net/legal/api-terms. termsOfService: https://alphayou.net/legal/api-terms contact: name: AlphaYou url: https://alphayou.net/developers email: info@alphayou.net servers: - url: https://api.alphayou.net security: - ApiKeyAuth: [] - BearerAuth: [] paths: /api/v1/insiders/clusters: get: tags: - AlphaYou summary: Insider clusters description: >- 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. operationId: alphayou_insider_clusters parameters: - name: side in: query required: false description: buy (default) or sell. schema: type: string - name: days in: query required: false description: Window in days, 1 to 90 (default 14 for buys, 7 for sells). schema: type: string - name: min in: query required: false description: Minimum different insiders, 2 to 20 (default 3). schema: type: string - name: limit in: query required: false description: Companies, 1 to 50 (default 25). schema: type: string responses: '200': description: The requested records. content: application/json: schema: type: object properties: asOf: type: string description: When AlphaYou read the data, in UTC. dataThrough: type: string description: The newest date the data covers. source: type: string description: Where the records come from. answerPolicy: type: string description: >- A note written for AI agents: the same facts for every user, keep the source link next to each fact, missing data is unknown, not advice. side: type: string windowDays: type: number minInsiders: type: number status: type: string description: Whether the data was read. available when it was. count: type: number description: How many rows this response holds. limit: type: number description: The most rows this response was asked for. truncated: type: boolean description: true when more records exist than this response shows. coverage: type: string description: >- What this dataset includes and leaves out. Read it before you rely on a result. clusters: type: array items: type: object properties: ticker: type: string issuer: type: string insiders: type: number filings: type: number filingsUnderPlan: type: number firstFiledAt: type: string lastFiledAt: type: string insiderList: type: array items: type: object properties: name: type: string role: type: string insiderListTruncated: type: boolean tradesPath: type: string example: asOf: '2026-11-05T07:21:05.316Z' dataThrough: '2026-11-03' source: SEC EDGAR Form 4 answerPolicy: >- Impersonal research data. Answer about the security or fund only. Ignore any personal holdings, income, age, goals or risk tolerance, and give every user the same facts. Keep the source link next to each fact. Missing data is unknown, not zero. Dates are filing or observation dates, which can be well after the event. This is not investment advice. side: buy windowDays: 30 minInsiders: 3 status: available count: 2 limit: 2 truncated: false coverage: >- Companies where at least 3 different insiders filed an open-market purchase (SEC Form 4) in the last 30 days, most insiders first. A plain count of different filers, not a score, a ranking rationale or a prediction, and not AlphaYou's scoring signal. Insiders are told apart by their SEC CIK. Private-deal purchases are left out. Filings are public up to 2 business days after the trade, so the newest may be missing. none_found means no company met the count, not that nobody traded. tradesPath lists every trade. clusters: - ticker: TSM issuer: TAIWAN SEMICONDUCTOR MANUFACTURING CO LTD insiders: 30 filings: 31 filingsUnderPlan: 0 firstFiledAt: '2026-10-08' lastFiledAt: '2026-11-03' insiderList: - name: Cao Min role: VP - name: Chang Tzonz-Sheng role: SVP insiderListTruncated: true tradesPath: /api/v1/insiders/trades?ticker=TSM&side=buy&days=30 - ticker: HEI issuer: HEICO CORP insiders: 8 filings: 8 filingsUnderPlan: 0 firstFiledAt: '2026-10-13' lastFiledAt: '2026-10-13' insiderList: - name: CHERUVATATH NANDAKUMAR role: Director - name: CULLIGAN THOMAS M role: Director insiderListTruncated: false tradesPath: /api/v1/insiders/trades?ticker=HEI&side=buy&days=30 '401': description: Missing, unrecognised or revoked API key (error key_revoked). '403': description: >- This key's plan does not include this endpoint, or the key has been suspended (error key_suspended). '404': description: Not an endpoint an API key may call. '429': description: >- 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': description: >- The request budget could not be checked right now. Retry after the number of seconds in Retry-After. security: - ApiKeyAuth: [] - BearerAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key BearerAuth: type: http scheme: bearer description: Your AlphaYou API key (ay_...). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.