Limits and caveats

What this API does not do, stated plainly. Discovering a limitation in production is worse than reading it here.

History starts 2026-08-04

That is the honest number. Everything before that date does not exist in this dataset.

The practical consequence: v1 is a real-time signal product, not a research dataset. It does not support backtesting, and any strategy study you run against it will be measuring a few months, not a few years. The archive deepens every day, so this constraint weakens over time — but do not design around history you do not have yet.

Coverage

Scored filings	~21,000 and growing daily
Events	~6,900, of which ~2,000 are forward-dated
Companies	~8,700 listed, ~5,200 active
Editorial articles	Growing daily

Filings come from BSE. A company that files only with NSE will be thinly covered or absent.

What impact_score is not

It is a model's estimate of how market-moving a filing is, on a 0–10 scale, where above 7 is materially market-moving.

It is not:

• a prediction of direction — that is sentiment, and it is separately estimated
• a price target, a recommendation, or investment advice
• a guarantee of anything; it is a model output and models are wrong sometimes
• comparable across long time spans if we retrain the scorer; a scoring change is announced before it ships

Same for sentiment (positive / neutral / negative) and, on events, expected_direction and conviction.

Latency

A filing is available through this API once it has been fetched from the exchange and scored. Scoring involves reading the filed document, so the gap between filed_at and scored_at is usually under a minute but is longer for large documents.

ck_test_ keys and the Developer and Starter plans serve filings on a deliberate delay — see rate limits. Growth and Enterprise have no delay.

Our own editorial articles under /v1/news are never delayed, on any plan.

Ticker is not unique

Around 110 tickers map to more than one ISIN. ?ticker= is a convenience that may match several securities, and it will return filings for all of them. ISIN is the primary key.

Not in v1

• Fundamentals — P&L, balance sheet, cash flow, ratios and shareholding are not exposed.
• Real-time prices — we do not license them, and brokers do this better.
• Streaming — an SSE feed is planned, not shipped.

Company logos

logo_url on the companies endpoints is available from the Starter plan up, and is null below it.

It is priced separately from everything else in this API because it is the one field whose subject is not ours: company logos are third-party trademarks that we host and redistribute under a licence term, not data we produce. Your licence permits displaying a mark to identify the issuer it belongs to. It does not permit using one to suggest affiliation with, or endorsement by, that company.

The same applies to hero_image on /v1/news, which embeds a logo in the card it generates — below Starter the card is returned without one.

Operational reality

This is a small, focused service. There is no formal uptime SLA on the self-serve plans. If you need one, along with a support response commitment, talk to us before you build a production dependency.