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

# Insider trades

`GET /api/v1/insiders/trades`

## Request

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

Insider open-market buys and sells from SEC Form 4 filings, newest first: the insider, their role, each trade with date, shares and price, the 10b5-1 plan label and the SEC link. Free keys get the 5 newest filings from the last 90 days; Pro keys page through 365 days with nextCursor. None found means no open-market trade is on file, not that nobody filed.

Plans: Free, Pro.

## Query parameters

- `ticker` string
- `side` string
- `days` string
- `limit` string
- `cursor` 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)