Summary Lite

Returns a focused snapshot of key identification, market, and fundamental data for a single asset symbol.

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

POST
v1/summary-lite
symbol stringrequired

Asset identifier (ticker symbol).

select_identifiers arrayoptional

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.

tag stringoptional

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.

Example Request
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

symbol string

Asset symbol (ticker).

logo string

URL of the company or fund logo image.

display_name string

Asset display name.

quote_type string

Asset class identifier (stock, etf, mutualfund).

full_time_employees integer

Number of full-time employees.

Address & Contact

city string

City.

country string

Country.

website string

Official website URL.

Sector & Industry Classification

sector string

Sector name.

industry string

Industry name.

Price Data

current_price number

Most recent traded price. May reflect a delay of up to one hour.

current_price_usd number

Most recent traded price, normalized to USD. May reflect a delay of up to one hour.

regular_market_price_usd number

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.

pre_market_price_usd number

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.

post_market_price_usd number

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.

fifty_two_week_low number

Lowest price in the last 52 weeks.

fifty_two_week_high number

Highest price in the last 52 weeks.

Dividends & Distributions

dividend_rate number

Forward annual dividend rate.

dividend_yield number

Forward dividend yield.

Market & Risk Metrics

average_volume integer

Average volume.

average_volume_10days integer

Average volume over the last 10 trading days.

market_cap number

Market capitalization.

beta number

Beta vs benchmark.

Valuation Measures - Internal Snapshot (Stocks)

valuation_measures_pe_ratio number

P/E ratio from valuation measures dataset.

valuation_measures_forward_pe_ratio number

Forward P/E ratio from valuation measures dataset.

valuation_measures_pb_ratio number

Price-to-book ratio from valuation measures dataset.

valuation_measures_ps_ratio number

Price-to-sales ratio from valuation measures dataset.

Example Response
{
    "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.