Search Endpoint Update: Retrieve Assets by Ticker Array

The search endpoint in the FinImpulse API has been updated to include a new request parameter: “symbols”.

Previously, retrieving data for a known set of tickers required either a text query or a filter expression — neither of which is designed for direct, list-based retrieval.

The “symbols” parameter accepts an explicit array of ticker symbols and returns data for each matching asset. It extends the existing set, introducing a direct lookup mode alongside the text-based and filter-based approaches already supported by the endpoint.

How the Symbols Parameter Works

“symbols” is an optional array parameter. Each element is a string representing a ticker symbol (e.g., “AAPL”, “SPY”, “VFIAX”).

"symbols": ["VTI", "VFIAX", "FXAIX"]

When “symbols” is included in the request, the endpoint returns data only for the specified tickers. The response structure remains unchanged — the same unified, cross-asset format covering price, liquidity, performance, classification, and fundamental fields.

Note the following parameter behaviors:

• If a ticker in the array does not exist, it is excluded from the results without triggering an error. Only matched symbols are returned.
• If none of the specified symbols are found, the endpoint returns an empty result set.

Combining Symbols with Other Parameters

The “symbols” parameter can be combined with any other optional parameters supported by the endpoint. This enables filtering, sorting, and pagination for a defined set of tickers.

However, when using symbols as the primary selection method, ensure that any additional parameters are consistent with the asset types and names of the requested tickers.

The following cases illustrate parameter interaction constraints.

search_text & symbols

If search_text does not match any of the specified tickers, the result set will be empty.

For example, passing symbols: [“AAPL”, “MSFT”] alongside search_text: “fund” returns no results. When “symbols” is set, only the specified tickers are considered, and neither AAPL nor MSFT matches the text query “fund”.

quote_types & symbols

Similarly, if quote_types does not include the asset type of the specified tickers, those tickers will not appear in the response.

Passing symbols: [“AAPL”] with quote_types: [“mutualfund”] returns no results, since AAPL is a stock.

For the full list of supported parameters, see the search endpoint documentation.

Request Example

The following request retrieves data for three specific tickers, sorted by USD-normalized market value in descending order:

{
    "symbols": ["VTI", "VFIAX", "FXAIX"],
    "offset": 0,
    "limit": 10,
    "sort_by": [
        {
            "selector": "amount_usd",
            "desc": true
        }
    ]
}

The response will include pagination metadata and the full item array. Each item will contain the complete set of available fields: identification, exchange info, price data, volume, technical indicators, performance, dividends, and fundamentals.

New accounts receive $1 in API credits upon registration.