This endpoint retrieves core identification, current pricing, key valuation metrics, and fundamental data for a single asset symbol.
The response field set is fixed, but it is possible to control which fields are included in the response through the select_identifiers parameter. This reduces response size and is useful when only a subset of data is needed.
For a comprehensive field set that includes financial highlights, analyst coverage, ownership data, fund performance, and more, use /v1/summary endpoint.
Asset Type Compatibility
This endpoint uses a unified schema across stocks, ETFs, and mutual funds. Fields that are not relevant for a given asset type are returned as null (or empty strings in some legacy feed cases).
- Stocks: Returns company identification, price data, valuation multiples, dividends, volume, market cap, and beta.
- ETFs: Returns fund identification, price data, volume, and market cap. Valuation multiples and company-specific fields are generally not applicable.
- Mutual funds: Returns fund identification and price data. Most market and valuation fields are generally not applicable.
When to Use This Endpoint
- Retrieve key identification, pricing, and fundamental data for a single asset symbol.
- Populate asset detail views, widgets, or dashboards where only core metrics are needed.
- Retrieve only the fields required for a specific use case by specifying them through the select_identifiers parameter.
Request Parameters
v1/summary-lite
Asset identifier (ticker symbol).
A list of field names to include in the response.
- When provided, each item in the response contains only the specified fields.
- When not provided or set to null, the full field set is returned.
symbol and logo are always returned regardless of the value passed.
For the list of available field names, see the Response section below.
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/summary-lite" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <API_TOKEN>" \
-d '{
"symbol": "NVDA",
"select_identifiers": [
"display_name",
"quote_type"
],
"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/summary-lite";
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "<API_TOKEN>");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var json = @"{
""symbol"": ""NVDA"",
""select_identifiers"": [
""display_name"",
""quote_type""
],
""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/summary-lite",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer <API_TOKEN>"
],
CURLOPT_POSTFIELDS => json_encode(
[
"symbol" => "NVDA",
"select_identifiers" => [
"display_name",
"quote_type"
],
"tag" => "just tag"
]
)
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import urllib.request
import json
url = "https://api.finimpulse.com/v1/summary-lite"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer <API_TOKEN>"
}
data = {
"symbol": "NVDA",
"select_identifiers": [
"display_name",
"quote_type"
],
"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",
"select_identifiers": [
"display_name",
"quote_type"
],
"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/summary-lite', 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 returns a single summary object for the requested symbol.
Note that the returned fields depend on whether select_identifiers is provided and which fields are specified. All available fields are listed below.
Identity & Classification
Asset symbol (ticker).
URL of the company or fund logo image.
Asset display name.
Asset class identifier (stock, etf, mutualfund).
Number of full-time employees.
Address & Contact
City.
Country.
Official website URL.
Sector & Industry Classification
Sector name.
Industry name.
Price Data
Most recent traded price. May reflect a delay of up to one hour.
Most recent traded price, normalized to USD. May reflect a delay of up to one hour.
Active price during the regular trading session and at market close, normalized to USD.
For US-listed assets, returns the closing price during pre-market and post-market hours.
Active price during the pre-market session, normalized to USD.
Outside pre-market hours, returns the last traded pre-market price. Returns null if no pre-market data is available.
Active price during the post-market session, normalized to USD.
Outside post-market hours, returns the last traded post-market price. Returns null if no post-market data is available.
Lowest price in the last 52 weeks.
Highest price in the last 52 weeks.
Dividends & Distributions
Forward annual dividend rate.
Forward dividend yield.
Market & Risk Metrics
Average volume.
Average volume over the last 10 trading days.
Market capitalization.
Beta vs benchmark.
Valuation Measures - Internal Snapshot (Stocks)
P/E ratio from valuation measures dataset.
Forward P/E ratio from valuation measures dataset.
Price-to-book ratio from valuation measures dataset.
Price-to-sales ratio from valuation measures dataset.
{
"task_id": "06181819-0022-0057-0000-530898c9b9da",
"status_code": 20000,
"status_message": "OK",
"live": true,
"cost": 0.0002,
"data": {
"symbol": "NVDA",
"tag": "just tag",
"select_identifiers": [
"symbol",
"display_name",
"quote_type",
"city",
"country",
"website",
"industry",
"sector",
"full_time_employees",
"dividend_rate",
"dividend_yield",
"average_volume",
"average_volume_10days",
"market_cap",
"fifty_two_week_low",
"fifty_two_week_high",
"beta",
"current_price",
"current_price_usd"
]
},
"result": {
"symbol": "NVDA",
"display_name": "NVIDIA",
"quote_type": "equity",
"logo": "https://cdn.finimpulse.com/f77c41e6-f5cd-653b-1d73-b179528f1095",
"sector": "Technology",
"industry": "Semiconductors",
"country": "United States",
"city": "Santa Clara",
"website": "https://www.nvidia.com",
"full_time_employees": 42000,
"current_price": 209.7321,
"current_price_usd": 209.7321,
"fifty_two_week_low": 140.85,
"fifty_two_week_high": 236.54,
"dividend_rate": 1,
"dividend_yield": 0.0049,
"average_volume": 166129995,
"average_volume_10days": 188416280,
"market_cap": 5023677808640,
"beta": 2.202
}
}Notes
- Percent-like fields are returned as fractions (e.g., 0.02 = 2%).
- Some fields may be null depending on asset type and data coverage. It does not indicate an error; it reflects asset-specific applicability.
