DilutionScan API
The DilutionScan API returns the data behind this site as JSON: dilution snapshots and instruments, baby-shelf capacity, cash runway, float, reverse splits, listing compliance and SEC filings. It is included in the DilutionScan plan and in Signal8 Pro. Prefer to ask in plain English? Use the MCP server.
Quickstart
- Create a key on the Signal8 API keys page. A DilutionScan account is a Signal8 account, so sign in with the same email you use here.
- Send it with every request, then call an endpoint:
Base URL
https://dilutionscan.com/api/v1/public
curl -H "Authorization: Bearer $DILUTIONSCAN_API_KEY" \ "https://dilutionscan.com/api/v1/public/dilution/TICKER/snapshot"
Replace TICKER with a symbol. Keep the key on your server: anyone holding it can use your allowance.
Authentication
Send the key in an Authorization: Bearer sk_live_… header, or in X-API-Key. A request without a valid key returns 401. You can hold up to 3 keys, and revoke or rotate them on the keys page.
Endpoints
All endpoints are GET and read-only. Paths are relative to the base URL. Parameters and response fields for each one are in the full API reference.
Dilution
| /dilution/{ticker}/coverage | Whether the company has been analysed, and as of which filing |
| /dilution/{ticker}/snapshot | The current dilution snapshot: totals, ratings and each instrument family |
| /dilution/{ticker}/instruments?family={family} | One instrument family’s rows, each cited to its filing. family is required: warrants, convertibles, preferred, shelfs, atms, elocs, s1_offerings, equity_plans, exchangeables, recent_offerings or rights |
| /dilution/{ticker}/risk | Dilution risk rating and the components behind it |
| /dilution/{ticker}/ib6 | Baby-shelf (General Instruction I.B.6) remaining capacity |
| /dilution/{ticker}/history | Shares outstanding and cash over time |
| /dilution/{ticker}/performance | How the stock traded after past dilution events (historical, not a forecast) |
Cash
| /cash-position/{ticker} | Cash position, burn and runway from the dilution snapshot |
| /cash-position/{ticker}/history | Quarterly cash history from XBRL |
Float and short interest
| /companies/{ticker}/float | Float breakdown |
| /companies/{ticker}/float-history | Point-in-time float history |
| /companies/{ticker}/short-interest | Short interest |
Reverse splits
| /reverse-splits | Upcoming and pending reverse splits, with each split’s stage |
| /reverse-splits/ended | Failed votes, abandoned splits and expired authority |
| /reverse-splits/authority | Companies whose board still holds reverse-split authority |
| /reverse-split-lifecycle/{ticker} | One company’s reverse-split history and current stage |
Listing compliance
| /compliance/{ticker}/evaluation | Exchange listing rules (bid price, equity, market value) evaluated for the company |
Screener
| /screener | Screen companies by price, volume, float, shares outstanding, market cap and cash runway |
SEC filings
| /edgar/filings | Search and list filings |
| /edgar/search-text | Full-text search across filing exhibits |
| /edgar/accession/{accessionNumber} | Look up a filing by accession number |
| /edgar/accession/{accessionNumber}/documents | List the documents in a filing |
| /edgar/document/{filingId} | Full filing document text |
| /edgar/exhibits/{filingId} | List a filing’s exhibits |
| /edgar/exhibit/{id} | Exhibit content |
How figures are reported
- Every figure cites the SEC filing it came from and carries its as-of date.
- A value that was not measured is null, never zero and never no dilution. Check for null before using a number.
- A company DilutionScan has not analysed yet is reported as not covered, which is different from having no dilution. Call
/dilution/{ticker}/coveragefirst if you need to tell them apart. - The data is the same as on the website. See how we read filings for sources and limits.
Limits
- 120 requests a minute and 10,000 a day per key.
- Dilution data for up to 25 different tickers a day (10 during a free trial). A ticker you already read today does not count again, and the coverage endpoint never counts. The allowance resets at midnight US Eastern.
- The ticker allowance is per account and shared with the MCP server. The MCP server has the same request limits.
- Every response carries
X-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Reset, plus theX-DailyLimit-*equivalents.
Errors
Errors return JSON as { "error": { "code", "message" } }.
| 401 | API_KEY_REQUIRED | No key was sent. |
| 401 | INVALID_API_KEY | The key is wrong or has been revoked. |
| 403 | FEATURE_NOT_AVAILABLE | The endpoint is not part of your plan (Signal8 Pro includes the whole Signal8 API). |
| 429 | RATE_LIMIT_EXCEEDED | Over the per-minute limit. Wait for the Retry-After header. |
| 429 | DAILY_LIMIT_EXCEEDED | Over the daily request limit. |
| 429 | DILUTION_DAILY_TICKER_LIMIT | Over today’s distinct-ticker allowance for dilution data. Tickers you already read today still work. |
Plans
The API is included in the DilutionScan plan. See pricing.
Signal8 Pro includes everything above plus the rest of the Signal8 API: financials, earnings, insider and institutional ownership, analyst coverage, congressional trades and more, on the same request limits. About Signal8 Pro.
DilutionScan reports what companies have filed. It does not give investment advice or predict prices.