SEC filings

QuantConomy normalizes the full set of U.S. SEC filing datasets into clean, queryable JSON — insider trades, financial filings, beneficial-ownership and institutional-holding disclosures, current reports, proxy statements, private placements, tender offers, registration statements, and more. Each dataset is exposed as a list endpoint plus a single-record lookup by id, with consistent cursor-style pagination and per-dataset filters.

All SEC endpoints live under https://api.quantconomy.com/api/v1/sec/ and are tagged sec in the API reference.

Plan gating

SEC data requires a paid plan

SEC datasets are available on the Starter plan and above. Requesting any /sec/* endpoint on the Free plan returns 403 Forbidden; requesting it without any API key returns 401 Unauthorized. The free demo key (mtk_demo) does include SEC access (capped at 3 results, like everything on the demo key), so you can explore SEC data before signing up. Upgrade at app.quantconomy.com to unlock SEC data on your own key, then send it as a Bearer token. See Plans & credits for the full feature matrix.

Credits

SEC reads are metered like the rest of the API, but list endpoints are weighted slightly higher because each result is an enriched, normalized record:

• List / aggregate endpoints cost 2 credits per request.
• A single record by id costs 1 credit.

Effective cost is baseCost × your plan's credit multiplier (Professional 0.9, Enterprise 0.7). Running out of credits returns 402. See Plans & credits for details.

Datasets

Every SEC dataset, its endpoint, and what it covers:

Dataset	Endpoint	Description
Insider trades	GET /sec/insider-trades · /sec/insider-trades/:id	Forms 3, 4 & 5 — insider purchases, sales, awards and other changes in beneficial ownership.
Financial filings	GET /sec/financial-filings · /sec/financial-filings/:id	Company financial filings (10-K / 10-Q periodic reports and related financial disclosures).
Beneficial ownership	GET /sec/beneficial-ownership-filings · /sec/beneficial-ownership-filings/:id	Schedule 13D / 13G — large activist or passive stakes (>5% ownership).
Institutional holdings	GET /sec/institutional-holding-filings · /sec/institutional-holding-filings/:id	Form 13F — quarterly equity holdings of institutional investment managers.
Proposed sales	GET /sec/proposed-sales · /sec/proposed-sales/:id	Form 144 — notices of proposed insider sales of restricted or control securities.
Proposed-sale transitions	GET /sec/proposed-sales/transitions	Cross-references each Form 144 against subsequent Form 4 sales to track whether the proposed sale was actually executed.
Filing amendments	GET /sec/filing-amendments · /sec/filing-amendments/:id	Amended filings (/A forms) — restatements and corrections to previously filed documents.
Current report items	GET /sec/current-report-items · /sec/current-report-items/:id	Item-level entries extracted from Form 8-K current reports, each with a deterministic materiality score.
8-K materiality history	GET /sec/current-report-items/materiality-history	The scored 8-K item timeline for a single company (by CIK or trading symbol), most-recent-first.
Late-filing notices	GET /sec/late-filing-notices · /sec/late-filing-notices/:id	Form NT (NT 10-K / NT 10-Q / NT 20-F) late-filing notifications under Rule 12b-25.
Proxy statements	GET /sec/proxy-statements · /sec/proxy-statements/:id	Form DEF 14A definitive proxy statements — shareholder votes, executive compensation, board matters.
Private placements	GET /sec/private-placements · /sec/private-placements/:id	Form D — Regulation D exempt private securities offerings.
Tender offers	GET /sec/tender-offers · /sec/tender-offers/:id	Schedule TO and SC 14D9 tender-offer filings (M&A bids and target responses).
Tender-offer events	GET /sec/tender-offers/events	Groups tender-offer filings into one event per target company, linking the bidder’s offer with the target’s response.
Registration statements	GET /sec/registration-statements · /sec/registration-statements/:id	Registration statements driving the IPO and secondary-offering pipeline.
IPO lock-up calendar	GET /sec/registration-statements/lockup-calendar	Upcoming lock-up expirations derived from registration statements that disclose a lock-up period.
Filing text analyses	GET /sec/filing-text-analyses · /sec/filing-text-analyses/:id	NER + sentiment analyses run on key sections of 10-K / 10-Q filings (e.g. Risk Factors).
Filing section diff	GET /sec/filing-text-analyses/:id/diff	Compares an analyzed section against the same filer’s prior period — text similarity, sentiment delta, and newly-added sentences.

Note

List endpoints share a common pagination and filtering convention. Most accept limit and page, and dataset-specific filters such as search, issuerCik, traderCik, formType, and sortBy. Browse the exact query parameters and response schema for each dataset in the sec reference tag.

Worked example

Fetch the most recent Form 4 insider trades for Apple (CIK 0000320193), sorted by filing date. This is a list endpoint, so it costs 2 credits and requires a Starter-or-higher key.

curl

curl "https://api.quantconomy.com/api/v1/sec/insider-trades?issuerCik=0000320193&formType=4&sortBy=filingDate:desc&limit=10" \
  -H "Authorization: Bearer mtk_your_key_here"

JavaScript

const params = new URLSearchParams({
  issuerCik: '0000320193',
  formType: '4',
  sortBy: 'filingDate:desc',
  limit: '10',
});

const res = await fetch(
  `https://api.quantconomy.com/api/v1/sec/insider-trades?${params}`,
  { headers: { Authorization: 'Bearer mtk_your_key_here' } }
);
const { data, meta } = await res.json();

Python

import requests

res = requests.get(
    "https://api.quantconomy.com/api/v1/sec/insider-trades",
    headers={"Authorization": "Bearer mtk_your_key_here"},
    params={
        "issuerCik": "0000320193",
        "formType": "4",
        "sortBy": "filingDate:desc",
        "limit": 10,
    },
)
res.raise_for_status()
data = res.json()["data"]

A successful response uses the standard list envelope:

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accessionNumber": "0001209191-24-012345",
      "formType": "4",
      "issuerCik": "0000320193",
      "issuerName": "Apple Inc.",
      "issuerTradingSymbol": "AAPL",
      "traderName": "Tim Cook",
      "traderOfficerTitle": "Chief Executive Officer",
      "transactionDate": "2024-01-15T00:00:00.000Z",
      "filingDate": "2024-01-17T00:00:00.000Z",
      "transactionType": "sale",
      "transactionShares": 50000,
      "transactionPricePerShare": 185.5,
      "transactionValue": 9275000,
      "isDerivative": false,
      "createdAt": "2024-01-17T12:00:00.000Z"
    }
  ],
  "meta": { "totalCount": 1500000, "count": 10, "limit": 10, "page": 1 }
}

To drill into a single filing, pass its id to the detail endpoint (1 credit), which adds the original document URL and full metadata:

curl "https://api.quantconomy.com/api/v1/sec/insider-trades/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer mtk_your_key_here"

Related

• API reference — sec tag — every parameter and field, per dataset.
• Pagination & filtering — how list endpoints page and filter.
• Plans & credits — what each plan unlocks and credit costs.
• Errors — including the 403 returned when SEC access is not on your plan.