Skip to content
Finpoint

Overview

Finpoint Financial Data API (0.5.0)

Normalized SEC EDGAR XBRL financial data exposed via a Go REST API.

The API reads from a star-schema PostgreSQL warehouse populated by the Finpoint ETL pipeline. The pipeline ends at fact_xbrl_derived_facts — all query-level logic (TTM windows, period filtering, fiscal year selection) is handled by the API per ADR-021.

Fixed-Schema Contract: Standard statement endpoints (/financial-statements/income-statement, /financial-statements/balance-sheet, /financial-statements/cashflow-statement) return the complete set of known metrics per statement type. Metrics without reported data for a given company appear as null rather than being omitted. This guarantees the same response shape for every ticker. See the /financial-statements/as-reported/{ticker} endpoint for unfiltered access to every concept a company reports in its XBRL filings.

Trailing Twelve Months (TTM): Pass ?period=ttm to any statement or financial-ratios/ratios endpoint. Flow metrics (revenue, expenses, net income) are summed over the last 4 individual quarterly values. Instant metrics (assets, liabilities, equity) use the latest reported value. Ratios are computed on-the-fly from TTM-aggregated inputs with letter grades.