algoumfinancial data, made clear
♥Donate
HomeWhy?LiveDocumentationResearchAbout♥Donate

Documentation

OverviewGetting startedConventionsEndpoint referenceStreamsData sourcesMethodologyAI assistants (MCP)Pricing and limitsChangelog

Tools

Swagger UIOpenAPI file
algoum is a data service — not investment advice.
DonateContactPricingChangelogLegal NoticeTerms and ConditionsPrivacy PolicyDisclaimer

Endpoint reference

Generated from the API’s own OpenAPI specification, version 1.0.0. What you read here is what the endpoints answer. To send the requests with your own key, use Swagger UI. How the fields are derived from the filings is explained under methodology; if a record does not match its filing, report a data discrepancy.

Insider transactions (Form 4)Material events (Form 8-K)Institutional holdings (Form 13F)Shared helper endpointsData types

Insider transactions (Form 4)

Buys and sells reported by officers, directors and 10% owners, plus the signals derived from them (cluster buys, buy/sell ratio). Source are the SEC forms 4 and 5, which reach the API within minutes of being filed.

GET/v1/insider/transactions#

Search insider trades

Searches individual insider trades, one row per reported transaction. Fixed sort order: filed_at descending, then id descending.

Either ticker or cik is required; a request without both is answered with 400. An unrestricted query would have to scan the whole history.

Parameters

ParameterInTypeDescription
tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

cikquerystring

Central Index Key (alternative to the ticker). Leading zeros are optional: 0000320193 and 320193 return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.

sidequerystring: buy | sell

Trade direction.

rolequeryInsiderRole

Insider role.

form_typequerystring: 4 | 5 | 4/A | 5/A

Filter on the filing source: Form 4, Form 5 or one of their amendments (4/A, 5/A). Without the filter, originals and amendments are both returned.

fromquerystring (date)

First day of the window (YYYY-MM-DD), inclusive. Filtering happens on a pure date field; of an RFC 3339 value only the calendar day counts.

toquerystring (date)

Last day of the window (YYYY-MM-DD), inclusive. Filtering happens on a pure date field; of an RFC 3339 value only the calendar day counts.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/transactions?ticker=AAPL"

Example response — Two insider trades of one company

200 OK
{
  "meta": {
    "request_id": "req_01K4W7YV8Q2N",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "insider_name": "Cook Timothy D",
      "role": "officer",
      "role_detail": "Chief Executive Officer",
      "reporting_owners": [
        {
          "name": "Cook Timothy D",
          "cik": "0001214128",
          "role": "officer",
          "role_detail": "Chief Executive Officer"
        }
      ],
      "side": "sell",
      "code": "S",
      "form_type": "4",
      "original_filed_on": null,
      "shares": 511000,
      "price": {
        "amount": 190.12,
        "currency": "USD"
      },
      "transaction_date": "2026-07-10",
      "filed_at": "2026-07-11T21:03:00-04:00",
      "is_10b5_1": true,
      "ownership": "direct",
      "shares_owned_after": 3280000,
      "filing_id": "0000320193-26-000073",
      "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000073/xslF345X05/wf-form4.xml"
    },
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "insider_name": "Adams Katherine L",
      "role": "officer",
      "role_detail": "General Counsel",
      "reporting_owners": [
        {
          "name": "Adams Katherine L",
          "cik": "0001647728",
          "role": "officer",
          "role_detail": "General Counsel"
        }
      ],
      "side": "buy",
      "code": "P",
      "form_type": "4",
      "original_filed_on": null,
      "shares": 12000,
      "price": {
        "amount": 188.4,
        "currency": "USD"
      },
      "transaction_date": "2026-07-08",
      "filed_at": "2026-07-09T18:22:00-04:00",
      "is_10b5_1": null,
      "ownership": "indirect",
      "ownership_detail": "By family trust",
      "shares_owned_after": 96500,
      "filing_id": "0000320193-26-000071",
      "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000071/xslF345X05/wf-form4.xml"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_namealwaysstring
rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Free text from the filing about the role: for officer the job title, for other the kind of relationship. Not set for director and 10%-owner, and otherwise only when the filing states it.

reporting_ownersalwaysarray of ReportingOwner

All reporters of the filing. A joint filing (a fund, its general partner and the acting person, for instance) lists several; the transaction itself is still reported only once and appears here once. insider_name, role and role_detail describe the first entry of this list.

sidealwaysstring: buy | sell |

Trade direction; empty for Form 5 codes without buy/sell.

codestring

Raw SEC transaction code (P, S, G, A, …).

form_typestring: 4 | 5 | 4/A | 5/A

Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either (4/A, 5/A). An amendment is a correction the insider files later, sometimes months later. It is returned as rows of its own next to the original, which stays unchanged; it usually repeats the whole filing, so do not add the rows of an original and its amendment together.

original_filed_onstring (date) or null

For an amendment (4/A, 5/A), the filing date of the original filing it corrects, as stated in the amendment; null for Form 4 and Form 5. The amendment names only this date, not the original's accession number, so match the original by issuer, insider and this date.

sharesalwaysnumber
pricealwaysstring

Price per share. null when the filing states none – that happens when a trade consisted of several partial executions at different prices and the reporter gives the price in a footnote instead. A reported price of 0 is a real statement, by contrast. Form 4 has no currency field. currency is USD unless the filing itself says otherwise: a footnote on the price naming another currency (for example CAD), or a security title that names a listing outside the US (for example BRL for "Preference shares - BBDC4" on B3). A footnote stating that the price was converted into US dollars keeps USD. Prices in pence are reported as GBX.

transaction_datealwaysstring (date)
filed_atalwaysstring (date-time)
is_10b5_1boolean or null

Planned 10b5-1 sale where detectable; otherwise null.

ownershipstring: direct | indirect |

Whether the insider holds the shares directly (direct) or through a vehicle (indirect). Empty when the filing states nothing.

ownership_detailstring

The holding vehicle in case of indirect ownership. An insider reports the same trade separately per vehicle; without this field such rows are identical in date, share count and price and look like duplicates.

shares_owned_afternumber or null

Reported holding after the transaction, relative to the holding vehicle of this row. null when the filing does not state it – a holding of 0 after a full sale, by contrast, is a real statement.

filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

List of insider transactions.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/insider/recent#

Latest insider trades (cross-market feed)

Chronological feed of the latest insider trades across all companies over the last days days – no ticker/CIK required. Meant as a discovery/screening feed instead of searching symbol by symbol.

days filters the filing time (filed_at), not the trade date. Form 4 may be filed up to two business days after the trade; the feed shows what has just become public. To filter by trade date, use from/to on /insider/transactions. Fixed sort order: filed_at descending, then id descending.

Parameters

ParameterInTypeDescription
daysqueryinteger (1-30, default 1)

Look-back window in days, capped at 30.

sidequerystring: buy | sell | both (default both)

Trade direction; both = both (default).

rolequeryInsiderRole

Insider role.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/recent"

Example response — Two insider trades of one company

200 OK
{
  "meta": {
    "request_id": "req_01K4W7YV8Q2N",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "insider_name": "Cook Timothy D",
      "role": "officer",
      "role_detail": "Chief Executive Officer",
      "reporting_owners": [
        {
          "name": "Cook Timothy D",
          "cik": "0001214128",
          "role": "officer",
          "role_detail": "Chief Executive Officer"
        }
      ],
      "side": "sell",
      "code": "S",
      "form_type": "4",
      "original_filed_on": null,
      "shares": 511000,
      "price": {
        "amount": 190.12,
        "currency": "USD"
      },
      "transaction_date": "2026-07-10",
      "filed_at": "2026-07-11T21:03:00-04:00",
      "is_10b5_1": true,
      "ownership": "direct",
      "shares_owned_after": 3280000,
      "filing_id": "0000320193-26-000073",
      "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000073/xslF345X05/wf-form4.xml"
    },
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "insider_name": "Adams Katherine L",
      "role": "officer",
      "role_detail": "General Counsel",
      "reporting_owners": [
        {
          "name": "Adams Katherine L",
          "cik": "0001647728",
          "role": "officer",
          "role_detail": "General Counsel"
        }
      ],
      "side": "buy",
      "code": "P",
      "form_type": "4",
      "original_filed_on": null,
      "shares": 12000,
      "price": {
        "amount": 188.4,
        "currency": "USD"
      },
      "transaction_date": "2026-07-08",
      "filed_at": "2026-07-09T18:22:00-04:00",
      "is_10b5_1": null,
      "ownership": "indirect",
      "ownership_detail": "By family trust",
      "shares_owned_after": 96500,
      "filing_id": "0000320193-26-000071",
      "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000071/xslF345X05/wf-form4.xml"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_namealwaysstring
rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Free text from the filing about the role: for officer the job title, for other the kind of relationship. Not set for director and 10%-owner, and otherwise only when the filing states it.

reporting_ownersalwaysarray of ReportingOwner

All reporters of the filing. A joint filing (a fund, its general partner and the acting person, for instance) lists several; the transaction itself is still reported only once and appears here once. insider_name, role and role_detail describe the first entry of this list.

sidealwaysstring: buy | sell |

Trade direction; empty for Form 5 codes without buy/sell.

codestring

Raw SEC transaction code (P, S, G, A, …).

form_typestring: 4 | 5 | 4/A | 5/A

Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either (4/A, 5/A). An amendment is a correction the insider files later, sometimes months later. It is returned as rows of its own next to the original, which stays unchanged; it usually repeats the whole filing, so do not add the rows of an original and its amendment together.

original_filed_onstring (date) or null

For an amendment (4/A, 5/A), the filing date of the original filing it corrects, as stated in the amendment; null for Form 4 and Form 5. The amendment names only this date, not the original's accession number, so match the original by issuer, insider and this date.

sharesalwaysnumber
pricealwaysstring

Price per share. null when the filing states none – that happens when a trade consisted of several partial executions at different prices and the reporter gives the price in a footnote instead. A reported price of 0 is a real statement, by contrast. Form 4 has no currency field. currency is USD unless the filing itself says otherwise: a footnote on the price naming another currency (for example CAD), or a security title that names a listing outside the US (for example BRL for "Preference shares - BBDC4" on B3). A footnote stating that the price was converted into US dollars keeps USD. Prices in pence are reported as GBX.

transaction_datealwaysstring (date)
filed_atalwaysstring (date-time)
is_10b5_1boolean or null

Planned 10b5-1 sale where detectable; otherwise null.

ownershipstring: direct | indirect |

Whether the insider holds the shares directly (direct) or through a vehicle (indirect). Empty when the filing states nothing.

ownership_detailstring

The holding vehicle in case of indirect ownership. An insider reports the same trade separately per vehicle; without this field such rows are identical in date, share count and price and look like duplicates.

shares_owned_afternumber or null

Reported holding after the transaction, relative to the holding vehicle of this row. null when the filing does not state it – a holding of 0 after a full sale, by contrast, is a real statement.

filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

Chronological list of the latest insider transactions.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/insider/transactions/{id}#

Get a single transaction

Returns a single transaction including its filing reference.

Parameters

ParameterInTypeDescription
idrequiredpathstring

Resource ID.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/transactions/<id>"

Example response — A single insider trade

200 OK
{
  "meta": {
    "request_id": "req_01K4W80MPT7C",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": {
    "ticker": "AAPL",
    "cik": "0000320193",
    "insider_name": "Cook Timothy D",
    "role": "officer",
    "role_detail": "Chief Executive Officer",
    "reporting_owners": [
      {
        "name": "Cook Timothy D",
        "cik": "0001214128",
        "role": "officer",
        "role_detail": "Chief Executive Officer"
      }
    ],
    "side": "sell",
    "code": "S",
    "form_type": "4",
    "original_filed_on": null,
    "shares": 511000,
    "price": {
      "amount": 190.12,
      "currency": "USD"
    },
    "transaction_date": "2026-07-10",
    "filed_at": "2026-07-11T21:03:00-04:00",
    "is_10b5_1": true,
    "ownership": "direct",
    "shares_owned_after": 3280000,
    "filing_id": "0000320193-26-000073",
    "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000073/xslF345X05/wf-form4.xml"
  }
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_namealwaysstring
rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Free text from the filing about the role: for officer the job title, for other the kind of relationship. Not set for director and 10%-owner, and otherwise only when the filing states it.

reporting_ownersalwaysarray of ReportingOwner

All reporters of the filing. A joint filing (a fund, its general partner and the acting person, for instance) lists several; the transaction itself is still reported only once and appears here once. insider_name, role and role_detail describe the first entry of this list.

sidealwaysstring: buy | sell |

Trade direction; empty for Form 5 codes without buy/sell.

codestring

Raw SEC transaction code (P, S, G, A, …).

form_typestring: 4 | 5 | 4/A | 5/A

Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either (4/A, 5/A). An amendment is a correction the insider files later, sometimes months later. It is returned as rows of its own next to the original, which stays unchanged; it usually repeats the whole filing, so do not add the rows of an original and its amendment together.

original_filed_onstring (date) or null

For an amendment (4/A, 5/A), the filing date of the original filing it corrects, as stated in the amendment; null for Form 4 and Form 5. The amendment names only this date, not the original's accession number, so match the original by issuer, insider and this date.

sharesalwaysnumber
pricealwaysstring

Price per share. null when the filing states none – that happens when a trade consisted of several partial executions at different prices and the reporter gives the price in a footnote instead. A reported price of 0 is a real statement, by contrast. Form 4 has no currency field. currency is USD unless the filing itself says otherwise: a footnote on the price naming another currency (for example CAD), or a security title that names a listing outside the US (for example BRL for "Preference shares - BBDC4" on B3). A footnote stating that the price was converted into US dollars keeps USD. Prices in pence are reported as GBX.

transaction_datealwaysstring (date)
filed_atalwaysstring (date-time)
is_10b5_1boolean or null

Planned 10b5-1 sale where detectable; otherwise null.

ownershipstring: direct | indirect |

Whether the insider holds the shares directly (direct) or through a vehicle (indirect). Empty when the filing states nothing.

ownership_detailstring

The holding vehicle in case of indirect ownership. An insider reports the same trade separately per vehicle; without this field such rows are identical in date, share count and price and look like duplicates.

shares_owned_afternumber or null

Reported holding after the transaction, relative to the holding vehicle of this row. null when the filing does not state it – a holding of 0 after a full sale, by contrast, is a real statement.

filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

A single insider transaction.

401

Missing or invalid API key.

404

Resource not found.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/insider/cluster-buys#

Find cluster buys

Aggregates open-market buys across all companies within the time window and finds companies where at least min_insiders distinct insiders reported a buy. Fixed sort order: number of participating insiders descending, then total value.

How the window is applied, because it decides what the signal means: the window filters transaction_date, not the filing time. Late filings can therefore add earlier trades to the current aggregate. Form 4 may be filed up to two business days after a trade; Form 5 can report much older trades. sec_known_at is the earliest stored filing time at which min_insiders distinct buyers were known for the transactions in the current window. It is not the last filing time and does not establish when a historical rolling-window alert would have fired.

evidence lists the contributing filing/buyer pairs once each, ordered by filing time, filing ID and insider name, with missing times last. Each pair includes the counted owner's role, optional role detail and the stored reporting-owner list. Additional owners are evidence only; they do not increase the buyer count. Missing owner lists are empty. Transaction lines still contribute individually to the existing totals. rule_version identifies the calculation rule; window and min_insiders identify the requested parameters. roles echoes the normalized, deduplicated role filter in alphabetical order; an empty array means no role restriction. Version cluster-buys-v1 preserves the name-based buyer count, the transaction-date window and the rows of original Form 4 and Form 5 filings as reported. Amendments (4/A, 5/A) are neither added nor substituted for the original.

sec_known_at is null if any contributing filing has no usable time. Stored filing times from historical archives may have only date-level precision; no intraday accuracy is inferred. The field does not prove an executable fill or when the API delivered the cluster.

Point in time. Without as_of, the window ends today. With as_of=YYYY-MM-DD, the result is computed as it would have looked at the end of that day in Eastern Time: the window ends on as_of (7d covers as_of and the six days before), and only filings submitted by the end of as_of (midnight Eastern Time) count – for the buyer threshold, the totals, evidence and sec_known_at. A trade inside the window that was reported later, such as on a late Form 5, does not appear. Filings without a usable time are left out, because it is unknown when they became public. Use it for backtests to avoid look-ahead. as_of describes what had been filed with the SEC, not when this API stored or delivered it. A filing submitted on as_of counts even if it was accepted after the market close; a trading decision on that day could not have used it. A date in the future returns 400.

Uniform price. uniform_price is true when at least three of the counted buyers report a price above zero and all their purchase lines in the cluster carry the same price (highest at most 0.1 % above lowest; lines without a price or with a price of 0 are ignored, and the amount is compared regardless of currency). Insiders who buy on the same day at the same price usually did not decide independently: typical sources are a private placement or offering they took part in, or a plan such as dividend reinvestment or fees paid in shares. Set exclude_uniform_price=true to leave them out; they are removed after aggregation and before limit. Without the parameter the result is the same as before, so rule_version stays cluster-buys-v1.

Buys are counted by distinct insider_name, which is the first reporting owner of a filing; a joint filing counts as one buyer, and spelling of the same name varies between filings. All roles are included by default. Optional roles=officer,director filters the stored first owner's role before buyer count, shares, value, dates, evidence and sec_known_at are calculated. A matching additional reporting owner does not qualify a transaction whose first owner's role was excluded. Form 4 and Form 5 count; their amendments (4/A, 5/A) do not. An amendment usually repeats the whole original filing, so counting it would add the same buyer's shares and value twice. Only code P (open market) ever carries side: buy, so awards and option exercises are never included.

Parameters

ParameterInTypeDescription
windowquerystring (default 7d)

Aggregation window, e.g. 7d.

min_insidersqueryinteger (min 1, default 3)

Minimum number of independent buyers.

rolesqueryarray of InsiderRole

Optional comma-separated roles of the first reporting owner. Omit to include all roles. Values are case-insensitive, trimmed and deduplicated. Empty entries, unknown roles and repeated query parameters return 400. Applied before aggregation.

as_ofquerystring (date)

Optional point in time (YYYY-MM-DD, Eastern Time). Computes the clusters as known at the end of that day; see the description above. Omit for today. A date in the future returns 400.

exclude_uniform_pricequeryboolean (default false)

Optional. true leaves out clusters with uniform_price; see the description above. Only true and false are accepted.

limitqueryinteger (1-500, default 50)

Maximum number of results.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/cluster-buys"

Example response — Companies with several buying insiders

200 OK
{
  "meta": {
    "request_id": "req_01K4W81Z4H9D",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": [
    {
      "ticker": "RDFN",
      "cik": "0001382821",
      "insider_count": 4,
      "total_shares": 82000,
      "total_value": {
        "amount": 1246400,
        "currency": "USD"
      },
      "window": "7d",
      "as_of": null,
      "roles": [],
      "first_buy_date": "2026-07-08",
      "last_buy_date": "2026-07-13",
      "min_insiders": 3,
      "uniform_price": false,
      "rule_version": "cluster-buys-v1",
      "sec_known_at": "2026-07-13T10:00:00-04:00",
      "evidence": [
        {
          "filing_id": "0001382821-26-000101",
          "insider_name": "Example Insider A",
          "role": "officer",
          "role_detail": "CEO",
          "reporting_owners": [
            {
              "name": "Example Insider A",
              "cik": "0000000001",
              "role": "officer",
              "role_detail": "CEO"
            }
          ],
          "filed_at": "2026-07-09T10:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/1382821/000138282126000101/primary_doc.xml"
        },
        {
          "filing_id": "0001382821-26-000102",
          "insider_name": "Example Insider B",
          "role": "director",
          "reporting_owners": [],
          "filed_at": "2026-07-10T11:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/1382821/000138282126000102/primary_doc.xml"
        },
        {
          "filing_id": "0001382821-26-000103",
          "insider_name": "Example Insider C",
          "role": "10%-owner",
          "reporting_owners": [],
          "filed_at": "2026-07-13T10:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/1382821/000138282126000103/primary_doc.xml"
        },
        {
          "filing_id": "0001382821-26-000104",
          "insider_name": "Example Insider D",
          "role": "other",
          "reporting_owners": [],
          "filed_at": "2026-07-13T16:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/1382821/000138282126000104/primary_doc.xml"
        }
      ]
    },
    {
      "ticker": "PLAB",
      "cik": "0000806968",
      "insider_count": 3,
      "total_shares": 21500,
      "total_value": {
        "amount": 452150,
        "currency": "USD"
      },
      "window": "7d",
      "as_of": null,
      "roles": [],
      "first_buy_date": "2026-07-09",
      "last_buy_date": "2026-07-12",
      "min_insiders": 3,
      "uniform_price": false,
      "rule_version": "cluster-buys-v1",
      "sec_known_at": null,
      "evidence": [
        {
          "filing_id": "0000806968-26-000101",
          "insider_name": "Example Insider A",
          "role": "officer",
          "reporting_owners": [],
          "filed_at": "2026-07-10T10:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/806968/000080696826000101/primary_doc.xml"
        },
        {
          "filing_id": "0000806968-26-000102",
          "insider_name": "Example Insider B",
          "role": "director",
          "reporting_owners": [],
          "filed_at": "2026-07-13T10:00:00-04:00",
          "source_url": "https://www.sec.gov/Archives/edgar/data/806968/000080696826000102/primary_doc.xml"
        },
        {
          "filing_id": "0000806968-26-000103",
          "insider_name": "Example Insider C",
          "role": "director",
          "reporting_owners": [],
          "filed_at": null,
          "source_url": "https://www.sec.gov/Archives/edgar/data/806968/000080696826000103/primary_doc.xml"
        }
      ]
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_countalwaysinteger

Number of independent insiders with a buy in the window.

total_sharesnumber
total_valueMoney

Monetary amount with currency.

windowalwaysstring
as_ofalwaysstring (date) or null

Requested point in time; null when the window ends today. The stream always sends null.

rolesalwaysarray of InsiderRole

Effective role filter in alphabetical order; empty means all roles.

first_buy_datestring (date)
last_buy_datestring (date)
min_insidersalwaysinteger (min 1)

Requested minimum number of distinct insider names.

uniform_pricealwaysboolean

All counted buyers with a price above zero bought at the same price (at least three, highest at most 0.1 % above lowest) - usually a joint purchase such as a private placement or a reinvestment plan rather than independent decisions. See exclude_uniform_price.

rule_versionalwaysstring: cluster-buys-v1

Version of the name-based, transaction-date aggregation rule.

sec_known_atalwaysstring (date-time) or null

Earliest stored filing time at which the requested number of distinct buyers was known for the current window's transactions. Null if any contributing filing lacks a usable time. Historical archive times may have only date-level precision. Not a historical API publication time or a reconstructed rolling-window alert.

evidencealwaysarray of ClusterBuyEvidence

Contributing filing/buyer pairs without duplicate transaction lines, sorted by filed_at, filing_id and insider_name; missing times last.

Status codes

StatusMeaning
200

Companies with a cluster-buy signal.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/insider/cluster-buys/stream#

SSE stream of new cluster buys

Server-Sent-Events stream. A message is pushed when a newly filed buy lifts a company from below to at least min_insiders distinct buyers under the same rules as /insider/cluster-buys (window, roles, exclude_uniform_price). Every message uses the event name cluster_buy and carries one cluster-buy object as JSON in its data field. Every 30 seconds without traffic the server sends the SSE comment : keepalive.

Only buys filed after the stream service started are considered, so clusters that already exist are not announced, and neither are clusters completed by older filings loaded later. Further buys into an existing cluster and the end of a cluster are not pushed; the snapshot endpoint shows them. New filings are checked every few seconds; the end-to-end latency has not been measured yet.

Messages carry no ID, so a reconnect does not replay what was missed. After a connection drop, catch up through /insider/cluster-buys and then keep listening. Record your own receipt time if you need it. A message is not a trading recommendation and says nothing about prices or executable fills.

A continuous Server-Sent Events stream rather than a single response — the event stream guide walks through a complete client.

Parameters

ParameterInTypeDescription
tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

windowquerystring (default 7d)

Aggregation window on the transaction date, e.g. 7d.

min_insidersqueryinteger (min 1, default 3)

Number of distinct buyers that triggers a message.

rolesqueryarray of InsiderRole

Optional comma-separated roles of the first reporting owner, with the same rules as for /insider/cluster-buys. Omit for all roles.

exclude_uniform_pricequeryboolean (default false)

Optional. true sends no message for clusters with uniform_price, with the same rule as for /insider/cluster-buys.

Example request

curl
curl --no-buffer -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/cluster-buys/stream?ticker=AAPL"

Status codes

StatusMeaning
200

Continuous cluster-buy stream.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

503

A prerequisite of the endpoint is not ready: the ticker universe is still loading, the import status is still being aggregated, or the event stream is not running. Temporary – retrying later is worthwhile.

GET/v1/insider/confidence#

Officer buy/sell ratio

Computes the buy/sell ratio of the reporting officers over a time window and returns a ratio score from -1 to +1 as well as the absolute capital invested.

All §16 officers are taken into account, not just CEO and CFO. The reporter's job title is in role_detail of the individual transactions; to filter more narrowly, evaluate it via /insider/transactions.

Form 4 and Form 5 count; their amendments (4/A, 5/A) do not, because an amendment usually repeats the original filing.

Parameters

ParameterInTypeDescription
tickerrequiredquerystring

Stock ticker, e.g. AAPL.

windowquerystring (default 90d)

Observation period.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/insider/confidence?ticker=AAPL"

Example response — Officer buy/sell ratio over 90 days

200 OK
{
  "meta": {
    "request_id": "req_01K4W82F6R1M",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": {
    "ticker": "AAPL",
    "window": "90d",
    "score": 0.42,
    "buys": 17,
    "sells": 7,
    "net_invested": {
      "amount": 4820000,
      "currency": "USD"
    }
  }
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
windowalwaysstring
scorealwaysnumber (-1-1)

-1 (heavy selling) to +1 (heavy buying).

buysinteger
sellsinteger
net_investedMoney

Monetary amount with currency.

Status codes

StatusMeaning
200

Confidence metric for one instrument.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

Material events (Form 8-K)

Material events a company has to disclose – leadership changes, mergers, bankruptcies, cyber incidents and more. Available as searchable history, as a cross-market feed and as a push stream.

GET/v1/events#

Search material events

Searches the REST history of material events. Fixed sort order: filed_at descending, then id descending.

Either ticker or cik is required; a request without both is answered with 400. An unrestricted query would have to scan the whole history.

ticker matches the symbol at the time of the filing (see Event). For the full history of a company that changed its ticker, filter by cik instead.

Parameters

ParameterInTypeDescription
tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

cikquerystring

Central Index Key (alternative to the ticker). Leading zeros are optional: 0000320193 and 320193 return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.

event_typequeryEventType

Filter on a taxonomy type.

fromquerystring (date)

First day of the window (YYYY-MM-DD), inclusive. Filtering happens on a pure date field; of an RFC 3339 value only the calendar day counts.

toquerystring (date)

Last day of the window (YYYY-MM-DD), inclusive. Filtering happens on a pure date field; of an RFC 3339 value only the calendar day counts.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/events?ticker=AAPL"

Example response — Two material events

200 OK
{
  "meta": {
    "request_id": "req_01K4W83T2K5B",
    "source": "sec_edgar",
    "data_freshness": "2026-07-15T13:42:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "ticker": "XYZ",
      "cik": "0001234567",
      "event_type": "bankruptcy",
      "item_code": "1.03",
      "title": "Chapter 11 Bankruptcy Filing",
      "event_date": "2026-07-15",
      "filed_at": "2026-07-15T13:42:00-04:00",
      "filing_id": "0001234567-26-000045",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000045/form8k.htm"
    },
    {
      "ticker": "XYZ",
      "cik": "0001234567",
      "event_type": "leadership_change",
      "item_code": "5.02",
      "title": "Departure of Chief Financial Officer",
      "event_date": "2026-07-02",
      "filed_at": "2026-07-02T16:11:00-04:00",
      "filing_id": "0001234567-26-000039",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000039/form8k.htm"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring

Trading symbol of the common stock at the time of the filing, taken from the cover page of the 8-K. If the cover page does not tag one, the current symbol of the company is used. Empty if neither is known, e.g. for companies without listed stock or delisted since.

cikalwaysstring
event_typealwaysEventType

Normalised event type. Every value is derived from a SEC item code and does actually occur in the data.

item_codealwaysstring
titlealwaysstring
event_datealwaysstring (date)
filed_atalwaysstring (date-time)
filing_idalwaysstring
source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

List of material events.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/events/recent#

Most recently filed events (minute window)

Returns the material events filed in the last minutes minutes across all companies – no ticker/CIK required. Filters on the filing time (filed_at). Fixed sort order: filed_at descending, then id descending.

Parameters

ParameterInTypeDescription
minutesqueryinteger (1-10080, default 15)

Look-back window in minutes (capped at 10080 = 7 days).

tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

cikquerystring

Central Index Key (alternative to the ticker). Leading zeros are optional: 0000320193 and 320193 return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.

event_typequeryEventType

Filter on a taxonomy type.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/events/recent?ticker=AAPL"

Example response — Two material events

200 OK
{
  "meta": {
    "request_id": "req_01K4W83T2K5B",
    "source": "sec_edgar",
    "data_freshness": "2026-07-15T13:42:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "ticker": "XYZ",
      "cik": "0001234567",
      "event_type": "bankruptcy",
      "item_code": "1.03",
      "title": "Chapter 11 Bankruptcy Filing",
      "event_date": "2026-07-15",
      "filed_at": "2026-07-15T13:42:00-04:00",
      "filing_id": "0001234567-26-000045",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000045/form8k.htm"
    },
    {
      "ticker": "XYZ",
      "cik": "0001234567",
      "event_type": "leadership_change",
      "item_code": "5.02",
      "title": "Departure of Chief Financial Officer",
      "event_date": "2026-07-02",
      "filed_at": "2026-07-02T16:11:00-04:00",
      "filing_id": "0001234567-26-000039",
      "source_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000039/form8k.htm"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring

Trading symbol of the common stock at the time of the filing, taken from the cover page of the 8-K. If the cover page does not tag one, the current symbol of the company is used. Empty if neither is known, e.g. for companies without listed stock or delisted since.

cikalwaysstring
event_typealwaysEventType

Normalised event type. Every value is derived from a SEC item code and does actually occur in the data.

item_codealwaysstring
titlealwaysstring
event_datealwaysstring (date)
filed_atalwaysstring (date-time)
filing_idalwaysstring
source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

Most recently filed material events.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/events/{id}#

Get a single event

Returns a single event including item code and source document.

Parameters

ParameterInTypeDescription
idrequiredpathstring

Resource ID.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/events/<id>"

Example response — A single material event

200 OK
{
  "meta": {
    "request_id": "req_01K4W84B8V3Q",
    "source": "sec_edgar",
    "data_freshness": "2026-07-15T13:42:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": {
    "ticker": "XYZ",
    "cik": "0001234567",
    "event_type": "bankruptcy",
    "item_code": "1.03",
    "title": "Chapter 11 Bankruptcy Filing",
    "event_date": "2026-07-15",
    "filed_at": "2026-07-15T13:42:00-04:00",
    "filing_id": "0001234567-26-000045",
    "source_url": "https://www.sec.gov/Archives/edgar/data/1234567/000123456726000045/form8k.htm"
  }
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring

Trading symbol of the common stock at the time of the filing, taken from the cover page of the 8-K. If the cover page does not tag one, the current symbol of the company is used. Empty if neither is known, e.g. for companies without listed stock or delisted since.

cikalwaysstring
event_typealwaysEventType

Normalised event type. Every value is derived from a SEC item code and does actually occur in the data.

item_codealwaysstring
titlealwaysstring
event_datealwaysstring (date)
filed_atalwaysstring (date-time)
filing_idalwaysstring
source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

A single material event.

401

Missing or invalid API key.

404

Resource not found.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/events/stream#

SSE stream of new events

Server-Sent-Events stream. The client connects once and has new events pushed to it as soon as they are processed. Every message uses the event name event and carries one serialised event object as JSON in its data field. Every 30 seconds without traffic the server sends the SSE comment : keepalive, so a dead connection is noticed.

Observed latency from filing at the SEC to delivery: median 39.8 seconds over 14 days of live operation, about 18 seconds of which pass at the SEC itself (from acceptance to visibility in its feed). This is a push within seconds, not within milliseconds, and it is an observation rather than a guaranteed figure.

Messages carry no ID, so a reconnect does not replay what was missed. After a connection drop, catch up through /events/recent and then keep listening. The stream guide walks through a complete client.

A continuous Server-Sent Events stream rather than a single response — the event stream guide walks through a complete client.

Parameters

ParameterInTypeDescription
tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

event_typequeryEventType

Stream only events of this type.

Example request

curl
curl --no-buffer -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/events/stream?ticker=AAPL"

Status codes

StatusMeaning
200

Continuous event stream.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

503

A prerequisite of the endpoint is not ready: the ticker universe is still loading, the import status is still being aggregated, or the event stream is not running. Temporary – retrying later is worthwhile.

Institutional holdings (Form 13F)

Quarterly portfolios of institutional investors and the aggregated picture per stock. 13F filings are due 45 days after quarter end, so the most recent quarter fills up over several weeks.

A quarter shows the portfolio as corrected so far: a 13F-HR/A restatement replaces the fund's portfolio for that quarter, an amendment reporting new holdings is added to it, and an original filed before its restatement does not overwrite it. Earlier versions of a quarter are not available. A backtest on past quarters therefore sees corrections that may have been filed later; filed_at and filing_id of each holding name the filing it comes from.

GET/v1/institutional/funds#

Search funds/managers

Searches funds/managers by free text or CIK. Fixed sort order: fund name ascending.

Parameters

ParameterInTypeDescription
queryquerystring

Free text, e.g. “Bridgewater”.

cikquerystring

Central Index Key (alternative to the ticker). Leading zeros are optional: 0000320193 and 320193 return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/institutional/funds"

Example response — Funds matching a free-text search

200 OK
{
  "meta": {
    "request_id": "req_01K4W85D1F8T",
    "source": "sec_edgar",
    "data_freshness": "2026-05-15T20:10:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": [
    {
      "cik": "0001067983",
      "name": "Berkshire Hathaway Inc",
      "latest_quarter": "2026-Q1"
    },
    {
      "cik": "0001350694",
      "name": "Bridgewater Associates LP",
      "latest_quarter": "2026-Q1"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
cikalwaysstring

Central Index Key of the fund, always ten digits.

namealwaysstring
latest_quarterstring

Most recent reporting quarter of the fund.

Status codes

StatusMeaning
200

List of funds/managers.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/institutional/funds/{id}/holdings#

Get a fund's portfolio

Returns the complete portfolio of a fund for one quarter. Without quarter, the latest quarter of that fund is used. 13F has a 45-day filing deadline, so a fund is regularly missing from the most recent quarter; the globally latest quarter would yield an empty list for it.

A fund we hold no 13F filing for at all answers 404. A fund that does exist but reported nothing for the requested quarter answers 200 with an empty list plus a note in meta.warnings naming its most recent reported quarter. Because of the filing deadline that second case is routine rather than an error, and the two are worth telling apart. Fixed sort order: position value descending, then id.

The path segment is the fund's CIK. Leading zeros are optional: 0001067983 and 1067983 address the same fund.

Parameters

ParameterInTypeDescription
idrequiredpathstring

Resource ID.

quarterquerystring (pattern ^\d{4}-Q[1-4]$)

Reporting quarter, e.g. 2026-Q1.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/institutional/funds/<id>/holdings"

Example response — Positions of one quarter

200 OK
{
  "meta": {
    "request_id": "req_01K4W86H5G2W",
    "source": "sec_edgar",
    "data_freshness": "2026-05-15T20:10:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "fund_name": "Berkshire Hathaway Inc",
      "fund_cik": "0001067983",
      "ticker": "AAPL",
      "cusip": "037833100",
      "issuer_name": "APPLE INC",
      "shares": 300000000,
      "value": {
        "amount": 57036000000,
        "currency": "USD"
      },
      "put_call": null,
      "quarter": "2026-Q1",
      "filed_at": "2026-05-15T20:10:00-04:00",
      "filing_id": "0001067983-26-000012"
    },
    {
      "fund_name": "Berkshire Hathaway Inc",
      "fund_cik": "0001067983",
      "ticker": "KO",
      "cusip": "191216100",
      "issuer_name": "COCA COLA CO",
      "shares": 400000000,
      "value": {
        "amount": 27600000000,
        "currency": "USD"
      },
      "put_call": null,
      "quarter": "2026-Q1",
      "filed_at": "2026-05-15T20:10:00-04:00",
      "filing_id": "0001067983-26-000012"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
fund_namealwaysstring
fund_cikalwaysstring

Central Index Key of the reporting fund, always ten digits.

tickeralwaysstring
cusipalwaysstring
issuer_namestring

Issuer name from the filing (nameOfIssuer).

sharesalwaysnumber
valuealwaysMoney

Monetary amount with currency.

put_callstring: put | call | or null

Option type; null for a stock position.

quarteralwaysstring
filed_atalwaysstring (date-time)
filing_idalwaysstring

Status codes

StatusMeaning
200

Holdings of the fund in that quarter.

400

Invalid request parameters.

401

Missing or invalid API key.

404

Resource not found.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/institutional/holdings#

Who holds a stock?

Returns all funds holding a position in the requested instrument. Fixed sort order: position value descending, then id.

Parameters

ParameterInTypeDescription
tickerrequiredquerystring

Stock ticker, e.g. AAPL.

quarterquerystring (pattern ^\d{4}-Q[1-4]$)

Reporting quarter, e.g. 2026-Q1.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/institutional/holdings?ticker=AAPL"

Example response — Positions of one quarter

200 OK
{
  "meta": {
    "request_id": "req_01K4W86H5G2W",
    "source": "sec_edgar",
    "data_freshness": "2026-05-15T20:10:00-04:00",
    "next_cursor": "eyJvIjo1MH0",
    "warnings": []
  },
  "data": [
    {
      "fund_name": "Berkshire Hathaway Inc",
      "fund_cik": "0001067983",
      "ticker": "AAPL",
      "cusip": "037833100",
      "issuer_name": "APPLE INC",
      "shares": 300000000,
      "value": {
        "amount": 57036000000,
        "currency": "USD"
      },
      "put_call": null,
      "quarter": "2026-Q1",
      "filed_at": "2026-05-15T20:10:00-04:00",
      "filing_id": "0001067983-26-000012"
    },
    {
      "fund_name": "Berkshire Hathaway Inc",
      "fund_cik": "0001067983",
      "ticker": "KO",
      "cusip": "191216100",
      "issuer_name": "COCA COLA CO",
      "shares": 400000000,
      "value": {
        "amount": 27600000000,
        "currency": "USD"
      },
      "put_call": null,
      "quarter": "2026-Q1",
      "filed_at": "2026-05-15T20:10:00-04:00",
      "filing_id": "0001067983-26-000012"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
fund_namealwaysstring
fund_cikalwaysstring

Central Index Key of the reporting fund, always ten digits.

tickeralwaysstring
cusipalwaysstring
issuer_namestring

Issuer name from the filing (nameOfIssuer).

sharesalwaysnumber
valuealwaysMoney

Monetary amount with currency.

put_callstring: put | call | or null

Option type; null for a stock position.

quarteralwaysstring
filed_atalwaysstring (date-time)
filing_idalwaysstring

Status codes

StatusMeaning
200

Funds with a position in the instrument.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/institutional/sentiment#

Aggregated buy/sell picture per stock

Aggregates the buy/sell picture of a stock across all funds for one quarter. Note: 13F values are reported holdings, not actual cash flow.

Parameters

ParameterInTypeDescription
tickerrequiredquerystring

Stock ticker, e.g. AAPL.

quarterquerystring (pattern ^\d{4}-Q[1-4]$)

Reporting quarter, e.g. 2026-Q1.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/institutional/sentiment?ticker=AAPL"

Example response — Aggregated institutional picture of one stock

200 OK
{
  "meta": {
    "request_id": "req_01K4W87M9J4Y",
    "source": "sec_edgar",
    "data_freshness": "2026-05-15T20:10:00-04:00",
    "next_cursor": null,
    "warnings": [
      "The filing deadline of quarter 2026-Q1 has not passed yet; the picture is incomplete."
    ]
  },
  "data": {
    "ticker": "NVDA",
    "quarter": "2026-Q1",
    "funds_holding": 570,
    "funds_increased": 450,
    "funds_decreased": 120,
    "funds_new": 65,
    "funds_exited": 38,
    "total_shares": 1820000000,
    "total_value": {
      "amount": 214000000000,
      "currency": "USD"
    },
    "quarter_complete": false,
    "filing_deadline": "2026-08-14"
  }
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
quarteralwaysstring
funds_holdingalwaysinteger

Number of funds with a position in the reporting quarter.

funds_increasedalwaysinteger

Funds that increased the position versus the previous quarter.

funds_decreasedalwaysinteger

Funds that reduced the position versus the previous quarter.

funds_newinteger

Funds that newly opened the position.

funds_exitedinteger

Funds that closed the position. As long as quarter_complete is false, the value also contains funds that have simply not reported yet, and is inflated as a result.

total_sharesnumber

Sum of the reported share holdings (not a cash flow).

total_valueMoney

Monetary amount with currency.

quarter_completeboolean

Whether the 13F filing deadline of the quarter has passed (quarter end plus 45 days). If false, the quarter is still incomplete; meta.warnings then contains a note.

filing_deadlinestring (date)

Last filing day for this quarter.

Status codes

StatusMeaning
200

Aggregated institutional sentiment.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/institutional/disclosures#

Most recently filed 13F disclosures

13F filings most recently submitted to the SEC, in chronological order by filing time (filed_at) and aggregated at fund level (not as a single-position feed). Unlike insider/recent this is not a feed of individual transactions: 13F holdings are quarterly snapshots; the “freshness” dimension is the filing time of the disclosure. Fixed sort order: filed_at descending, then filing_id.

Parameters

ParameterInTypeDescription
daysqueryinteger (1-90, default 7)

Window over the filing time in days, capped at 90.

quarterquerystring (pattern ^\d{4}-Q[1-4]$)

Reporting quarter, e.g. 2026-Q1.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/institutional/disclosures"

Example response — Most recently filed 13F disclosures

200 OK
{
  "meta": {
    "request_id": "req_01K4W88P3L6Z",
    "source": "sec_edgar",
    "data_freshness": "2026-05-15T20:10:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": [
    {
      "fund_name": "Berkshire Hathaway Inc",
      "fund_cik": "0001067983",
      "quarter": "2026-Q1",
      "filed_at": "2026-05-15T20:10:00-04:00",
      "holdings_count": 42,
      "total_value": {
        "amount": 302000000000,
        "currency": "USD"
      },
      "filing_id": "0001067983-26-000012"
    },
    {
      "fund_name": "Bridgewater Associates LP",
      "fund_cik": "0001350694",
      "quarter": "2026-Q1",
      "filed_at": "2026-05-14T18:45:00-04:00",
      "holdings_count": 812,
      "total_value": {
        "amount": 21400000000,
        "currency": "USD"
      },
      "filing_id": "0001350694-26-000008"
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
fund_namealwaysstring
fund_cikalwaysstring

Central Index Key of the reporting fund, always ten digits.

quarteralwaysstring
filed_atalwaysstring (date-time)
holdings_countalwaysinteger

Number of positions in the disclosure.

total_valuealwaysMoney

Monetary amount with currency.

filing_idalwaysstring

Status codes

StatusMeaning
200

Most recently filed disclosures (fund level).

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

Shared helper endpoints

Ticker/CIK resolution and company search, the raw SEC filing behind every record, and the freshness of each data source.

GET/v1/tickers#

Ticker⇄CIK resolution / company search

Resolves a ticker or a CIK, or searches companies by free text. Fixed sort order for the free-text search: best name match first.

Either query, ticker or cik is required; a request without any of them is answered with 400.

Parameters

ParameterInTypeDescription
queryquerystring

Free-text company search.

tickerquerystring

Stock ticker (preferred instrument filter), e.g. AAPL.

cikquerystring

Central Index Key (alternative to the ticker). Leading zeros are optional: 0000320193 and 320193 return the same rows. In responses the key is always ten digits, so it is safe to use as a join key.

limitqueryinteger (1-500, default 50)

Maximum number of results.

cursorquerystring

Opaque cursor for the next page.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/tickers?ticker=AAPL"

Example response — Resolution of one ticker

200 OK
{
  "meta": {
    "request_id": "req_01K4W89S7N8A",
    "source": "sec_edgar",
    "next_cursor": null,
    "warnings": []
  },
  "data": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "name": "Apple Inc."
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
namealwaysstring

Status codes

StatusMeaning
200

Matching tickers/companies.

400

Invalid request parameters.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

503

A prerequisite of the endpoint is not ready: the ticker universe is still loading, the import status is still being aggregated, or the event stream is not running. Temporary – retrying later is worthwhile.

GET/v1/filings/{id}#

Get a raw SEC filing

Metadata and source URL of the originating filing behind all modules.

Parameters

ParameterInTypeDescription
idrequiredpathstring

Resource ID.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/filings/<id>"

Example response — The raw filing behind a record

200 OK
{
  "meta": {
    "request_id": "req_01K4W8AV2Q1B",
    "source": "sec_edgar",
    "data_freshness": "2026-07-13T21:05:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": {
    "filing_id": "0000320193-26-000073",
    "accession_number": "0000320193-26-000073",
    "form_type": "4",
    "cik": "0000320193",
    "filed_at": "2026-07-11T21:03:00-04:00",
    "source_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000073/0000320193-26-000073-index.htm"
  }
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

accession_numberstring
form_typealwaysstring
cikalwaysstring
filed_atalwaysstring (date-time)
source_urlalwaysstring (uri)

Status codes

StatusMeaning
200

Filing metadata.

400

Invalid request parameters.

401

Missing or invalid API key.

404

Resource not found.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

500

Unexpected server-side error, error code internal_error. The message is always the same; the cause stays in the server log, keyed by the request_id that the response repeats. Quote it in a support request.

GET/v1/status#

Data freshness per source

Data freshness and last successful import per source. Fixed sort order: form type ascending.

The figures are aggregated in the background every minute, so last_import_at and filings can lag behind the newest data by about that much; healthy is evaluated at request time. Right after a restart the endpoint answers 503 until the first aggregation is done.

Parameters

No parameters.

Example request

curl
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
  "https://api.algoum.de/v1/status"

Example response — Freshness per source

200 OK
{
  "meta": {
    "request_id": "req_01K4W8B27S3C",
    "source": "sec_edgar",
    "data_freshness": "2026-07-15T13:42:00-04:00",
    "next_cursor": null,
    "warnings": []
  },
  "data": [
    {
      "source": "sec_edgar",
      "form_type": "4",
      "last_import_at": "2026-07-15T13:58:00-04:00",
      "filings": 412873,
      "healthy": true
    },
    {
      "source": "sec_edgar",
      "form_type": "8-K",
      "last_import_at": "2026-07-15T13:59:00-04:00",
      "filings": 98211,
      "healthy": true
    },
    {
      "source": "sec_edgar",
      "form_type": "13F-HR",
      "last_import_at": "2026-05-16T02:10:00-04:00",
      "filings": 7421,
      "healthy": true
    }
  ]
}

Response fields

Below data; meta is the same for every endpoint (see conventions).

FieldTypeDescription
sourcealwaysstring
form_typestring
last_import_atalwaysstring (date-time)
filingsinteger

Number of stored filings of this form type.

healthyboolean

Freshness measured against the filing rhythm of the form type: Form 4 and 8-K appear every business day (threshold 7 days); 13F, NT 10-K, NT 10-Q and Form 5 follow quarterly or fiscal-year deadlines (threshold 120 days); Form 5/A is rare (threshold 400 days).

Status codes

StatusMeaning
200

Current import status.

401

Missing or invalid API key.

429

Rate limit exceeded. The rejection is issued at the edge, in front of the API, so it does not necessarily carry the JSON error envelope and has no request_id. Slow down and retry.

503

A prerequisite of the endpoint is not ready: the ticker universe is still loading, the import status is still being aggregated, or the event stream is not running. Temporary – retrying later is worthwhile.

Data types

The objects the endpoints above return, in one place. A field that names one of these types links here instead of repeating it on every endpoint.

Money#

Monetary amount with currency.

FieldTypeDescription
amountalwaysnumber
currencyalwaysstring

ISO 4217 code, except GBX for prices in British pence.

Meta#

Uniform metadata present in every response.

FieldTypeDescription
request_idalwaysstring
sourcealwaysstring
data_freshnessstring (date-time)

Filing time of the most recently processed filing. Absent as long as no data has been imported – no freshness is claimed in that case.

next_cursorstring or null

Cursor for the next page; null at the end.

warningsarray of string

Envelope#

Uniform response envelope. data is specialised per endpoint.

FieldTypeDescription
metaalwaysMeta

Uniform metadata present in every response.

ErrorResponse#

FieldTypeDescription
erroralwaysobject

InsiderRole#

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

string: officer | director | 10%-owner | other

ReportingOwner#

A reporting person or entity of a §16 filing.

FieldTypeDescription
namealwaysstring
cikalwaysstring
rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Free text from the filing about the role: for officer the job title, for other the kind of relationship.

InsiderTransaction#

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_namealwaysstring
rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Free text from the filing about the role: for officer the job title, for other the kind of relationship. Not set for director and 10%-owner, and otherwise only when the filing states it.

reporting_ownersalwaysarray of ReportingOwner

All reporters of the filing. A joint filing (a fund, its general partner and the acting person, for instance) lists several; the transaction itself is still reported only once and appears here once. insider_name, role and role_detail describe the first entry of this list.

sidealwaysstring: buy | sell |

Trade direction; empty for Form 5 codes without buy/sell.

codestring

Raw SEC transaction code (P, S, G, A, …).

form_typestring: 4 | 5 | 4/A | 5/A

Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either (4/A, 5/A). An amendment is a correction the insider files later, sometimes months later. It is returned as rows of its own next to the original, which stays unchanged; it usually repeats the whole filing, so do not add the rows of an original and its amendment together.

original_filed_onstring (date) or null

For an amendment (4/A, 5/A), the filing date of the original filing it corrects, as stated in the amendment; null for Form 4 and Form 5. The amendment names only this date, not the original's accession number, so match the original by issuer, insider and this date.

sharesalwaysnumber
pricealwaysstring

Price per share. null when the filing states none – that happens when a trade consisted of several partial executions at different prices and the reporter gives the price in a footnote instead. A reported price of 0 is a real statement, by contrast. Form 4 has no currency field. currency is USD unless the filing itself says otherwise: a footnote on the price naming another currency (for example CAD), or a security title that names a listing outside the US (for example BRL for "Preference shares - BBDC4" on B3). A footnote stating that the price was converted into US dollars keeps USD. Prices in pence are reported as GBX.

transaction_datealwaysstring (date)
filed_atalwaysstring (date-time)
is_10b5_1boolean or null

Planned 10b5-1 sale where detectable; otherwise null.

ownershipstring: direct | indirect |

Whether the insider holds the shares directly (direct) or through a vehicle (indirect). Empty when the filing states nothing.

ownership_detailstring

The holding vehicle in case of indirect ownership. An insider reports the same trade separately per vehicle; without this field such rows are identical in date, share count and price and look like duplicates.

shares_owned_afternumber or null

Reported holding after the transaction, relative to the holding vehicle of this row. null when the filing does not state it – a holding of 0 after a full sale, by contrast, is a real statement.

filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

source_urlalwaysstring (uri)

ClusterBuy#

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
insider_countalwaysinteger

Number of independent insiders with a buy in the window.

total_sharesnumber
total_valueMoney

Monetary amount with currency.

windowalwaysstring
as_ofalwaysstring (date) or null

Requested point in time; null when the window ends today. The stream always sends null.

rolesalwaysarray of InsiderRole

Effective role filter in alphabetical order; empty means all roles.

first_buy_datestring (date)
last_buy_datestring (date)
min_insidersalwaysinteger (min 1)

Requested minimum number of distinct insider names.

uniform_pricealwaysboolean

All counted buyers with a price above zero bought at the same price (at least three, highest at most 0.1 % above lowest) - usually a joint purchase such as a private placement or a reinvestment plan rather than independent decisions. See exclude_uniform_price.

rule_versionalwaysstring: cluster-buys-v1

Version of the name-based, transaction-date aggregation rule.

sec_known_atalwaysstring (date-time) or null

Earliest stored filing time at which the requested number of distinct buyers was known for the current window's transactions. Null if any contributing filing lacks a usable time. Historical archive times may have only date-level precision. Not a historical API publication time or a reconstructed rolling-window alert.

evidencealwaysarray of ClusterBuyEvidence

Contributing filing/buyer pairs without duplicate transaction lines, sorted by filed_at, filing_id and insider_name; missing times last.

ClusterBuyEvidence#

FieldTypeDescription
filing_idalwaysstring

Accession number of a contributing filing.

insider_namealwaysstring

First reporting owner's name used by the existing buyer count.

rolealwaysInsiderRole

Relationship of the reporter to the issuer, taken from the four check boxes of the Form 4 section “Relationship of Reporting Person(s) to Issuer”. other stands for the Other box; the label entered there (e.g. “Trustee”) is in role_detail.

role_detailstring

Reported job title or relationship of the counted first owner, when available.

reporting_ownersalwaysarray of ReportingOwner

Stored reporting owners, including their available CIKs and roles. Additional owners do not increase the buyer count or qualify an excluded first owner. Empty if no owners were stored; no IDs are inferred.

filed_atalwaysstring (date-time) or null

Stored SEC filing time in Eastern Time; null if unavailable, possibly date-level for archives.

source_urlalwaysstring (uri)

Link to the source SEC filing.

Confidence#

FieldTypeDescription
tickeralwaysstring
windowalwaysstring
scorealwaysnumber (-1-1)

-1 (heavy selling) to +1 (heavy buying).

buysinteger
sellsinteger
net_investedMoney

Monetary amount with currency.

EventType#

Normalised event type. Every value is derived from a SEC item code and does actually occur in the data.

string: bankruptcy | cyber_incident | leadership_change | delisting | earnings_release | merger_acquisition | capital_action | accounting_issue | auditor_change | late_filing | other_material_event

Event#

FieldTypeDescription
tickeralwaysstring

Trading symbol of the common stock at the time of the filing, taken from the cover page of the 8-K. If the cover page does not tag one, the current symbol of the company is used. Empty if neither is known, e.g. for companies without listed stock or delisted since.

cikalwaysstring
event_typealwaysEventType

Normalised event type. Every value is derived from a SEC item code and does actually occur in the data.

item_codealwaysstring
titlealwaysstring
event_datealwaysstring (date)
filed_atalwaysstring (date-time)
filing_idalwaysstring
source_urlalwaysstring (uri)

Fund#

FieldTypeDescription
cikalwaysstring

Central Index Key of the fund, always ten digits.

namealwaysstring
latest_quarterstring

Most recent reporting quarter of the fund.

Holding#

FieldTypeDescription
fund_namealwaysstring
fund_cikalwaysstring

Central Index Key of the reporting fund, always ten digits.

tickeralwaysstring
cusipalwaysstring
issuer_namestring

Issuer name from the filing (nameOfIssuer).

sharesalwaysnumber
valuealwaysMoney

Monetary amount with currency.

put_callstring: put | call | or null

Option type; null for a stock position.

quarteralwaysstring
filed_atalwaysstring (date-time)
filing_idalwaysstring

InstitutionalSentiment#

FieldTypeDescription
tickeralwaysstring
quarteralwaysstring
funds_holdingalwaysinteger

Number of funds with a position in the reporting quarter.

funds_increasedalwaysinteger

Funds that increased the position versus the previous quarter.

funds_decreasedalwaysinteger

Funds that reduced the position versus the previous quarter.

funds_newinteger

Funds that newly opened the position.

funds_exitedinteger

Funds that closed the position. As long as quarter_complete is false, the value also contains funds that have simply not reported yet, and is inflated as a result.

total_sharesnumber

Sum of the reported share holdings (not a cash flow).

total_valueMoney

Monetary amount with currency.

quarter_completeboolean

Whether the 13F filing deadline of the quarter has passed (quarter end plus 45 days). If false, the quarter is still incomplete; meta.warnings then contains a note.

filing_deadlinestring (date)

Last filing day for this quarter.

Disclosure#

FieldTypeDescription
fund_namealwaysstring
fund_cikalwaysstring

Central Index Key of the reporting fund, always ten digits.

quarteralwaysstring
filed_atalwaysstring (date-time)
holdings_countalwaysinteger

Number of positions in the disclosure.

total_valuealwaysMoney

Monetary amount with currency.

filing_idalwaysstring

TickerEntry#

FieldTypeDescription
tickeralwaysstring
cikalwaysstring
namealwaysstring

Filing#

FieldTypeDescription
filing_idalwaysstring

Accession number of the filing. All modules return it without a prefix; /filings/{id} additionally accepts the spelling with fil_.

accession_numberstring
form_typealwaysstring
cikalwaysstring
filed_atalwaysstring (date-time)
source_urlalwaysstring (uri)

SourceStatus#

FieldTypeDescription
sourcealwaysstring
form_typestring
last_import_atalwaysstring (date-time)
filingsinteger

Number of stored filings of this form type.

healthyboolean

Freshness measured against the filing rhythm of the form type: Form 4 and 8-K appear every business day (threshold 7 days); 13F, NT 10-K, NT 10-Q and Form 5 follow quarterly or fiscal-year deadlines (threshold 120 days); Form 5/A is rare (threshold 400 days).