API & MCP access

The same per-company data the site shows, for AI assistants and scripts. One company per call — that is the product's shape, not a missing feature.

MCP server — for Claude and other AI assistants

DilutionLens runs a remote MCP (Model Context Protocol) server over streamable HTTP:

https://dilutionlens.com/mcp

Add it to any MCP-capable client as a remote server. The free tool works with no key at all; the paid tools need an API key from your account page, sent as the x-api-key header (custom-header support is standard in MCP clients).

Tool	What it returns	Access
`get_dilution_snapshot`	Headline metrics for one company: dilution risk level, cash cover band, market cap, 12-month raise count, max dilution % — what the free company page shows	Free, keyless or keyed, ~20 calls/day
`get_raise_history`	Every capital raise on record for one company	Paid plan + API key. Calls share your account's rate limit with the site — a few hundred calls a day in practice
`get_options`	Every option and convertible line for one company
`get_cash_runway`	Quarterly cash and runway history (IQ Cash)
`get_issuance_timeline`	The dated share-issuance timeline, cited to filings
`get_insiders`	Director dealing notices for one company
`screen`	Screen the market by risk, cash cover, market cap or industry — top 20 rows, a discovery tool rather than an extract	Paid plan + API key

REST API

The same payloads over plain GET, for scripts. Send your key as the x-api-key header — not Authorization, which our CDN reserves. Full schema: openapi.json.

Endpoint	Access
`GET /api/v1/company/{ticker}/snapshot`	Free, keyless or keyed, ~20/day
`GET /api/v1/company/{ticker}/raises` `GET /api/v1/company/{ticker}/options` `GET /api/v1/company/{ticker}/cash` `GET /api/v1/company/{ticker}/timeline` `GET /api/v1/company/{ticker}/insiders`	Paid plan + API key
`GET /api/v1/screen`	Paid plan + API key; top 20 rows
`GET /api/v1/company/{ticker}/raises.csv` `GET /api/v1/company/{ticker}/options.csv` `GET /api/v1/company/{ticker}/timeline.csv`	Paid plan + API key; one company per file

curl -s https://dilutionlens.com/api/v1/company/BHP/snapshot
curl -s -H "x-api-key: dlk_..." \
  https://dilutionlens.com/api/v1/company/BHP/raises
curl -s -OJ -H "x-api-key: dlk_..." \
  https://dilutionlens.com/api/v1/company/BHP/raises.csv

CSV export

Three of the paid endpoints also serve CSV: add .csv to raises, options or timeline. The columns are the JSON field names of the same rows, so the two views of an endpoint carry one vocabulary, and the file is named <TICKER>-<kind>-<date>.csv after the data date rather than the download date. One company per file — the same per-ticker scope as everything else here — and the same shared rate budget. The Export button on a company page is this endpoint over your session.

The timeline carries the 200 most recent issuance filings. A handful of long-listed companies have more than that on record; the JSON endpoint and the company page show the same 200, so the CSV is never a shorter answer than the site gives.

Rate limits and scope

Everything is per-ticker. There are no bulk, batch, list-all or market-wide endpoints at any tier, and requests shaped that way are answered with a pointer to our professional offering. Keyed calls draw on one per-account rate budget shared with the website — generous for research and integrations, deliberately impractical for harvesting the whole market.

Need bulk data, integrations or advanced analytics? pro@dilutionlens.com.

Keys

Create and revoke keys on your account page. A key is shown once at creation and stored hashed; revocation takes effect immediately. Any signed-in account can hold keys — the free snapshot tool works with one — and the paid tools follow your plan. See plans.