# Form 4 API: SEC insider trades as JSON

Canonical: https://sec-api.dev/form-4-api

> sec-api.dev's Form 4 API returns SEC Form 4 insider transactions as JSON two ways: GET /api/v1/insider-transactions filters 409,548 as-filed transaction rows from the SEC's quarterly Form 3, 4 and 5 data sets (Q4 2025, Q1 2026, Q2 2026, Q3 2026) by transaction code, issuer CIK, form, direction and footnotes, and GET /api/v1/insider-trades parses one Form 4 filing by accession number; every row keeps its accession, footnotes and sec.gov URL, on every plan including the free one.

sec-api.dev, not sec-api.io. Checked 2026-11-16.

**Free plan:** 100 API requests a month, 30 a minute, no credit card. Get a key: https://sec-api.dev/sign-up?ref=ai-claudebot

## Key facts

Endpoint facts as of November 16, 2026.

| Field | Value |
| --- | --- |
| Cross-issuer endpoint | GET /api/v1/insider-transactions?period=2026q3&form=4&transactionCode=P |
| Filters | period (YYYYqN), cik, form (4, 4/A, 3, 5), transactionCode (exact SEC code), direction (A or D), type (nonDerivative or derivative), hasFootnotes, facets, limit (max 500), offset |
| Single-filing endpoint | GET /api/v1/insider-trades?cik=...&accession=... (parses the filing's ownership XML) |
| Coverage | Q4 2025: 80,117 rows; Q1 2026: 141,643 rows; Q2 2026: 108,698 rows; Q3 2026: 79,090 rows |
| Freshness | Quarterly SEC data sets, imported after the SEC publishes each quarter. Not a real-time Form 4 feed; new filings appear in the filing stream (GET /api/v1/stream/filings) as they are filed. |
| Plans | Every plan. Free: 100 requests every month, no card. Builder $29/month (50,000 requests), Scale $99/month (250,000 requests) |

## Real Form 4 rows from Q3 2026

These rows come from the SEC's Q3 2026 insider transactions data set (retrieved 2026-10-27), the same archive the API serves. Values are as filed: shares and price are the reported strings, and value is shares times price where a price was reported.

| Filed | Issuer | Reporting owner | Code | Shares | Price | Value | Accession |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 2026-09-30 | GROUP 1 AUTOMOTIVE INC (GPI) | Conifer Management, L.L.C. | P | 16,514 | $243.42 | $4,019,838 | [0000905148-26-004310](https://www.sec.gov/Archives/edgar/data/1031203/000090514826004310/0000905148-26-004310-index.html) |
| 2026-09-30 | HERSHEY CO (HSY) | HERSHEY TRUST CO TRUSTEE IN TRUST FOR MILTON HERSHEY SCHOOL | S | 891 | $161.49 | $143,888 | [0000950142-26-002643](https://www.sec.gov/Archives/edgar/data/47111/000095014226002643/0000950142-26-002643-index.html) |

## Transaction codes in Q3 2026

38,152 ownership filings from 4,716 issuers and 23,769 reporting owners reported 59,885 non-derivative and 19,205 derivative transaction rows. 25,949 of 28,469 Form 4 filings (91%) were filed within two business days of the transaction; the median lag was 2 business days.

| Code | Meaning | Non-derivative rows | Derivative rows |
| --- | --- | --- | --- |
| [S](https://sec-api.dev/form-4-transaction-codes) | Open market or private sale | 25,441 | 409 |
| [A](https://sec-api.dev/form-4-transaction-codes) | Grant or award from the issuer | 9,817 | 7,483 |
| [M](https://sec-api.dev/form-4-transaction-codes) | Exercise or conversion of a derivative | 7,433 | 8,048 |
| [F](https://sec-api.dev/form-4-transaction-codes) | Shares withheld for tax or exercise price | 6,802 | 32 |
| [P](https://sec-api.dev/form-4-transaction-codes) | Open market or private purchase | 5,184 | 225 |
| [D](https://sec-api.dev/form-4-transaction-codes) | Disposition to the issuer | 1,382 | 1,352 |
| [J](https://sec-api.dev/form-4-transaction-codes) | Other acquisition or disposition (described in footnotes) | 1,679 | 561 |
| [C](https://sec-api.dev/form-4-transaction-codes) | Conversion of a derivative | 903 | 854 |

## Example: Form 4 purchases (code P) in Q3 2026

Follow pagination.nextOffset and send meta.snapshotId back as snapshot so every page comes from the same import. form=4 does not include form=4/A; request amendments separately.

Request:

```bash
curl "https://sec-api.dev/api/v1/insider-transactions?period=2026q3&form=4&transactionCode=P&limit=1" -H "Authorization: Bearer $SEC_API_KEY"
```

Response shape (fields trimmed; real row from the 2026q3 data set):

```json
{
  "data": [
    {
      "recordType": "nonDerivativeTransaction",
      "accessionNumber": "0000905148-26-004310",
      "issuerCik": "0001031203",
      "issuerName": "GROUP 1 AUTOMOTIVE INC",
      "form": "4",
      "filingDateReported": "30-SEP-2026",
      "periodOfReport": "30-SEP-2026",
      "sourceTable": "NONDERIV_TRANS",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/1031203/000090514826004310/0000905148-26-004310-index.html",
      "fields": {
        "TRANS_CODE": "P",
        "TRANS_SHARES": "16514.0",
        "TRANS_PRICEPERSHARE": "243.42",
        "TRANS_ACQUIRED_DISP_CD": "A",
        "SHRS_OWND_FOLWNG_TRANS": "1894907.0",
        "DIRECT_INDIRECT_OWNERSHIP": "I"
      },
      "footnotes": []
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 0,
    "nextOffset": 1
  },
  "meta": {
    "period": "2026q3",
    "snapshotId": "...",
    "source": "https://www.sec.gov/files/datastandardsinnovation/data/insider-transactions-data-sets/2026q3_form345.zip"
  }
}
```

## Two workflows, two different records

| Your task | Use | Scope |
| --- | --- | --- |
| Filter purchases, sales or awards across all issuers in a quarter | GET /api/v1/insider-transactions | Derivative and non-derivative transaction tables from the SEC quarterly data set; holdings rows are not returned |
| Read one Form 4 filing as soon as you have its accession | GET /api/v1/insider-trades | Transactions and holdings from that filing's ownership XML |
| See issuer and owner history in a browser | [Insider trading by company](https://sec-api.dev/insider-trading) | Pages built from the latest quarter |

## What this Form 4 API does not do

It does not reconcile amendments into corrected trades, net purchases against sales, or compute returns. It is not a sub-second Form 4 push feed: the quarterly tables lag the SEC's publication, and the filing stream announces new filings without parsing them. Insider history starts in Q4 2025, so research that needs ten years of Form 4 data needs a deeper archive such as sec-api.io or the SEC data sets themselves.

## FAQ

### Is there an API for SEC Form 4 filings?

Yes. The SEC publishes Form 4 data as quarterly bulk files and raw XML, without a query API. sec-api.dev exposes those rows as JSON with filters at GET /api/v1/insider-transactions and parses single filings at GET /api/v1/insider-trades.

### How do I get only insider purchases?

Filter transactionCode=P and form=4. P covers open-market or private purchases; read the footnotes before treating a row as an exchange purchase.

### How current is the Form 4 data?

The cross-issuer endpoint serves SEC quarterly data sets (Q4 2025, Q1 2026, Q2 2026, Q3 2026). For a filing made today, use the filing stream to find its accession and the single-filing endpoint to parse it.

### Is the Form 4 API free?

Yes, every plan includes it; the free plan has 100 requests every month, no card. Builder is $29/month for 50,000 requests.

## Sources

- [SEC: Insider transactions data sets](https://www.sec.gov/data-research/sec-markets-data/insider-transactions-data-sets)
- [SEC: Form 4 and transaction code instructions](https://www.sec.gov/files/form4.pdf)
- [sec-api.dev OpenAPI](https://sec-api.dev/openapi.json)

## Related

- [Insider trading API](https://sec-api.dev/insider-trading-api)
- [Insider trading data with Python](https://sec-api.dev/insider-trading-api/python)
- [Form 4 transaction codes](https://sec-api.dev/form-4-transaction-codes)
- [Form 4 explained](https://sec-api.dev/sec-forms/form-4)
- [13F API](https://sec-api.dev/13f-api)
- [SEC EDGAR API](https://sec-api.dev/sec-edgar-api)
- [Pricing](https://sec-api.dev/pricing)

---
Independent. Not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission. Data is reproduced from public SEC filings and datasets. Not investment advice. Not affiliated with sec-api.io.
