Skip to content
DilutionScan

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

  1. 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.
  2. 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}/coverageWhether the company has been analysed, and as of which filing
/dilution/{ticker}/snapshotThe 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}/riskDilution risk rating and the components behind it
/dilution/{ticker}/ib6Baby-shelf (General Instruction I.B.6) remaining capacity
/dilution/{ticker}/historyShares outstanding and cash over time
/dilution/{ticker}/performanceHow 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}/historyQuarterly cash history from XBRL

Float and short interest

/companies/{ticker}/floatFloat breakdown
/companies/{ticker}/float-historyPoint-in-time float history
/companies/{ticker}/short-interestShort interest

Reverse splits

/reverse-splitsUpcoming and pending reverse splits, with each split’s stage
/reverse-splits/endedFailed votes, abandoned splits and expired authority
/reverse-splits/authorityCompanies whose board still holds reverse-split authority
/reverse-split-lifecycle/{ticker}One company’s reverse-split history and current stage

Listing compliance

/compliance/{ticker}/evaluationExchange listing rules (bid price, equity, market value) evaluated for the company

Screener

/screenerScreen companies by price, volume, float, shares outstanding, market cap and cash runway

SEC filings

/edgar/filingsSearch and list filings
/edgar/search-textFull-text search across filing exhibits
/edgar/accession/{accessionNumber}Look up a filing by accession number
/edgar/accession/{accessionNumber}/documentsList 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}/coverage first 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-Remaining and X-RateLimit-Reset, plus the X-DailyLimit-* equivalents.

Errors

Errors return JSON as { "error": { "code", "message" } }.

401API_KEY_REQUIREDNo key was sent.
401INVALID_API_KEYThe key is wrong or has been revoked.
403FEATURE_NOT_AVAILABLEThe endpoint is not part of your plan (Signal8 Pro includes the whole Signal8 API).
429RATE_LIMIT_EXCEEDEDOver the per-minute limit. Wait for the Retry-After header.
429DAILY_LIMIT_EXCEEDEDOver the daily request limit.
429DILUTION_DAILY_TICKER_LIMITOver 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.

DilutionScanEvery instrument in full · From $29.99/mo