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)
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
| Parameter | In | Type | Description |
|---|---|---|---|
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
cik | query | string | Central Index Key (alternative to the ticker). Leading zeros are optional: |
side | query | string: buy | sell | Trade direction. |
role | query | InsiderRole | Insider role. |
form_type | query | string: 4 | 5 | 4/A | 5/A | Filter on the filing source: Form 4, Form 5 or one of their amendments ( |
from | query | string (date) | First day of the window ( |
to | query | string (date) | Last day of the window ( |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/insider/transactions?ticker=AAPL"Example response — Two insider trades of one company
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_namealways | string | |
rolealways | 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”. |
role_detail | string | Free text from the filing about the role: for |
reporting_ownersalways | array 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. |
sidealways | string: buy | sell | | Trade direction; empty for Form 5 codes without buy/sell. |
code | string | Raw SEC transaction code (P, S, G, A, …). |
form_type | string: 4 | 5 | 4/A | 5/A | Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either ( |
original_filed_on | string (date) or null | For an amendment ( |
sharesalways | number | |
pricealways | string | Price per share. |
transaction_datealways | string (date) | |
filed_atalways | string (date-time) | |
is_10b5_1 | boolean or null | Planned 10b5-1 sale where detectable; otherwise |
ownership | string: direct | indirect | | Whether the insider holds the shares directly ( |
ownership_detail | string | 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_after | number or null | Reported holding after the transaction, relative to the holding vehicle of this row. |
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
days | query | integer (1-30, default 1) | Look-back window in days, capped at 30. |
side | query | string: buy | sell | both (default both) | Trade direction; |
role | query | InsiderRole | Insider role. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/insider/recent"Example response — Two insider trades of one company
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_namealways | string | |
rolealways | 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”. |
role_detail | string | Free text from the filing about the role: for |
reporting_ownersalways | array 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. |
sidealways | string: buy | sell | | Trade direction; empty for Form 5 codes without buy/sell. |
code | string | Raw SEC transaction code (P, S, G, A, …). |
form_type | string: 4 | 5 | 4/A | 5/A | Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either ( |
original_filed_on | string (date) or null | For an amendment ( |
sharesalways | number | |
pricealways | string | Price per share. |
transaction_datealways | string (date) | |
filed_atalways | string (date-time) | |
is_10b5_1 | boolean or null | Planned 10b5-1 sale where detectable; otherwise |
ownership | string: direct | indirect | | Whether the insider holds the shares directly ( |
ownership_detail | string | 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_after | number or null | Reported holding after the transaction, relative to the holding vehicle of this row. |
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
GET/v1/insider/transactions/{id}#
Get a single transaction
Returns a single transaction including its filing reference.
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
idrequired | path | string | Resource ID. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/insider/transactions/<id>"Example response — A single insider trade
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_namealways | string | |
rolealways | 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”. |
role_detail | string | Free text from the filing about the role: for |
reporting_ownersalways | array 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. |
sidealways | string: buy | sell | | Trade direction; empty for Form 5 codes without buy/sell. |
code | string | Raw SEC transaction code (P, S, G, A, …). |
form_type | string: 4 | 5 | 4/A | 5/A | Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either ( |
original_filed_on | string (date) or null | For an amendment ( |
sharesalways | number | |
pricealways | string | Price per share. |
transaction_datealways | string (date) | |
filed_atalways | string (date-time) | |
is_10b5_1 | boolean or null | Planned 10b5-1 sale where detectable; otherwise |
ownership | string: direct | indirect | | Whether the insider holds the shares directly ( |
ownership_detail | string | 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_after | number or null | Reported holding after the transaction, relative to the holding vehicle of this row. |
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
window | query | string (default 7d) | Aggregation window, e.g. |
min_insiders | query | integer (min 1, default 3) | Minimum number of independent buyers. |
roles | query | array 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_of | query | string (date) | Optional point in time ( |
exclude_uniform_price | query | boolean (default false) | Optional. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/insider/cluster-buys"Example response — Companies with several buying insiders
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_countalways | integer | Number of independent insiders with a buy in the window. |
total_shares | number | |
total_value | Money | Monetary amount with currency. |
windowalways | string | |
as_ofalways | string (date) or null | Requested point in time; |
rolesalways | array of InsiderRole | Effective role filter in alphabetical order; empty means all roles. |
first_buy_date | string (date) | |
last_buy_date | string (date) | |
min_insidersalways | integer (min 1) | Requested minimum number of distinct insider names. |
uniform_pricealways | boolean | 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 |
rule_versionalways | string: cluster-buys-v1 | Version of the name-based, transaction-date aggregation rule. |
sec_known_atalways | string (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. |
evidencealways | array of ClusterBuyEvidence | Contributing filing/buyer pairs without duplicate transaction lines, sorted by filed_at, filing_id and insider_name; missing times last. |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
window | query | string (default 7d) | Aggregation window on the transaction date, e.g. |
min_insiders | query | integer (min 1, default 3) | Number of distinct buyers that triggers a message. |
roles | query | array of InsiderRole | Optional comma-separated roles of the first reporting owner, with the same rules as for |
exclude_uniform_price | query | boolean (default false) | Optional. |
Example request
curl --no-buffer -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/insider/cluster-buys/stream?ticker=AAPL"Status codes
| Status | Meaning |
|---|---|
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 |
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
| Parameter | In | Type | Description |
|---|---|---|---|
tickerrequired | query | string | Stock ticker, e.g. |
window | query | string (default 90d) | Observation period. |
Example request
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
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
windowalways | string | |
scorealways | number (-1-1) | -1 (heavy selling) to +1 (heavy buying). |
buys | integer | |
sells | integer | |
net_invested | Money | Monetary amount with currency. |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
cik | query | string | Central Index Key (alternative to the ticker). Leading zeros are optional: |
event_type | query | EventType | Filter on a taxonomy type. |
from | query | string (date) | First day of the window ( |
to | query | string (date) | Last day of the window ( |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/events?ticker=AAPL"Example response — Two material events
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | 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. |
cikalways | string | |
event_typealways | EventType | Normalised event type. Every value is derived from a SEC item code and does actually occur in the data. |
item_codealways | string | |
titlealways | string | |
event_datealways | string (date) | |
filed_atalways | string (date-time) | |
filing_idalways | string | |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
minutes | query | integer (1-10080, default 15) | Look-back window in minutes (capped at 10080 = 7 days). |
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
cik | query | string | Central Index Key (alternative to the ticker). Leading zeros are optional: |
event_type | query | EventType | Filter on a taxonomy type. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/events/recent?ticker=AAPL"Example response — Two material events
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | 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. |
cikalways | string | |
event_typealways | EventType | Normalised event type. Every value is derived from a SEC item code and does actually occur in the data. |
item_codealways | string | |
titlealways | string | |
event_datealways | string (date) | |
filed_atalways | string (date-time) | |
filing_idalways | string | |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
GET/v1/events/{id}#
Get a single event
Returns a single event including item code and source document.
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
idrequired | path | string | Resource ID. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/events/<id>"Example response — A single material event
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | 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. |
cikalways | string | |
event_typealways | EventType | Normalised event type. Every value is derived from a SEC item code and does actually occur in the data. |
item_codealways | string | |
titlealways | string | |
event_datealways | string (date) | |
filed_atalways | string (date-time) | |
filing_idalways | string | |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
event_type | query | EventType | Stream only events of this type. |
Example request
curl --no-buffer -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/events/stream?ticker=AAPL"Status codes
| Status | Meaning |
|---|---|
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 |
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
| Parameter | In | Type | Description |
|---|---|---|---|
query | query | string | Free text, e.g. “Bridgewater”. |
cik | query | string | Central Index Key (alternative to the ticker). Leading zeros are optional: |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/institutional/funds"Example response — Funds matching a free-text search
{
"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).
| Field | Type | Description |
|---|---|---|
cikalways | string | Central Index Key of the fund, always ten digits. |
namealways | string | |
latest_quarter | string | Most recent reporting quarter of the fund. |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
idrequired | path | string | Resource ID. |
quarter | query | string (pattern ^\d{4}-Q[1-4]$) | Reporting quarter, e.g. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/institutional/funds/<id>/holdings"Example response — Positions of one quarter
{
"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).
| Field | Type | Description |
|---|---|---|
fund_namealways | string | |
fund_cikalways | string | Central Index Key of the reporting fund, always ten digits. |
tickeralways | string | |
cusipalways | string | |
issuer_name | string | Issuer name from the filing (nameOfIssuer). |
sharesalways | number | |
valuealways | Money | Monetary amount with currency. |
put_call | string: put | call | or null | Option type; |
quarteralways | string | |
filed_atalways | string (date-time) | |
filing_idalways | string |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
tickerrequired | query | string | Stock ticker, e.g. |
quarter | query | string (pattern ^\d{4}-Q[1-4]$) | Reporting quarter, e.g. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/institutional/holdings?ticker=AAPL"Example response — Positions of one quarter
{
"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).
| Field | Type | Description |
|---|---|---|
fund_namealways | string | |
fund_cikalways | string | Central Index Key of the reporting fund, always ten digits. |
tickeralways | string | |
cusipalways | string | |
issuer_name | string | Issuer name from the filing (nameOfIssuer). |
sharesalways | number | |
valuealways | Money | Monetary amount with currency. |
put_call | string: put | call | or null | Option type; |
quarteralways | string | |
filed_atalways | string (date-time) | |
filing_idalways | string |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
tickerrequired | query | string | Stock ticker, e.g. |
quarter | query | string (pattern ^\d{4}-Q[1-4]$) | Reporting quarter, e.g. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/institutional/sentiment?ticker=AAPL"Example response — Aggregated institutional picture of one stock
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
quarteralways | string | |
funds_holdingalways | integer | Number of funds with a position in the reporting quarter. |
funds_increasedalways | integer | Funds that increased the position versus the previous quarter. |
funds_decreasedalways | integer | Funds that reduced the position versus the previous quarter. |
funds_new | integer | Funds that newly opened the position. |
funds_exited | integer | 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_shares | number | Sum of the reported share holdings (not a cash flow). |
total_value | Money | Monetary amount with currency. |
quarter_complete | boolean | 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_deadline | string (date) | Last filing day for this quarter. |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
days | query | integer (1-90, default 7) | Window over the filing time in days, capped at 90. |
quarter | query | string (pattern ^\d{4}-Q[1-4]$) | Reporting quarter, e.g. |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/institutional/disclosures"Example response — Most recently filed 13F disclosures
{
"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).
| Field | Type | Description |
|---|---|---|
fund_namealways | string | |
fund_cikalways | string | Central Index Key of the reporting fund, always ten digits. |
quarteralways | string | |
filed_atalways | string (date-time) | |
holdings_countalways | integer | Number of positions in the disclosure. |
total_valuealways | Money | Monetary amount with currency. |
filing_idalways | string |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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
| Parameter | In | Type | Description |
|---|---|---|---|
query | query | string | Free-text company search. |
ticker | query | string | Stock ticker (preferred instrument filter), e.g. |
cik | query | string | Central Index Key (alternative to the ticker). Leading zeros are optional: |
limit | query | integer (1-500, default 50) | Maximum number of results. |
cursor | query | string | Opaque cursor for the next page. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/tickers?ticker=AAPL"Example response — Resolution of one ticker
{
"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).
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
namealways | string |
Status codes
| Status | Meaning |
|---|---|
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 |
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
| Parameter | In | Type | Description |
|---|---|---|---|
idrequired | path | string | Resource ID. |
Example request
curl -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/filings/<id>"Example response — The raw filing behind a record
{
"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).
| Field | Type | Description |
|---|---|---|
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
accession_number | string | |
form_typealways | string | |
cikalways | string | |
filed_atalways | string (date-time) | |
source_urlalways | string (uri) |
Status codes
| Status | Meaning |
|---|---|
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 |
500 | Unexpected server-side error, error code |
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 -H "Authorization: Bearer $ALGOUM_API_KEY" \
"https://api.algoum.de/v1/status"Example response — Freshness per source
{
"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).
| Field | Type | Description |
|---|---|---|
sourcealways | string | |
form_type | string | |
last_import_atalways | string (date-time) | |
filings | integer | Number of stored filings of this form type. |
healthy | boolean | 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
| Status | Meaning |
|---|---|
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 |
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.
| Field | Type | Description |
|---|---|---|
amountalways | number | |
currencyalways | string | ISO 4217 code, except |
Meta#
Uniform metadata present in every response.
| Field | Type | Description |
|---|---|---|
request_idalways | string | |
sourcealways | string | |
data_freshness | string (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_cursor | string or null | Cursor for the next page; |
warnings | array of string |
Envelope#
Uniform response envelope. data is specialised per endpoint.
| Field | Type | Description |
|---|---|---|
metaalways | Meta | Uniform metadata present in every response. |
ErrorResponse#
| Field | Type | Description |
|---|---|---|
erroralways | object |
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.
| Field | Type | Description |
|---|---|---|
namealways | string | |
cikalways | string | |
rolealways | 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”. |
role_detail | string | Free text from the filing about the role: for |
InsiderTransaction#
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_namealways | string | |
rolealways | 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”. |
role_detail | string | Free text from the filing about the role: for |
reporting_ownersalways | array 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. |
sidealways | string: buy | sell | | Trade direction; empty for Form 5 codes without buy/sell. |
code | string | Raw SEC transaction code (P, S, G, A, …). |
form_type | string: 4 | 5 | 4/A | 5/A | Source of the transaction – Form 4 (ongoing), Form 5 (annual report) or an amendment of either ( |
original_filed_on | string (date) or null | For an amendment ( |
sharesalways | number | |
pricealways | string | Price per share. |
transaction_datealways | string (date) | |
filed_atalways | string (date-time) | |
is_10b5_1 | boolean or null | Planned 10b5-1 sale where detectable; otherwise |
ownership | string: direct | indirect | | Whether the insider holds the shares directly ( |
ownership_detail | string | 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_after | number or null | Reported holding after the transaction, relative to the holding vehicle of this row. |
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
source_urlalways | string (uri) |
ClusterBuy#
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
insider_countalways | integer | Number of independent insiders with a buy in the window. |
total_shares | number | |
total_value | Money | Monetary amount with currency. |
windowalways | string | |
as_ofalways | string (date) or null | Requested point in time; |
rolesalways | array of InsiderRole | Effective role filter in alphabetical order; empty means all roles. |
first_buy_date | string (date) | |
last_buy_date | string (date) | |
min_insidersalways | integer (min 1) | Requested minimum number of distinct insider names. |
uniform_pricealways | boolean | 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 |
rule_versionalways | string: cluster-buys-v1 | Version of the name-based, transaction-date aggregation rule. |
sec_known_atalways | string (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. |
evidencealways | array of ClusterBuyEvidence | Contributing filing/buyer pairs without duplicate transaction lines, sorted by filed_at, filing_id and insider_name; missing times last. |
ClusterBuyEvidence#
| Field | Type | Description |
|---|---|---|
filing_idalways | string | Accession number of a contributing filing. |
insider_namealways | string | First reporting owner's name used by the existing buyer count. |
rolealways | 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”. |
role_detail | string | Reported job title or relationship of the counted first owner, when available. |
reporting_ownersalways | array 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_atalways | string (date-time) or null | Stored SEC filing time in Eastern Time; null if unavailable, possibly date-level for archives. |
source_urlalways | string (uri) | Link to the source SEC filing. |
Confidence#
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
windowalways | string | |
scorealways | number (-1-1) | -1 (heavy selling) to +1 (heavy buying). |
buys | integer | |
sells | integer | |
net_invested | Money | 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#
| Field | Type | Description |
|---|---|---|
tickeralways | string | 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. |
cikalways | string | |
event_typealways | EventType | Normalised event type. Every value is derived from a SEC item code and does actually occur in the data. |
item_codealways | string | |
titlealways | string | |
event_datealways | string (date) | |
filed_atalways | string (date-time) | |
filing_idalways | string | |
source_urlalways | string (uri) |
Fund#
| Field | Type | Description |
|---|---|---|
cikalways | string | Central Index Key of the fund, always ten digits. |
namealways | string | |
latest_quarter | string | Most recent reporting quarter of the fund. |
Holding#
| Field | Type | Description |
|---|---|---|
fund_namealways | string | |
fund_cikalways | string | Central Index Key of the reporting fund, always ten digits. |
tickeralways | string | |
cusipalways | string | |
issuer_name | string | Issuer name from the filing (nameOfIssuer). |
sharesalways | number | |
valuealways | Money | Monetary amount with currency. |
put_call | string: put | call | or null | Option type; |
quarteralways | string | |
filed_atalways | string (date-time) | |
filing_idalways | string |
InstitutionalSentiment#
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
quarteralways | string | |
funds_holdingalways | integer | Number of funds with a position in the reporting quarter. |
funds_increasedalways | integer | Funds that increased the position versus the previous quarter. |
funds_decreasedalways | integer | Funds that reduced the position versus the previous quarter. |
funds_new | integer | Funds that newly opened the position. |
funds_exited | integer | 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_shares | number | Sum of the reported share holdings (not a cash flow). |
total_value | Money | Monetary amount with currency. |
quarter_complete | boolean | 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_deadline | string (date) | Last filing day for this quarter. |
Disclosure#
| Field | Type | Description |
|---|---|---|
fund_namealways | string | |
fund_cikalways | string | Central Index Key of the reporting fund, always ten digits. |
quarteralways | string | |
filed_atalways | string (date-time) | |
holdings_countalways | integer | Number of positions in the disclosure. |
total_valuealways | Money | Monetary amount with currency. |
filing_idalways | string |
TickerEntry#
| Field | Type | Description |
|---|---|---|
tickeralways | string | |
cikalways | string | |
namealways | string |
Filing#
| Field | Type | Description |
|---|---|---|
filing_idalways | string | Accession number of the filing. All modules return it without a prefix; |
accession_number | string | |
form_typealways | string | |
cikalways | string | |
filed_atalways | string (date-time) | |
source_urlalways | string (uri) |
SourceStatus#
| Field | Type | Description |
|---|---|---|
sourcealways | string | |
form_type | string | |
last_import_atalways | string (date-time) | |
filings | integer | Number of stored filings of this form type. |
healthy | boolean | 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). |