Stock API Endpoint Roadmap
This roadmap shows the next product layers for ApiFinance from the perspective of professional stock research, value-investing analysis, and AI-agent workflows.
Who this roadmap is for
The goal is not more endpoints for their own sake. The goal is to make stock research workflows deeper, more repeatable, and more agent-ready.
- Professional Stock Finance UsersNeed normalized metrics, valuation history, filings context, and data that supports repeatable research pipelines.
- Value InvestorsNeed quality, growth durability, capital allocation, owner earnings, and long-range valuation context.
- AI AgentsNeed structured responses, clear metadata, and filing-backed evidence instead of loosely formatted outputs.
Priority 1 Endpoints
These are the first endpoints worth building because they offer the best mix of user value, product differentiation, and reusability across pages, APIs, and agents.
Priority 1
/stocks/{symbol}/fundamental-metrics
Normalized quality, return, leverage, and payout metrics derived from financial statements.
gross_marginroicnet_debt_to_ebitdashareholder_yield
Priority 1
/stocks/{symbol}/growth
Revenue, EPS, FCF, book-value-per-share, and share-count growth across standard horizons.
revenue_cagr_5yeps_cagr_5yfcf_cagr_3yshare_count_growth_5y
Priority 1
/stocks/{symbol}/capital-allocation
Capital deployment, repurchases, dilution, debt changes, and payout behavior in one response.
free_cash_flownet_buyback_amountdividends_paidshare_count_change_1y
Priority 1
/stocks/{symbol}/valuation-history
Time-series valuation context instead of one-point multiples.
peprice_to_fcfev_to_ebitdavaluation_percentile_10y
Priority 1
/stocks/{symbol}/filings/sections
Structured filing sections for evidence-backed research and AI-agent workflows.
business_textrisk_factors_textmanagement_discussion_textliquidity_text
Priority 2
These endpoints become more valuable once the normalized metrics and capital-allocation layers already exist.
/stocks/{symbol}/earnings
/stocks/{symbol}/estimates
/stocks/{symbol}/owner-earnings
Priority 3
These expand the research graph further once the core financial analysis layer is in place.
/stocks/{symbol}/entity
/stocks/{symbol}/segment-breakdown
/stocks/{symbol}/geographic-breakdown
/stocks/{symbol}/insiders
/stocks/{symbol}/institutional-ownership
/stocks/{symbol}/corporate-actions
Build Order
If only one endpoint should start immediately, it should be fundamental metrics. It delivers the strongest ratio of research value to implementation complexity and can feed both product UI and AI workflows.
- 1. Fundamental metrics
- 2. Growth
- 3. Capital allocation
- 4. Valuation history