> For the complete documentation index, see [llms.txt](https://signalmarkets-com.gitbook.io/signalmarkets.com-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://signalmarkets-com.gitbook.io/signalmarkets.com-docs/analizador.md).

# Signal Markets — Analizador

## Qué hace

El Analizador calcula indicadores técnicos sobre instrumentos financieros del mercado argentino (acciones, CEDEARs, bonos) a partir de su historial de precios, y ofrece una opinión generada por inteligencia artificial sobre cada instrumento consultado.

Está pensado para que un banco, broker o fintech lo integre en su propia plataforma o en un canal existente (por ejemplo, un chatbot), sin necesidad de construir esa capa de análisis desde cero.

## Primeros pasos

### 1. Obtener una credencial de acceso

Todas las consultas requieren autenticarse primero. El inicio de sesión se realiza contra el servicio central:

POST <https://signal-markets-api.onrender.com/auth/login>

Con el siguiente contenido:

{ "username": "tu\_usuario", "password": "tu\_contraseña" }

La respuesta incluye un token, que debe incluirse en cada consulta posterior, en el encabezado de autorización:

Authorization: Bearer {token}

El token tiene una validez de 24 horas desde el momento en que se emite. No existe un mecanismo de renovación automática: una vez vencido, es necesario volver a iniciar sesión para obtener uno nuevo.

### 2. Realizar la primera consulta

Con el token ya obtenido, se puede consultar cualquier instrumento por su símbolo (o "ticker"). Por ejemplo, para consultar Grupo Financiero Galicia:

GET <https://signal-markets-api.onrender.com/indicators/GGAL>

La respuesta incluye el precio actual, el histórico reciente, y los indicadores técnicos calculados sobre ese instrumento.

## Qué se puede consultar

### Indicadores técnicos

* **Cruce de medias móviles**: identifica si el instrumento muestra una tendencia alcista o bajista reciente, comparando el promedio de precios de los últimos 21 y 42 días.
* **Oscilador estocástico**: mide si el instrumento está en una zona de sobrecompra o sobreventa, sobre un período de 14 días.
* **Soporte y resistencia**: niveles de precio históricamente relevantes para el instrumento, calculados sobre las últimas 90 ruedas.

Los parámetros de cálculo de cada indicador son fijos por el momento; no es posible ajustarlos por consulta. El cliente sí puede controlar cuántos días de historial se utilizan como base para el cálculo (parámetro days, con un valor por defecto de 180 días).

### Opinión con inteligencia artificial

Además de los indicadores calculados, es posible solicitar una interpretación en lenguaje natural generada por inteligencia artificial, que resume la situación técnica del instrumento. Esta es una funcionalidad con costo diferenciado dentro de cada plan.

### Integración con canales de atención (chatbots)

Para los casos en que un cliente ya cuenta con su propio canal de atención (por ejemplo, un chatbot de WhatsApp), existe un servicio pensado específicamente para eso: devuelve el análisis de un instrumento ya redactado en texto simple, listo para mostrarse tal cual, sin necesidad de interpretar ninguna estructura de datos.

GET <https://signal-markets-api.onrender.com/chatbot/analisis/{ticker}>

Este servicio admite un parámetro opcional para incluir o no la opinión de inteligencia artificial en la respuesta, según se necesite.

## Cobertura de mercados

Actualmente, el Analizador cubre instrumentos del mercado argentino (acciones, CEDEARs, bonos). La cobertura de mercados internacionales (Estados Unidos) está prevista para una próxima versión, o puede resolverse conectando el servicio a una fuente de datos que el propio cliente ya tenga contratada.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://signalmarkets-com.gitbook.io/signalmarkets.com-docs/analizador.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
