Actualización del endpoint de búsqueda: recupera activos por array de tickers

El endpoint de búsqueda de la API de FinImpulse se ha actualizado para incluir un nuevo parámetro de petición: «symbols».

Anteriormente, recuperar los datos de un conjunto conocido de tickers requería una consulta de texto o una expresión de filtro; ninguna de las dos está diseñada para la recuperación directa basada en listas.

El parámetro “symbols” acepta un array explícito de tickers y devuelve los datos de cada activo coincidente. Amplía el conjunto existente e introduce un modo de búsqueda directa junto a los enfoques basados en texto y en filtros que el endpoint ya admite.

Cómo funciona el parámetro symbols

“symbols” es un parámetro opcional de tipo array. Cada elemento es una cadena de texto que representa un ticker (p. ej., «AAPL», «SPY», «VFIAX»).

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

Cuando se incluye “symbols” en la petición, el endpoint devuelve datos solo para los tickers especificados. La estructura de la respuesta no cambia: el mismo formato unificado multiactivo que abarca campos de precio, liquidez, rentabilidad, clasificación y fundamentales.

Ten en cuenta los siguientes comportamientos del parámetro:

• Si un ticker del array no existe, se excluye de los resultados sin generar un error. Solo se devuelven los símbolos coincidentes.
• Si no se encuentra ninguno de los símbolos especificados, el endpoint devuelve un conjunto de resultados vacío.

Cómo combinar symbols con otros parámetros

El parámetro “symbols” puede combinarse con cualquier otro parámetro opcional que admita el endpoint. Esto permite filtrar, ordenar y paginar un conjunto definido de tickers.

Sin embargo, al usar symbols como método principal de selección, asegúrate de que cualquier parámetro adicional sea coherente con los tipos de activo y los nombres de los tickers solicitados.

Los siguientes casos ilustran las restricciones de interacción entre parámetros.

search_text & symbols

Si search_text no coincide con ninguno de los tickers especificados, el conjunto de resultados estará vacío.

Por ejemplo, pasar symbols: [«AAPL», «MSFT»] junto con search_text: «fund» no devuelve ningún resultado. Cuando se establece “symbols”, solo se tienen en cuenta los tickers especificados, y ni AAPL ni MSFT coinciden con la consulta de texto «fund».

quote_types & symbols

Del mismo modo, si quote_types no incluye el tipo de activo de los tickers especificados, dichos tickers no aparecerán en la respuesta.

Pasar symbols: [«AAPL»] con quote_types: [«mutualfund»] no devuelve ningún resultado, dado que AAPL es una acción.

Para ver la lista completa de los parámetros admitidos, consulta la documentación del endpoint de búsqueda.

Ejemplo de petición

La siguiente petición recupera los datos de tres tickers concretos, ordenados por valor de mercado normalizado en USD, en orden descendente:

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

La respuesta incluirá metadatos de paginación y el array completo de elementos. Cada elemento contendrá el conjunto completo de campos disponibles: identificación, información del exchange, datos de precios, volumen, indicadores técnicos, rendimiento, dividendos y fundamentales.

Las cuentas nuevas reciben 1 USD en créditos de API al registrarse.