Changelog
Every change to the API that a client can notice, newest first, and the rules that decide when a change gets a new version.
Versioning
The version is part of the base URL, currently /v1. Within a version, changes are additive: new endpoints, new optional parameters, new response fields and new notes in meta.warnings can appear at any time. Ignore what you do not know rather than rejecting it.
Removing or renaming an endpoint, parameter or field, or changing its type or meaning, is a breaking change. It goes into a new version, and the previous one keeps running for a transition period announced on this page. Corrections to how a filing is read are fixes, not breaking changes: the data is meant to match the filing, and methodology describes how it does.
These are the rules we work by, not a guarantee; the terms and conditions govern availability and changes of the service.
Changes
- Changed: A 429 now documents its Retry-After header, and the specification states that its body is plain text.
- Changed: /status and meta.data_freshness are aggregated in the background, so they answer quickly; healthy is judged against the usual filing rhythm of each source.
- Added: Cluster buys carry uniform_price, true when the buyers all paid the same price; exclude_uniform_price leaves those clusters out.
- Added: Cluster buys can be computed as known at the end of a past day with as_of.
- Added: Form 4/A and 5/A amendments are returned as rows of their own; form_type filters on the form.
- Fixed: A company with several tickers resolves to the ticker the SEC lists first.
- Changed: The MCP server is named algoum-mcp.
- Fixed: The currency of a Form 4 price is read from the filing instead of always being USD.
- Added: The MCP server serves the OpenAPI specification.
- Added: Live stream of new cluster buys, and the roles filter on cluster buys.
- Added: MCP server at /v1/mcp with the same key as the API.
- Removed: ClusterBuy.first_available_at, which never carried a value.
- Fixed: filed_at of an 8-K is the time EDGAR accepted the filing.
- Fixed: The ticker of an 8-K comes from its cover page instead of today’s ticker list.
- Fixed: A missing Form 4 price is null instead of 0.
- Added: Version 1 of the API.