Stock News API Stocks Crypto News API Crypto Forex News API Forex
Login Register
Documentation Methodology Examples Pricing FAQ's Contact Register

Data Methodology

Data Source

All financial data is sourced directly from the SEC EDGAR (Electronic Data Gathering, Analysis, and Retrieval) system:

  • 10-K Filings: Annual reports containing audited financial statements
  • 10-Q Filings: Quarterly reports with unaudited financial statements
  • XBRL Data: Machine-readable structured data extracted from SEC filings
  • Update Cycle: Data is refreshed within 24 hours of SEC filing publication
Coverage
  • SEC Universe: 5,000+ US public companies filing with the SEC
  • Historical Data: 17+ years of financial history (since 2008)
  • Statement Types: Income statements, balance sheets, and cash flow statements
XBRL Field Mappings

We map standardized API fields to their corresponding XBRL taxonomy tags. Since companies may use different tags, we check multiple options:

API Field XBRL Tags (in priority order)
revenue us-gaap:Revenues, us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax, us-gaap:SalesRevenueNet
net_income us-gaap:NetIncomeLoss, us-gaap:ProfitLoss
total_assets us-gaap:Assets
operating_cash_flow us-gaap:NetCashProvidedByUsedInOperatingActivities
eps_diluted us-gaap:EarningsPerShareDiluted
stockholders_equity us-gaap:StockholdersEquity, us-gaap:StockholdersEquityIncludingPortionAttributableToNoncontrollingInterest
free_cash_flow Calculated: operating_cash_flow - capital_expenditures
Calculated Metrics
Profitability Ratios
  • gross_margin = (revenue - cost_of_revenue) / revenue × 100
  • operating_margin = operating_income / revenue × 100
  • net_margin = net_income / revenue × 100
  • roe = net_income / stockholders_equity × 100
  • roa = net_income / total_assets × 100
Liquidity Ratios
  • current_ratio = current_assets / current_liabilities
  • quick_ratio = (current_assets - inventory) / current_liabilities
  • cash_ratio = cash_and_equivalents / current_liabilities
Leverage Ratios
  • debt_to_equity = total_debt / stockholders_equity
  • debt_to_assets = total_debt / total_assets
Growth Metrics
  • YoY Growth = (current - prior) / |prior| × 100
  • 3Y CAGR = (current / three_years_prior)^(1/3) - 1
  • 5Y CAGR = (current / five_years_prior)^(1/5) - 1
TTM (Trailing Twelve Months)
  • Flow items (revenue, net_income, etc.): Sum of most recent 4 quarters
  • Balance sheet items: Most recent quarter (MRQ) point-in-time values
Ben