SecuritiesDB Developer API
Quantitative financial data via simple GET requests. ETF overlap analysis, Piotroski/Altman Z scores, DCF models, Fama-French factors, insider flow, and AI-powered NLP insights — all from SEC filings.
Quick Start
All endpoints return a JSON envelope:
{
"status": "success",
"data": { ... }
}Example — compare two ETFs:
curl "https://securitiesdb.com/api/v1/etfs/overlap?etf1=SPY&etf2=IVV"
Rate Limit
100 requests per minute per IP. Headers: X-RateLimit-Remaining
Caching
Responses cached for 5 minutes (CDN: 10 min). Data updates daily from SEC filings.
Attribution
Please link back to securitiesdb.com when using data publicly. Required for free tier.
Endpoint Reference
🔬 ETF Forensics
/api/v1/etfs/overlap?etf1={ETF1}&etf2={ETF2}ETF Overlap Matrix
Compare two ETFs — returns overlap %, shared holdings, unique holdings, and a diversification verdict.
overlap_pctshared_holdingsverdicttop_shared_holdings[]/api/v1/etfs/{ticker}/xrayETF X-Ray
Deep fundamental scan: HHI concentration, bottom-up Piotroski/Altman Z, weighted PE/PB, style classification, risk metrics.
overviewvaluationconcentrationriskbottom_up_analysis/api/v1/etfs/{ticker}/holdingsETF Holdings
Full constituent list with weights, sector breakdown, and per-holding Piotroski & Altman Z scores.
sector_breakdownholdings[].tickerholdings[].weight_pctholdings[].piotroski_f📊 Quantitative Stock Analysis
/api/v1/stocks/{ticker}/quant-healthQuant Health Check
Piotroski F-Score (0-9), Altman Z-Score, Beneish M-Score, ROIC-WACC spread, DuPont decomposition, full profitability/growth/leverage/risk metrics.
scoresvalue_creationprofitabilitygrowthleverageriskvaluation/api/v1/stocks/{ticker}/dcfDCF Valuation
Fair value from discounted cash flow model, upside %, WACC, implied market growth rate, 3×3 sensitivity matrix.
dcf.fair_valuedcf.upside_pctdcf.waccsensitivity_matrix/api/v1/stocks/{ticker}/fama-frenchFama-French Five-Factor
Factor loadings: market beta, SMB (size), HML (value), RMW (profitability), CMA (investment), alpha, R².
factors.market_betafactors.size_smbfactors.value_hmlalpha_annualizedr_squared/api/v1/stocks/{ticker}/passive-floatPassive Float Lock-Up
How much of a stock is trapped inside passive ETFs. Total shares held by ETFs, blind dollar flow, top 20 ETF holders.
passive_float.locked_pctpassive_float.blind_dollarstop_etf_holders[]💰 Stock Data
/api/v1/stocks/{ticker}/dividendsDividend & Split History
Complete dividend and stock split history with annual totals and consecutive increase streak count.
summary.annual_totalssummary.consecutive_annual_increasesdividends[]splits[]🧠 Alternative Data & NLP
/api/v1/stocks/{ticker}/insider-activityInsider & Institutional Flow
Recent insider transactions (buys/sells/grants) with net buy/sell ratio, plus top institutional 13F flow changes.
insider_transactions.net_buy_sell_ratioinsider_transactions.recent[]institutional_flow[]/api/v1/stocks/{ticker}/risk-factorsRisk Factor Analysis (Lawyer Panic Index)
AI-extracted 10-K risk factor word count trend and newly added risks year-over-year. Detects sudden expansion of risk disclosure.
summary.signalword_count_trend[]new_risks[].risks[]/api/v1/stocks/{ticker}/earnings-transparencyEarnings Call Transparency Score
AI-scored evasiveness of management answers on earnings calls (1-10). Tracks deflection patterns across quarters.
summary.latest_scoresummary.trendlatest_deflection_quotehistory[]/api/v1/stocks/{ticker}/catalystsSEC Filing Catalysts
AI-summarized material events from 8-K, 10-Q, 10-K filings with direct SEC filing links.
catalysts[].summarycatalysts[].filing_typecatalysts[].sec_urlInteractive Playground
Select an endpoint, enter parameters, and see live JSON responses.
ETF Forensics
Stock Quant
Market Mechanics
Stock Data
Alternative Data
/api/v1/etfs/overlapCompare two ETFs and discover their holdings overlap percentage, shared holdings detail, and diversification verdict.
Parameters
curl "https://securitiesdb.com/api/v1/etfs/overlap?etf1=SPY&etf2=IVV"What Can You Build?
Portfolio Overlap Checker
Use the ETF Overlap endpoint to build a tool that warns investors about redundant holdings across their ETF positions.
/api/v1/etfs/overlap?etf1=VTI&etf2=VOOQuant Screening Dashboard
Combine Piotroski F-Score, Altman Z, and DCF data to build a stock screener that finds undervalued, financially healthy companies.
/api/v1/stocks/AAPL/quant-healthPassive Flow Monitor
Track which stocks have the highest percentage of float locked in ETFs — a leading indicator of reduced price discovery.
/api/v1/stocks/NVDA/passive-floatNLP Risk Dashboard
Monitor the "Lawyer Panic Index" — detect when companies suddenly expand their 10-K risk disclosure, an early warning signal.
/api/v1/stocks/META/risk-factorsEarnings Quality Tracker
Track management evasiveness on earnings calls over time. Rising scores may predict future disappointments.
/api/v1/stocks/AMZN/earnings-transparencyFactor-Based ETF Analyzer
Combine Fama-French factors with ETF holdings to understand the true factor exposure of any fund.
/api/v1/stocks/TSLA/fama-frenchTutorials
Step-by-step guides that build real tools with the API.
Free Alternatives
How SecuritiesDB compares to paid financial data platforms.
Data Sources & Legal
All data is derived from publicly available SEC filings (EDGAR), including 10-K, 10-Q, 8-K, N-PORT, and 13F filings. Quantitative scores (Piotroski, Altman Z, Beneish M, DuPont, DCF) are computed from these public filings using standard academic formulas. NLP analysis is performed using large language models on public filing text.
This API is provided for informational and educational purposes only. It does not constitute financial advice. Past performance does not guarantee future results.
Free tier: 100 requests per minute. Attribution required — please include a link to securitiesdb.com when using data publicly.