This endpoint acts as a unified statistics snapshot, combining price data, valuation metrics, dividends, risk indicators, and trailing performance where applicable.
Asset Type Compatibility
The set of returned statistics varies by asset class:
- Stocks: Returns a complete set of company-level statistics, including price data, valuation metrics, dividends, financial ratios, ownership data, and analyst information.
- ETFs: Returns fund-level statistics, including price data, category classification, trailing performance, and distribution metrics. Company-level financial statements and analyst forecasts are not applicable.
- Mutual funds: Returns fund-level statistics and performance indicators, including trailing returns, category-relative metrics, rankings, and load-adjusted returns. Company-specific financial data is not applicable.
When to Use This Endpoint
- Retrieve a single, normalized statistics snapshot for an asset.
- Populate asset Summary and Statistics views.
- Compare trailing performance against category benchmarks.
- Access valuation, dividend, and risk-related indicators in one request
Request Parameters
v1/statistics/general
Asset identifier (ticker symbol).
User-defined identifier for the task (max 255 characters).
It is returned in the response data object, allowing you to match results with the corresponding request. It does not affect API processing or filtering logic.
curl --location "https://api.finimpulse.com/v1/statistics/general" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <API_TOKEN>" \
-d '{
"symbol": "NVDA",
"tag": "just tag"
}'using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
var client = new HttpClient();
var url = "https://api.finimpulse.com/v1/statistics/general";
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "<API_TOKEN>");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var json = @"{
""symbol"": ""NVDA"",
""tag"": ""just tag""
}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.finimpulse.com/v1/statistics/general",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer <API_TOKEN>"
],
CURLOPT_POSTFIELDS => json_encode(
[
"symbol" => "NVDA",
"tag" => "just tag"
]
)
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;import urllib.request
import json
url = "https://api.finimpulse.com/v1/statistics/general"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer <API_TOKEN>"
}
data = {
"symbol": "NVDA",
"tag": "just tag"
}
req = urllib.request.Request(url,
data=json.dumps(data).encode("utf-8"),
headers=headers,
method="POST")
with urllib.request.urlopen(req) as response:
result = json.loads(response.read().decode("utf-8"))
print(result)const https = require('https');
const data = JSON.stringify({
"symbol": "NVDA",
"tag": "just tag"
});
const options = {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer <API_TOKEN>',
'Content-Length': Buffer.byteLength(data)
}
};
const req = https.request('https://api.finimpulse.com/v1/statistics/general', options, (res) => {
let body = '';
res.on('data', chunk => body += chunk);
res.on('end', () => console.log(JSON.stringify(JSON.parse(body), null, 2)));
});
req.on('error', (e) => console.error(e));
req.write(data);
req.end();Response
The response is an array containing a single statistics object for the requested asset.
General Information
Asset symbol.
Asset type (stock, ETF, mutual fund).
Trading currency.
Last data update timestamp.
Price precision hint.
Price and Market Data
Real-time and reference price information.
Current market price.
Previous closing price.
Opening price.
Intraday low price.
Intraday high price.
Regular market previous close.
Regular market opening price.
Regular market intraday low.
Regular market intraday high.
52-week low price.
52-week high price.
Asset 52-week price change.
S&P 500 52-week price change.
All-time low price.
All-time high price.
50-day moving average.
200-day moving average.
Trading Volume and Liquidity
Trading activity and order book indicators.
Current trading volume.
Regular market trading volume.
Average daily trading volume.
10-day average trading volume.
Average daily volume (last 10 days).
Best bid price.
Best ask price.
Bid size.
Ask size.
Dividends
Cash distribution metrics and dividend history indicators.
Annual dividend rate.
Dividend yield.
Ex-dividend date.
Dividend payout ratio.
Trailing annual dividend rate.
Trailing annual dividend yield.
Five-year average dividend yield.
Last dividend amount.
Last dividend payment date.
Valuation and Ratios
High-level valuation indicators and market ratios.
Market capitalization.
Enterprise value.
Trailing price-to-earnings ratio.
Forward price-to-earnings ratio.
Price-to-book ratio.
Price-to-sales ratio (TTM).
Enterprise value to revenue ratio.
Enterprise value to EBITDA ratio.
Beta (market sensitivity).
Book value per share.
Net profit margin.
Forward earnings per share.
Trailing earnings per share.
Ownership and Trading Metrics (Stocks)
Equity-specific ownership and short-interest indicators.
Shares outstanding.
Public float shares.
Shares sold short.
Short interest (previous month).
Short interest reference date.
Short interest as % of shares outstanding.
Short interest ratio (days to cover).
Short interest as % of float.
Insider ownership percentage.
Institutional ownership percentage.
Short interest reporting date.
Implied shares outstanding.
Financial Performance (Stocks)
Fundamental company performance and profitability metrics.
Total revenue.
Revenue per share.
Revenue growth rate.
Net income to common shareholders.
Earnings growth rate.
Quarterly earnings growth (YoY).
Gross profit.
Gross margin.
Operating margin.
EBITDA margin.
EBITDA.
Free cash flow.
Operating cash flow.
Return on assets.
Return on equity.
Last fiscal year end date.
Next fiscal year end date.
Most recent reported fiscal quarter.
Balance Sheet and Liquidity (Stocks)
Total cash.
Cash per share.
Total debt.
Debt-to-equity ratio.
Current ratio.
Quick ratio.
Trailing Performance (Funds and ETFs)
Historical performance over standardized trailing horizons.
Year-to-date return.
1-month trailing return.
3-month trailing return.
1-year trailing return.
3-year trailing return.
5-year trailing return.
10-year trailing return.
Return during the last bull market.
Return during the last bear market.
Category-Relative Performance (Funds and ETFs)
Performance compared to peer category benchmarks.
Category YTD return.
Category 1-month return.
Category 3-month return.
Category 1-year return.
Category 3-year return.
Category 5-year return.
Category 10-year return.
Category return during the last bull market.
Category return during the last bear market.
Load-Adjusted Returns and Rankings (Mutual Funds)
Mutual fund–specific performance adjustments and rankings.
Load-adjusted 1-year return.
Load-adjusted 3-year return.
Load-adjusted 5-year return.
Load-adjusted 10-year return.
Category rank (YTD).
Category rank (1 month).
Category rank (3 months).
Category rank (1 year).
Category rank (3 years).
Category rank (5 years).
Number of positive-return years.
Number of negative-return years.
Best single-year total return.
Risk Indicators
Governance and risk-related scores.
Audit risk score.
Board governance risk score.
Executive compensation risk score.
Shareholder rights risk score.
Overall governance risk score.
Asset Classification (Funds and ETFs)
Asset category.
Fund family.
Legal structure.
Analyst Data and Corporate Actions (Stocks)
Last stock split ratio.
Last stock split date.
Analyst target high price.
Analyst target low price.
Analyst target mean price.
Analyst target median price.
Analyst recommendation score.
Analyst consensus recommendation.
Number of analyst opinions.
{
"task_id": "2df55d35-1f96-4ecc-b1d7-bb1133b3a7a7",
"status_code": 20000,
"status_message": "OK",
"cost": 0.0015,
"data": {
"symbol": "NVDA",
"tag": "just tag"
},
"result": [
{
"symbol": "NVDA",
"quote_type": "stock",
"currency": "USD",
"audit_risk": 5,
"board_risk": 9,
"compensation_risk": 4,
"share_holder_rights_risk": 8,
"overall_risk": 8,
"previous_close": 191.13,
"open": 187.2,
"day_low": 184.88,
"day_high": 190.3,
"regular_market_previous_close": 191.13,
"regular_market_open": 187.2,
"regular_market_day_low": 184.88,
"regular_market_day_high": 190.3,
"dividend_rate": 0.04,
"dividend_yield": 0.0002,
"ex_dividend_date": "2025-12-04T00:00:00Z",
"payout_ratio": 0.0099,
"five_year_avg_dividend_yield": 0.05,
"trailing_pe": 45.829628,
"volume": 160114156,
"regular_market_volume": 160114156,
"average_volume": 181422162,
"average_volume_10days": 163937740,
"average_daily_volume_10_day": 163937740,
"bid": 185.52,
"ask": 185.67,
"bid_size": 500,
"ask_size": 400,
"market_cap": 4519046938624,
"fifty_two_week_low": 86.62,
"fifty_two_week_high": 212.19,
"all_time_high": 212.19,
"all_time_low": 0.033333,
"price_to_sales_trailing_12_months": 24.14769,
"fifty_day_average": 183.9022,
"two_hundred_day_average": 168.1236,
"trailing_annual_dividend_rate": 0.04,
"trailing_annual_dividend_yield": 0.00020928,
"price_hint": 2,
"enterprise_value": 4460536922112,
"forward_pe": 24.218866,
"profit_margins": 0.53007,
"float_shares": 23330673000,
"shares_outstanding": 24305000000,
"shares_short": 261838673,
"shares_short_prior_month": 264294883,
"shares_short_previous_month_date": "2025-12-15T00:00:00Z",
"date_short_interest": "2026-01-15T00:00:00Z",
"shares_percent_shares_out": 0.0108,
"held_percent_insiders": 0.0433,
"held_percent_institutions": 0.69654,
"short_ratio": 1.64,
"short_percent_of_float": 0.0112,
"beta": 2.314,
"implied_shares_outstanding": 24347000000,
"category": null,
"book_value": 4.892,
"price_to_book": 37.941536,
"fund_family": null,
"legal_type": null,
"last_fiscal_year_end": "2025-01-26T00:00:00Z",
"next_fiscal_year_end": "2026-01-26T00:00:00Z",
"most_recent_quarter": "2025-10-26T00:00:00Z",
"earnings_quarterly_growth": 0.653,
"net_income_to_common": 99198001152,
"trailing_eps": 4.05,
"forward_eps": 7.66386,
"last_split_factor": "10:1",
"last_split_date": "2024-06-10T00:00:00Z",
"enterprise_to_revenue": 23.835,
"enterprise_to_ebitda": 39.58,
"fifty_two_week_change": 0.56434894,
"sand_p_fifty_two_week_change": 0.15544534,
"last_dividend_value": 0.01,
"last_dividend_date": "2025-12-04T00:00:00Z",
"current_price": 185.61,
"target_high_price": 352,
"target_low_price": 140,
"target_mean_price": 253.62138,
"target_median_price": 250,
"recommendation_mean": 1.34375,
"recommendation_key": "strong_buy",
"number_of_analyst_opinions": 58,
"total_cash": 60608000000,
"total_cash_per_share": 2.494,
"ebitda": 112696000512,
"total_debt": 10821999616,
"quick_ratio": 3.605,
"current_ratio": 4.468,
"total_revenue": 187141996544,
"debt_to_equity": 9.102,
"revenue_per_share": 7.668,
"return_on_assets": 0.53528,
"return_on_equity": 1.07359,
"gross_profits": 131092996096,
"free_cashflow": 53282873344,
"operating_cashflow": 83158999040,
"earnings_growth": 0.667,
"revenue_growth": 0.625,
"gross_margins": 0.7005,
"ebitda_margins": 0.60220003,
"operating_margins": 0.63168997,
"update_time": "2026-02-03T14:02:10Z",
"trailing_ytd": null,
"trailing_one_month": null,
"trailing_three_month": null,
"trailing_one_year": null,
"trailing_three_year": null,
"trailing_five_year": null,
"trailing_ten_year": null,
"trailing_last_bull_mkt": null,
"trailing_last_bear_mkt": null,
"trailing_category_ytd": null,
"trailing_category_one_month": null,
"trailing_category_three_month": null,
"trailing_category_one_year": null,
"trailing_category_three_year": null,
"trailing_category_five_year": null,
"trailing_category_ten_year": null,
"trailing_category_last_bull_mkt": null,
"trailing_category_last_bear_mkt": null,
"load_adjusted_one_year": null,
"load_adjusted_three_year": null,
"load_adjusted_five_year": null,
"load_adjusted_ten_year": null,
"rank_ytd": null,
"rank_one_month": null,
"rank_three_month": null,
"rank_one_year": null,
"rank_three_year": null,
"rank_five_year": null,
"num_years_up": null,
"num_years_down": null,
"best_one_yr_total_return": null
}
]
}Notes
- Fields that are not relevant for a given asset type are returned as null.
- Complete definitions, formulas, and calculation methodology for all fields are available in the Glossary.