Metrics & Dividends: A New Dedicated Endpoint for Asset-Level Financial Data

A new endpoint, Metrics & Dividends, is now available in FinImpulse’s API. The endpoint returns a consolidated set of financial and market metrics for a single asset symbol. Instead of retrieving a full data snapshot and filtering out what is not relevant to a given analysis, it is now possible to query dividend and historical performance data, profitability, growth, leverage, and business quality indicators directly, through a single, focused request.

Metrics Endpoint Coverage and Asset Compatibility

The Metrics & Dividends endpoint returns five general categories of data, each addressing a different aspect of an asset’s financial profile.

• Dividends & Yield: Covers forward and trailing dividend rate and yield, including figures normalized to USD.
• Returns & Performance: Includes one-year and three-year total return figures.
• Technical Indicators: Covers price changes relative to 50-day and 200-day moving averages, and over the trailing 52 weeks.
• Profitability & Margins: Includes free cash flow margin (FCF), return on invested capital (ROIC), net margin, and return on equity (ROE) metrics.
• Growth & Risk: Groups beta, debt-to-equity (D/E), revenue stability, revenue growth, and EPS growth metrics.

This range of metrics makes the endpoint suited to a variety of workflows, from powering a single asset lookup to feeding a broader analytics feature.

Explore the endpoint documentation for full request and response examples.

Asset Type Compatibility

The Metrics & Dividends endpoint applies primarily to stocks. Its fundamental and profitability metrics are derived from financial statement data that stocks report, but that ETFs and mutual funds, as pooled fund structures, do not. For funds, fields tied to profitability, growth, and business quality are generally returned as null.

Use Cases and Example Workflows

In practice, the metrics endpoint can serve as a useful addition to a range of workflows, both analytical and developer-built:

• On the analytical side, it can support direct comparisons between assets without requiring a broader dataset.
• On the development side, it can serve as the data source behind a dashboard component or an automated pipeline.

Let’s consider a few examples:

Sector Risk Comparison

When comparing companies within the same sector, differences in volatility and leverage are not always visible from price movement alone. Calling the Metrics & Dividends endpoint returns the full set of metrics for every ticker. Of these, beta and debt-to-equity are the two relevant to this comparison. Placed side by side, these figures can reveal whether a company carries more leverage or reacts more sharply to market shifts than its peers.

Wealth Management Dashboard

A more involved use case is building and maintaining a wealth management dashboard. Rather than opening each asset individually, the metrics endpoint can be requested for every holding in a portfolio. The response returns dividend yield, ROE, beta, and other figures together, so there is no need to source each metric separately.

Portfolio Daily Brief

The same approach can be extended into an automated portfolio brief. A scheduled process calls the metrics endpoint for each holding at a set interval and compiles changes — such as an updated 52-week price change or dividend rate. An AI model can then turn these figures into a brief that pairs a short written summary of the changes with the underlying numbers.

Across all these examples, the same principle holds: the Metrics & Dividends endpoint provides a specific, symbol-scoped set of financial data — from a single comparison to a fully automated brief — while keeping each implementation straightforward.

Within the FinImpulse API, the metrics endpoint can be combined with others to build more complete workflows and tools.