Dilution Intelligence API
Programmatic access to DilutionScore, SEC filing history, short interest, and screener data — built for developers, quant traders, and research teams.
Up and Running in Minutes
No OAuth dance. No complex setup. One header and you're live.
X-API-Key: your_key on every request. No tokens to refresh, ever.https://dilutionwatch.com/api/v1/. All responses are JSON.API Endpoints
All endpoints require the X-API-Key header. Base URL: https://dilutionwatch.com/api/v1/
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 }
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 }
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" }
Paginated SEC filings with form type, filing date, description, dilution classification, and AI-extracted 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 } ] }
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 } ] }
Screen the full ticker universe by dilution risk. Costs 5 credits per call.
Params:
risk_level (LOW|MEDIUM|HIGH|CRITICAL) •
min_score, max_score (0–100) •
market_cap_tier (nano|micro|small|mid|large|mega) •
limit (max 200, default 50) •
offset
# 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" } ] }
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" }
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" } ]
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" }
Simple, Transparent API Pricing
No per-call overage charges. Hit your daily limit and calls return 429 until midnight UTC reset.
- ✓2,000 API calls/day
- ✓All 6 endpoints included
- ✓Burst limit: 30 req/minute
- ✓Screener endpoint (5 credits/call)
- ✓JSON REST API
- ✓Email support
- ✓20,000 API calls/day
- ✓All 6 endpoints included
- ✓Burst limit: 100 req/minute
- ✓Screener endpoint (5 credits/call)
- ✓JSON REST API
- ✓Priority support (24hr SLA)
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 integrate DilutionWatch data into your own applications. You may not resell raw API responses as a standalone data product. All data is for informational purposes only and does not constitute financial advice.
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.