Dilution Intelligence API

Programmatic access to DilutionScore, SEC filing history, reverse splits, tracker datasets, FTD history, short interest, and screener data — built for developers, quant traders, and research teams.

View Plans & Pricing Explore Endpoints

10K+

Tickers

Endpoints

Daily

Score Updates

REST

JSON API

Getting Started

Up and Running in Minutes

No OAuth dance. No complex setup. One header and you're live.

Choose a plan below. You need a DilutionWatch account — create one free if you don't have one yet.

Get Your Key

Your API key is emailed immediately after checkout and also shown in your account dashboard.

Add to Header

Pass X-API-Key: your_key on every request. No tokens to refresh, ever.

Call the API

Base URL: https://dilutionwatch.com/api/v1/. All responses are JSON.

Reference

API Endpoints

All endpoints require the X-API-Key header. Base URL: https://dilutionwatch.com/api/v1/

GET /api/v1/status Key usage & quota

Returns your key label, daily limit, and current usage. Use this to monitor quota programmatically.

# Check quota
curl https://dilutionwatch.com/api/v1/status \
  -H "X-API-Key: dw_your_key"

# Response
{
  "label":                  "My Key",
  "daily_limit":            2000,
  "requests_used_24h":      142,
  "requests_remaining_24h": 1858
}

GET /api/v1/ticker/{symbol} Full dilution profile

Complete ticker snapshot: DilutionScore, risk level, market data, and float/short metrics from Yahoo Finance cache.

# Full profile
curl https://dilutionwatch.com/api/v1/ticker/MARA \
  -H "X-API-Key: dw_your_key"

{
  "symbol":           "MARA",
  "company_name":     "MARA Holdings, Inc.",
  "exchange":         "NCM",
  "market_cap_tier":  "mid",
  "company_type":     "btc_treasury",
  "cik":              "0001507605",
  "dilution_score":   12,
  "risk_level":       "LOW",
  "score_updated_at": "2026-05-12T00:50:09",
  "market_cap":       5104231424,
  "shares_outstanding": 381197264,
  "public_float":     371603309,
  "short_percent_of_float": 35.32,
  "pe_ratio":         null,
  "eps":              -3.69,
  "beta":             5.43
}

GET /api/v1/ticker/{symbol}/score DilutionScore + factor breakdown

Full scoring detail: composite score, risk level, share growth, cash runway, warrants, convertibles, shelf/ATM capacity, and raw factor JSON.

# Score breakdown
curl https://dilutionwatch.com/api/v1/ticker/ACMR/score \
  -H "X-API-Key: dw_your_key"

{
  "symbol":                "ACMR",
  "overall_score":         67,
  "risk_level":            "HIGH",
  "share_growth_3yr_pct":  212.4,
  "months_cash_remaining": 8.3,
  "outstanding_warrants":  1240000,
  "convertible_shares":    3800000,
  "shelf_capacity_dollars": 45000000,
  "atm_remaining_dollars":  12500000,
  "factors": { /* full factor object */ },
  "calculated_at":         "2026-05-12T00:50:09"
}

GET /api/v1/ticker/{symbol}/filings SEC filing history

Paginated SEC filings with form type, filing date, description, dilution classification, and share/dollar estimates where available.

Params: limit (max 100, default 20) • offset (default 0)

# Last 5 filings
curl "https://dilutionwatch.com/api/v1/ticker/ACMR/filings?limit=5" \
  -H "X-API-Key: dw_your_key"

{
  "symbol": "ACMR",
  "count":  5,
  "filings": [
    {
      "accession":         "0001234567-26-000001",
      "form_type":         "424B5",
      "filing_date":       "2026-05-01",
      "description":       "ATM sale — 4.2M shares",
      "is_dilution_related": true,
      "dilution_type":     "ATM",
      "estimated_shares":  4200000,
      "estimated_dollars": 7686000
    }
  ]
}

GET /api/v1/ticker/{symbol}/short Short interest history

FINRA bi-monthly short interest data: shares short, days-to-cover, short % of float and outstanding, and change vs prior period.

Params: limit (max 50, default 12)

# Short interest history
curl https://dilutionwatch.com/api/v1/ticker/MARA/short \
  -H "X-API-Key: dw_your_key"

{
  "symbol": "MARA",
  "count":  12,
  "history": [
    {
      "settlement_date":      "2026-04-30",
      "short_interest":       100147342,
      "avg_daily_volume":     46332551,
      "days_to_cover":        2.16,
      "short_pct_float":      26.95,
      "short_pct_outstanding": 26.27,
      "change_pct":           -4.35
    }
  ]
}

GET /api/v1/screener Filter 10,000+ tickers by risk 5 credits

Screen the full ticker universe by dilution risk. Costs 5 credits per call.

# CRITICAL-risk micro-caps
curl "https://dilutionwatch.com/api/v1/screener?risk_level=CRITICAL&market_cap_tier=micro&limit=50" \
  -H "X-API-Key: dw_your_key"

{
  "total":       312,
  "count":       50,
  "offset":      0,
  "credits_used": 5,
  "results": [
    {
      "symbol":          "XYZW",
      "company_name":    "Example Corp",
      "exchange":        "OTC",
      "market_cap_tier": "micro",
      "dilution_score":  89,
      "risk_level":      "CRITICAL",
      "score_updated_at": "2026-05-12T00:00:00"
    }
  ]
}

GET /api/v1/reverse-splits Historical reverse split records

Structured reverse split history with effective dates, display ratios, numeric split ratios, and related risk context. Ticker-specific lookups resolve known symbol changes such as FFIE/FFAI.

Params: symbol optional • year optional • limit max 500 • offset

# Recent reverse splits
curl "https://dilutionwatch.com/api/v1/reverse-splits?limit=25" \
  -H "X-API-Key: dw_your_key"

# Reverse split history for one ticker
curl "https://dilutionwatch.com/api/v1/ticker/MULN/reverse-splits" \
  -H "X-API-Key: dw_your_key"

# Alias-aware lookup across FFIE/FFAI history
curl "https://dilutionwatch.com/api/v1/ticker/FFIE/reverse-splits?limit=50" \
  -H "X-API-Key: dw_your_key"

{
  "has_more": false,
  "next_offset": null,
  "reverse_splits": [
    {
      "symbol":         "MULN",
      "effective_date": "2025-02-18",
      "display_ratio":  "1-for-100",
      "split_ratio":    0.01
    }
  ]
}

GET /api/v1/tracker/filing-history Filing-level extracted tracker terms

Historical extracted terms from SEC filings across shelf registrations, ATM programs, warrants, and PIPE/private placement events.

Params: category (shelf|atm|warrants|pipe|all), symbol optional, start_date, end_date, limit max 500, offset

curl "https://dilutionwatch.com/api/v1/tracker/filing-history?category=shelf&limit=100&offset=0" \
  -H "X-API-Key: dw_your_key"

curl "https://dilutionwatch.com/api/v1/tracker/filing-history?symbol=FFAI&category=all&start_date=2021-01-01" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/tracker/shelf-atm Shelf, ATM, warrant, and convertible exposure

API version of the Shelf & ATM Monitor. Includes shelf capacity, ATM remaining, warrants, convertibles, market-cap ratios, and dilution percentages.

curl "https://dilutionwatch.com/api/v1/tracker/shelf-atm?category=shelf&limit=50" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/tracker/warrants Warrant tracker dataset

Outstanding warrant exposure with coverage percent, estimated dilution percent, strike price where available, exercise proceeds, and in-the-money flag.

Params: sort_by (warrants|strike|coverage|risk|symbol), min_warrants, limit, offset

curl "https://dilutionwatch.com/api/v1/tracker/warrants?sort_by=coverage&limit=50" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/tracker/pipe PIPE and private placement events

Structured 8-K extracted deal events: placements, offerings, convertible issuances, and warrant issuances.

curl "https://dilutionwatch.com/api/v1/tracker/pipe?deal_type=placement&limit=50" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/ftd Fails-to-deliver history

SEC fails-to-deliver history with settlement date, quantity, price, value, and summary severity.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/ftd?limit=30" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/timeline Timeline and historical activity

Combined historical activity for one ticker: dilution score history, dilution-related SEC filing events, and extracted shelf/ATM/warrant/PIPE insight events.

Params: days 30-3650, default 365; optional start_date, end_date, event_limit max 1000, event_offset

curl "https://dilutionwatch.com/api/v1/ticker/MARA/timeline?days=365" \
  -H "X-API-Key: dw_your_key"

curl "https://dilutionwatch.com/api/v1/ticker/FFIE/timeline?start_date=2021-01-01&event_limit=500" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/insiders Insider transaction history

Form 4 and ownership-derived insider transaction records with insider name, title, transaction type, shares, price, value, source URL, and accession.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/insiders?limit=50" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/short-volume Daily short volume

Daily short-volume history including short volume, total volume, short-volume ratio, market, and update time.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/short-volume?limit=60" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/institutional/history Quarterly institutional ownership

Quarterly institutional ownership history with total shares, holder count, percent of shares, top holder, share changes, and top-holder summary.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/institutional/history?limit=12" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/news Recent ticker news

Cached ticker news with title, URL, source, publication time, sentiment, and fetch timestamp.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/news?limit=25" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/float-history Float history

Historical public float and shares-outstanding observations with change percent and reason where available.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/float-history?limit=100" \
  -H "X-API-Key: dw_your_key"

GET /api/v1/ticker/{symbol}/fundamentals Fundamentals snapshot

Shares, EPS, revenue, net income, cash, debt, operating cash flow, capex, free cash flow, profit margin, source metadata, and confidence fields used by DilutionScore.

curl "https://dilutionwatch.com/api/v1/ticker/MARA/fundamentals" \
  -H "X-API-Key: dw_your_key"

POST /api/v1/keys Create an API key

Create a new API key (requires active browser session, not an API key). Max 5 active keys per account. The raw key is returned once — save it immediately.

# Create a key (session auth via cookie)
curl -X POST https://dilutionwatch.com/api/v1/keys \
  -H "Content-Type: application/json" \
  -H "X-Session-Token: your_session_token" \
  -d '{"label": "My trading script"}'

{
  "id":          12,
  "label":       "My trading script",
  "key":         "dw_a1b2c3...",
  "daily_limit": 2000,
  "created_at":  "2026-05-12T20:00:00"
}

GET /api/v1/keys List your API keys

Returns all active and inactive keys for your account. Requires session auth. Raw key values are never returned after creation.

# List keys
curl https://dilutionwatch.com/api/v1/keys \
  -H "X-Session-Token: your_session_token"

[
  {
    "id":           12,
    "label":        "My trading script",
    "daily_limit":  2000,
    "is_active":    true,
    "created_at":   "2026-05-12T20:00:00",
    "last_used_at": "2026-05-12T21:14:00"
  }
]

DELETE /api/v1/keys/{key_id} Revoke an API key

Deactivates a key by ID. Must belong to your account. Requires session auth. Revocation is immediate and irreversible.

# Revoke key ID 12
curl -X DELETE https://dilutionwatch.com/api/v1/keys/12 \
  -H "X-Session-Token: your_session_token"

{ "message": "API key revoked" }

API Plans

Simple, Transparent API Pricing

No per-call overage charges. Hit your daily limit and calls return 429 until midnight UTC reset.

API Developer

$79.95/mo

For individual developers and independent researchers.

✓2,000 API calls/day
✓All 19 documented endpoints included
✓Burst limit: 30 req/minute
✓Screener endpoint (5 credits/call)
✓JSON REST API
✓Email support

Covers ~2,000 ticker lookups or 400 screener calls per day.

Best for Teams

API Pro

$499/mo

For trading firms, research teams, and production pipelines.

✓20,000 API calls/day
✓All 19 documented endpoints included
✓Burst limit: 100 req/minute
✓Screener endpoint (5 credits/call)
✓JSON REST API
✓Priority support (24hr SLA)

Covers nightly full-universe scans + intraday lookups for live trading systems.

Need higher limits or a custom enterprise contract? Contact us.

API FAQ

Do I need a DilutionWatch account to use the API?

Yes. API plans are linked to your DilutionWatch account. If you don't have one, create a free account first, then subscribe to an API plan. Your API key is emailed after checkout and visible in your dashboard.

How are credits counted?

Most endpoints cost 1 credit per call. The screener endpoint costs 5 credits because it queries the full 10,000+ ticker universe. Your daily limit resets at 00:00 UTC. Check /api/v1/status for real-time usage.

What happens when I hit my daily limit?

Calls return HTTP 429 with a JSON body showing your reset time. No overage charges — usage resumes at midnight UTC. You can upgrade your plan any time from your account dashboard.

How often is the data updated?

DilutionScores recalculate each morning from the latest SEC EDGAR data. Short interest follows the FINRA bi-monthly release schedule. The /filings endpoint reflects new filings within hours of EDGAR publication.

Is there a sandbox or free trial?

No sandbox at this time. The free DilutionWatch account gives full access to the web interface, which you can use to evaluate data quality before subscribing. Enterprise trials may be available — contact us.

Can I use the data in a commercial product?

Yes, subject to our Terms of Service. You may use DilutionWatch API data for internal analytics, internal trading/research tools, and limited customer-specific work product. You may not publish, redistribute, resell, expose, or use the API data to build a public site, dashboard, screener, data feed, or competing product that substitutes for DilutionWatch. Commercial redistribution requires a separate written data license.

What authentication does the API use?

Pass your API key in the X-API-Key request header on every call. No OAuth, no token refresh. Keep your key secret — treat it like a password. You can regenerate it from your dashboard if it is compromised.

What tickers are covered?

All 10,000+ SEC EDGAR filers across OTC, NYSE, and Nasdaq. Coverage mirrors the DilutionWatch platform. Tickers not yet scored return a 404 with an explanation. You can request coverage for any unlisted ticker.

Ready to build with dilution data?

Start with the Developer plan at $79.95/mo. Upgrade or cancel any time.

Contact for Enterprise