get_search_lite
Search unified results for stocks, ETFs, and mutual funds, returning core identification, current pricing, and key performance metrics. Filter, sort, and paginate to refine matches.
Instructions
Returns a unified, cross-asset search result for stocks, ETFs, and mutual funds with a focused field set covering core identification, current pricing, and key performance metrics. The response field set is fixed, but it is possible to control which fields are included through the select_identifiers parameter. For a comprehensive field set use the /v1/search endpoint.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | User-defined request identifier. | |
| limit | No | Maximum number of matched items returned. | |
| offset | No | Pagination offset (0-based). | |
| filters | No | 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 string not_contains - value does not exist in string startswith - string starts with value endswith - 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" ] | |
| sort_by | No | 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: { "selector": "amount_usd", "desc": true } | |
| symbols | No | A list of ticker symbols to retrieve. When provided, the response returns only the specified tickers. If a symbol does not exist, it is excluded from the results. | |
| quote_types | No | Controls which asset types are included in the search. If none are provided, all supported asset types are returned. | |
| search_text | No | Free-text query (e.g., “NVDA”, “NVIDIA”, partial ticker, partial name). | |
| select_identifiers | No | 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. | |
| has_public_financial_reports | No | Indicates whether the company provides public financial statements. | |
| hide_tickers_with_company_name | No | Exclude tickers with available names. true - exclude tickers with a company/fund name; false - include tickers with a company/fund name. | |
| show_tickers_without_company_name | No | Include tickers with missing names. true - include tickers even if the company/fund name is missing; false - exclude tickers without a company/fund name. |