This endpoint powers global asset search, ticker autocomplete, discovery flows, and AI-assisted search scenarios. It returns a normalized set of price, liquidity, performance, and classification fields, allowing different asset types to be ranked and compared in a single response.
When to Use This Endpoint
- Search across stocks, ETFs, and mutual funds in one request.
- Rank assets by size, liquidity, or market relevance.
- Display comparable results across asset types and currencies.
Request Parameters
v1/search
Free-text query (e.g., “NVDA”, “NVIDIA”, partial ticker, partial name).
Controls which asset types are included in the search.
Available types:
stocketfmutualfund
All three parameters are of type string and are optional. If none are provided, all supported asset types are returned.
Example:
"quote_types": ["mutualfund","etf","stock"]A list of ticker symbols to retrieve.
When provided, the response returns only the specified tickers.
Important notes:
- If a symbol does not exist, it is excluded from the results.
- Returns an empty result set if none of the specified symbols are found.
Example:
"symbols": ["NVDA", "SPY", "AAPL"]Pagination offset (0-based).
Maximum number of matched items returned (user-defined).
Optional filter expressions.
Each filter condition is defined as: [field, operator, value]. Conditions can be combined using logical operators and/or.
Supported operators:
Numeric fields:
>- greater than>=- greater than or equal<- less than<=- less than or equal=- equals<>- not equal
String fields:
like– pattern match (requires%as a wildcard)not_like- pattern does not match (requires%as a wildcard)contains- value exists in stringnot_contains- value does not exist in stringstartswith- string starts with valueendswith- string ends with value
% usage examples:
%abc%- matches any string containing "abc"abc%- matches any string starting with "abc"%abc- matches any string ending with "abc"
Example:
"filters": [
"short_name", "contains", "Market"
]Optional sorting configuration for result items. Each sorting setup is defined as [selector, desc]:
selector- Metric used for sorting (e.g., amount_usd).desc- Sorting direction (true for descending, false for ascending).
Sortings can be combined using ,.
Example:
"sort_by": [
{
"selector": "amount_usd",
"desc": true
}
]Indicates whether the company provides public financial statements.
true- the company has public financial reports availablefalse- the company does not have public financial reports
Include tickers with missing names.
true- include tickers even if the company/fund name is missingfalse- exclude tickers without a company/fund name
This parameter determines the filtering logic in the dashboard for tickers with or without company/fund names.
Exclude tickers with available names.
true- exclude tickers with a company/fund namefalse- include tickers with a company/fund name
This parameter determines the filtering logic in the dashboard for tickers with or without company/fund names.
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/search" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <API_TOKEN>" \
-d '{
"search_text": "fund",
"offset": 0,
"limit": 10,
"has_public_financial_reports": true,
"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/search";
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "<API_TOKEN>");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var json = @"{
""search_text"": ""fund"",
""offset"": 0,
""limit"": 10,
""has_public_financial_reports"": true,
""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/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Authorization: Bearer <API_TOKEN>"
],
CURLOPT_POSTFIELDS => json_encode(
[
"search_text" => "fund",
"offset" => 0,
"limit" => 10,
"has_public_financial_reports" => true,
"tag" => "just tag"
]
)
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;import urllib.request
import json
url = "https://api.finimpulse.com/v1/search"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer <API_TOKEN>"
}
data = {
"search_text": "fund",
"offset": 0,
"limit": 10,
"has_public_financial_reports": True,
"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({
"search_text": "fund",
"offset": 0,
"limit": 10,
"has_public_financial_reports": true,
"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/search', 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 contains pagination metadata and a list of matched assets.
Pagination Fields
Total number of matching assets.
Token for pagination. Pass it in the next request to fetch the next page.
Format:
"search_after_token": "token_here"Number of items returned.
An array, where each item represents a single exchange-listed instrument.
The same underlying company or fund can appear multiple times if it trades on numerous exchanges or currencies.
Identification Fields
Asset identifier (ticker symbol).
Preferred display name (if available).
Short descriptive name.
Full legal or formal name (company/fund).
Asset class identifier (stock, etf, mutualfund).
Data source label for the quote (e.g., real-time vs delayed).
Trading & Exchange Info
Trading currency.
Exchange name.
Exchange code.
Exchange time zone name.
Exchange time zone abbreviation.
Exchange time offset in seconds.
Market/country code.
Asset Fundamentals
Sector classification (stocks and some ETFs).
Industry classification.
Company founding date (stocks) or reference date (if available).
Fund inception date (ETFs and mutual funds).
Price Data
Latest traded price in local currency.
USD-normalized price.
Absolute price change in local currency.
Absolute price change normalized to USD (if available).
Percentage price change.
Time of the last trade that set the current market price.
Volume & Liquidity
Latest trading volume.
3-month average trading volume.
10-day average trading volume.
Technical Indicators
50-day moving average.
Difference between current price and 50-day average.
Percent difference vs 50-day average.
200-day moving average.
Difference between current price and 200-day average.
Percent difference vs 200-day average.
Lowest price in the last 52 weeks.
Highest price in the previous 52 weeks.
Change from the 52-week low.
Percent change from the 52-week low.
Change from the 52-week high.
Percent change from the 52-week high.
Returns & Performance
Total return over the past year (if available).
Total return over the past three years (if available).
Dividends & Yield
Forward dividend rate.
Forward dividend rate normalized to USD.
Forward dividend yield.
Trailing 12-month dividend rate.
Trailing 12-month dividend rate normalized to USD.
Trailing 12-month dividend yield.
Market Value & Normalization
Market value or net assets in local currency.
USD-normalized market value or net assets (standard global ranking key).
FX rate used for USD normalization.
Profitability & Margins
Free cash flow margin (FCF Margin).
Net Margin.
Return on Equity (ROE).
Return on Invested Capital (ROIC).
Growth & Risk
Revenue growth.
EPS (Earnings Per Share) growth.
Revenue stability.
Beta.
Debt-to-Equity (D/E).
Metadata
Date and time of the last data update.
{
"task_id": "2221825c-d28a-4749-b872-997ba5885317",
"status_code": 20000,
"status_message": "OK",
"cost": 0.0024,
"data": {
"limit": 10,
"offset": 0,
"filters": [
"short_name",
"contains",
"Market"
],
"search_text": "fund",
"has_public_financial_reports": true,
"sort_by": [
{
"selector": "amount_usd",
"desc": true
}
],
"quote_types": [
"mutualfund",
"etf",
"stock"
]
},
"result": {
"total_count": 2,
"search_after_token": null,
"items_count": 2,
"items": [
{
"symbol": "EMF",
"display_name": null,
"short_name": "Templeton Emerging Markets Fund",
"long_name": "Templeton Emerging Markets Fund",
"quote_type": "stock",
"quote_source_name": "Delayed Quote",
"fifty_day_average": 19.1,
"fifty_day_average_change": 1.3099995,
"fifty_day_average_change_percent": 6.858636,
"two_hundred_day_average": 17.38435,
"two_hundred_day_average_change": 3.02565,
"two_hundred_day_average_change_percent": 17.404447,
"average_daily_volume_3_month": 57264,
"average_daily_volume_10_day": 29320,
"one_year_return": 61.089,
"three_year_return": 82.232,
"currency": "USD",
"regular_market_price": 20.4929,
"regular_market_price_usd": 20.4929,
"regular_market_change": 0.469999,
"regular_market_change_usd": 0.469999,
"regular_market_change_percent": 2.35707,
"regular_market_time": "2026-04-24T20:00:02Z",
"regular_market_volume": 2986,
"full_exchange_name": "NYSE",
"exchange": "NYQ",
"exchange_timezone_name": "America/New_York",
"exchange_timezone_short_name": "EDT",
"fifty_two_week_low_change": 7.83,
"fifty_two_week_low_change_percent": 62.241656,
"fifty_two_week_high_change": -0.7900009,
"fifty_two_week_high_change_percent": -3.7264194,
"fifty_two_week_low": 12.58,
"fifty_two_week_high": 21.2,
"trailing_annual_dividend_rate": 0.951,
"trailing_annual_dividend_rate_usd": 0.951,
"trailing_annual_dividend_yield": 4.7693077,
"dividend_rate": 0.88,
"dividend_rate_usd": 0.88,
"dividend_yield": 4.31,
"time_offset": -14400,
"market_region": "US",
"sector": "Financial Services",
"industry": "Asset Management",
"amount": 306325760,
"amount_usd": 306325760,
"update_time": "2026-04-27T14:30:33Z",
"usd_rate": null,
"beta": 0.881,
"founded_date": "1987-02-26T14:30:00Z",
"fund_inception_date": null,
"free_cash_flow_margin": 0,
"return_on_invested_capital": 0,
"net_margin": 0.98784344,
"return_on_equity": 0.12201155,
"debt_to_equity": 0.02138823,
"revenue_stability": 19.630419036973684,
"revenue_growth": -0.13503351116579054,
"eps_growth": -0.12340174990961983
},
{
"symbol": "EDF",
"display_name": null,
"short_name": "Stone Harbor Emerging Markets I",
"long_name": "Virtus Stone Harbor Emerging Markets Income Fund",
"quote_type": "stock",
"quote_source_name": "Delayed Quote",
"fifty_day_average": 5.0758,
"fifty_day_average_change": 0.02419996,
"fifty_day_average_change_percent": 0.4767714,
"two_hundred_day_average": 5.0143,
"two_hundred_day_average_change": 0.08570003,
"two_hundred_day_average_change_percent": 1.7091127,
"average_daily_volume_3_month": 242841,
"average_daily_volume_10_day": 141400,
"one_year_return": 3.659,
"three_year_return": 16.972,
"currency": "USD",
"regular_market_price": 5.1,
"regular_market_price_usd": 5.1,
"regular_market_change": -0.02,
"regular_market_change_usd": -0.02,
"regular_market_change_percent": -0.390625,
"regular_market_time": "2026-04-24T20:00:06Z",
"regular_market_volume": 70775,
"full_exchange_name": "NYSE",
"exchange": "NYQ",
"exchange_timezone_name": "America/New_York",
"exchange_timezone_short_name": "EDT",
"fifty_two_week_low_change": 0.3800001,
"fifty_two_week_low_change_percent": 8.05085,
"fifty_two_week_high_change": -0.24000025,
"fifty_two_week_high_change_percent": -4.4943865,
"fifty_two_week_low": 4.72,
"fifty_two_week_high": 5.34,
"trailing_annual_dividend_rate": 0,
"trailing_annual_dividend_rate_usd": 0,
"trailing_annual_dividend_yield": 0,
"dividend_rate": 0.72,
"dividend_rate_usd": 0.72,
"dividend_yield": 14.12,
"time_offset": -14400,
"market_region": "US",
"sector": "Financial Services",
"industry": "Asset Management",
"amount": 163784912,
"amount_usd": 163784912,
"update_time": "2026-04-27T14:30:34Z",
"usd_rate": null,
"beta": null,
"founded_date": "2010-12-27T14:30:00Z",
"fund_inception_date": null,
"free_cash_flow_margin": -0.68015338,
"return_on_invested_capital": 0,
"net_margin": 0.98571816,
"return_on_equity": 0.16813101,
"debt_to_equity": 0.25520935,
"revenue_stability": 3.4229035783771558,
"revenue_growth": 1.0827617564272258,
"eps_growth": 0.36564783932340417
}
]
}
}Notes
- USD-normalized fields enable consistent cross-market sorting and ranking across all markets.
- Some fields may be null depending on asset type and data coverage. It does not indicate an error; it reflects asset-specific applicability.
All metric names, field definitions, and calculation details are defined in the Glossary.