@infosel-sdk/markets 1.2.3 → 2.0.0

package/README.md

@@ -1,15 +1,14 @@
 # @infosel-sdk/markets
 
-SDK de Mercados Financieros para la plataforma Infosel. Proporciona herramientas completas para acceder a datos de mercado, gestionar instrumentos, crear widgets y manejar espacios de trabajo para aplicaciones financieras.
+SDK de Mercados Financieros para la plataforma Infosel. Proporciona herramientas completas para acceder a datos de mercado, buscar instrumentos y obtener detalles financieros para aplicaciones financieras.
 
 ## 🚀 Características
 
 - **Acceso a Datos de Mercado**: Datos de mercado en tiempo real e históricos
-- **Gestión de Instrumentos**: Buscar, crear y gestionar instrumentos financieros
-- **Sistema de Widgets**: Crear y gestionar widgets financieros personalizables
-- **Gestión de Espacios de Trabajo**: Organizar y gestionar espacios de trabajo de usuarios
+- **Búsqueda de Instrumentos**: Buscar instrumentos financieros con filtros avanzados
 - **Datos de Gráficos**: Acceder a datos de gráficos con múltiples marcos de tiempo
 - **Reportes Financieros**: Acceder a datos financieros e informes de instrumentos
+- **Detalles de Instrumentos**: Obtener perfiles y datos financieros detallados de instrumentos
 
 ## 📦 Instalación
 
@@ -84,8 +83,6 @@ const sdkManager = InfoselSdkManager.initWithConfiguration({
 const marketsSDK = InfoselMarkets.init({ sdkManager });
 ```
 
-
-
 ## 🔍 Validación de Configuración
 
 La nueva API incluye validaciones robustas:
@@ -141,44 +138,17 @@ const filteredResults = await marketsSDK.searchInstruments({
 console.log('Instrumentos encontrados:', searchResults);
 ```
 
-#### Obtener Lista de Instrumentos
-
-```typescript
-const instruments = await marketsSDK.getInstruments({
-  // Parámetros de paginación y filtros
-  limit: 50,
-  offset: 0,
-});
-
-console.log('Total de instrumentos:', instruments.total);
-console.log('Instrumentos:', instruments.instruments);
-```
-
-#### Crear Instrumento Personalizado
+#### Obtener Campos del Instrumento
 
 ```typescript
-const newInstrument = await marketsSDK.createInstrument({
-  symbol: 'CUSTOM_STOCK',
-  uniqueKey: 'CUSTOM_001',
-  widgetId: 'widget-123',
-  // Otros campos del instrumento
+const fields = await marketsSDK.getInstrumentFields({
+  instrumentKey: '1/12576/0/AC*/AAPL',
+  useCache: true, // Opcional
 });
 
-console.log('Instrumento creado:', newInstrument);
-```
-
-#### Eliminar Instrumento
-
-```typescript
-const result = await marketsSDK.deleteInstrument('instrument-id-123');
-console.log('Resultado:', result); // Mensaje de confirmación
-```
-
-#### Obtener Campos del Instrumento
-
-```typescript
-const fields = await marketsSDK.getInstrumentFields('instrument-id-123');
-console.log('Campos disponibles:', fields);
+console.log('Campos del instrumento:', fields);
+console.log('Precio actual:', fields.precioActual);
+console.log('Variación:', fields.variacion);
 ```
 
 ### 📊 Detalles Financieros de Instrumentos
@@ -187,7 +157,7 @@ console.log('Campos disponibles:', fields);
 
 ```typescript
 const profile = await marketsSDK.getInstrumentDetailProfile({
-  instrumentId: 'AAPL_US',
+  instrumentKey: '1/12576/0/AC*/AAPL',
 });
 
 console.log('Perfil del instrumento:', profile);
@@ -197,8 +167,9 @@ console.log('Perfil del instrumento:', profile);
 
 ```typescript
 const quarterlyData = await marketsSDK.getInstrumentDetailFinancialQuartely({
-  instrumentId: 'AAPL_US',
-  period: 'QUARTERLY',
+  instrumentKey: '1/12576/0/AC*/AAPL',
+  exercise: '2023',
+  period: 4, // Q4
 });
 
 console.log('Datos trimestrales:', quarterlyData);
@@ -208,8 +179,9 @@ console.log('Datos trimestrales:', quarterlyData);
 
 ```typescript
 const annualData = await marketsSDK.getInstrumentDetailFinancialAnnual({
-  instrumentId: 'AAPL_US',
-  period: 'ANNUAL',
+  instrumentKey: '1/12576/0/AC*/AAPL',
+  exercise: '2023',
+  fields: 'revenue,profit,assets', // Opcional: campos específicos
 });
 
 console.log('Datos anuales:', annualData);
@@ -219,8 +191,9 @@ console.log('Datos anuales:', annualData);
 
 ```typescript
 const financialReasons = await marketsSDK.getInstrumentDetailFinancialReasons({
-  instrumentId: 'AAPL_US',
-  period: 'QUARTERLY',
+  instrumentKey: '1/12576/0/AC*/AAPL',
+  exercise: '2023',
+  period: 'Q4',
 });
 
 console.log('Razones financieras:', financialReasons);
@@ -230,171 +203,13 @@ console.log('Razones financieras:', financialReasons);
 
 ```typescript
 const reportReasons = await marketsSDK.getInstrumentReportFinancialReasons({
-  instrumentId: 'AAPL_US',
-  period: 'QUARTERLY',
+  instrumentKey: '1/12576/0/AC*/AAPL',
+  exercises: '2023,2022', // Opcional: múltiples ejercicios
 });
 
 console.log('Reporte con razones:', reportReasons);
 ```
 
-### 🎯 Gestión de Widgets
-
-#### Crear Widget
-
-```typescript
-// Widget de gráfico
-const chartWidget = await marketsSDK.createWidget({
-  workspaceId: 'workspace-123',
-  type: 'CHART',
-  name: 'Gráfico de AAPL',
-  instruments: [
-    {
-      uniqueKey: 'AAPL_US',
-      symbol: 'AAPL',
-    },
-  ],
-});
-
-// Widget de tabla
-const tableWidget = await marketsSDK.createWidget({
-  workspaceId: 'workspace-123',
-  type: 'DYNAMIC_TABLE',
-  name: 'Tabla de Precios',
-  instruments: [
-    {
-      uniqueKey: 'AAPL_US',
-      symbol: 'AAPL',
-    },
-    {
-      uniqueKey: 'MSFT_US',
-      symbol: 'MSFT',
-    },
-  ],
-});
-
-console.log('Widget creado:', chartWidget);
-```
-
-#### Tipos de Widgets Disponibles
-
-```typescript
-// Tipos soportados:
-// - 'DYNAMIC_TABLE': Tabla dinámica
-// - 'PREDEFINED_TABLE': Tabla predefinida
-// - 'CUSTOM_TABLE': Tabla personalizada
-// - 'NEWS_LIST': Lista de noticias
-// - 'TICKER_TAPE': Cinta de ticker
-// - 'CHART': Gráfico
-// - 'UNKNOWN': Tipo desconocido
-```
-
-#### Actualizar Instrumentos del Widget
-
-```typescript
-const updatedInstruments = await marketsSDK.updateWidgetInstruments({
-  widgetId: 'widget-123',
-  instruments: {
-    keys: ['AAPL_US', 'MSFT_US', 'GOOGL_US'],
-  },
-});
-
-console.log('Instrumentos actualizados:', updatedInstruments);
-```
-
-#### Eliminar Widget
-
-```typescript
-const result = await marketsSDK.deleteWidget('widget-123');
-console.log('Resultado:', result);
-```
-
-#### Obtener Widgets del Proyecto
-
-```typescript
-const projectWidgets = await marketsSDK.getProjectWidgets({
-  projectId: 'project-123',
-});
-
-console.log('Widgets del proyecto:', projectWidgets);
-```
-
-### 🏢 Gestión de Espacios de Trabajo
-
-#### Crear Espacio de Trabajo
-
-```typescript
-const workspace = await marketsSDK.createWorkspace({
-  name: 'Mi Dashboard de Trading',
-  description: 'Espacio de trabajo personal para análisis de mercado',
-  userId: 'user-123', // Opcional: asociar a usuario específico
-  projectId: 'project-123', // Opcional: asociar a proyecto específico
-});
-
-console.log('Espacio de trabajo creado:', workspace);
-```
-
-#### Obtener Espacios de Trabajo
-
-```typescript
-// Obtener todos los espacios de trabajo
-const allWorkspaces = await marketsSDK.getWorkspaces({
-  projectId: 'project-123', // ID del proyecto requerido
-  params: {
-    instruments: {
-      options: {
-        limit: 100,
-        offset: 0,
-        sort: { field: 'name', direction: 'asc' }, // Ordenar por nombre ascendente
-      },
-    },
-  },
-});
-
-// Obtener espacios de trabajo por usuario
-const userWorkspaces = await marketsSDK.getWorkspacesByUser({
-  userId: 'user-123',
-  params: {
-    instruments: {
-      options: {
-        limit: 50,
-        offset: 0,
-        sort: { field: 'createdAt', direction: 'desc' }, // Ordenar por fecha de creación descendente
-      },
-    },
-  },
-});
-
-// Obtener espacios de trabajo específicos del usuario
-const specificUserWorkspaces = await marketsSDK.getUserWorkspaces({
-  connectionId: 'connection-123',
-});
-
-console.log('Espacios de trabajo:', allWorkspaces);
-
-**Nota importante**: Los métodos `getWorkspaces()` y `getWorkspacesByUser()` requieren un `projectId` o `userId` respectivamente, y los parámetros de paginación (`limit`, `offset`) y ordenamiento (`sort`) deben estar anidados dentro de `params.instruments.options`.
-```
-
-#### Obtener Detalles del Espacio de Trabajo
-
-```typescript
-const workspaceDetails = await marketsSDK.getWorkspace({
-  workspaceId: 'workspace-123',
-});
-
-console.log('Detalles del workspace:', workspaceDetails);
-console.log('Widgets en el workspace:', workspaceDetails.widgets);
-```
-
-#### Eliminar Espacio de Trabajo
-
-```typescript
-const result = await marketsSDK.deleteWorkspace({
-  id: 'workspace-123',
-});
-
-console.log('Resultado:', result);
-```
-
 ### 📈 Datos de Gráficos
 
 #### Obtener Datos de Gráfico
@@ -402,7 +217,7 @@ console.log('Resultado:', result);
 ```typescript
 // Gráfico diario
 const dailyChart = await marketsSDK.getChartData({
-  instrumentKey: 'AAPL_US',
+  instrumentKey: '1/12576/0/AC*/AAPL',
   period: {
     type: 'day',
     value: 1,
@@ -412,7 +227,7 @@ const dailyChart = await marketsSDK.getChartData({
 
 // Gráfico semanal
 const weeklyChart = await marketsSDK.getChartData({
-  instrumentKey: 'AAPL_US',
+  instrumentKey: '1/12576/0/AC*/AAPL',
   period: {
     type: 'week',
     value: 4,
@@ -422,7 +237,7 @@ const weeklyChart = await marketsSDK.getChartData({
 
 // Gráfico mensual
 const monthlyChart = await marketsSDK.getChartData({
-  instrumentKey: 'AAPL_US',
+  instrumentKey: '1/12576/0/AC*/AAPL',
   period: {
     type: 'month',
     value: 12,
@@ -446,13 +261,13 @@ console.log('Datos del gráfico diario:', dailyChart);
 const periods = {
   // 1 día con intervalos de 1 hora
   daily: { type: 'day', value: 1, interval: 1 },
-  
+
   // 5 días con intervalos de 1 día
   week: { type: 'day', value: 5, interval: 1 },
-  
+
   // 4 semanas con intervalos de 1 semana
   monthly: { type: 'week', value: 4, interval: 1 },
-  
+
   // 12 meses con intervalos de 1 mes
   yearly: { type: 'month', value: 12, interval: 1 },
 };
@@ -491,57 +306,54 @@ class TradingDashboard {
     this.marketsSDK = InfoselMarkets.init({ sdkManager });
   }
 
-  // Crear dashboard completo
-  async createCompleteDashboard(userId: string) {
+  // Obtener datos completos de un instrumento
+  async getCompleteInstrumentData(instrumentKey: string) {
     try {
-      // 1. Crear espacio de trabajo
-      const workspace = await this.marketsSDK.createWorkspace({
-        name: 'Dashboard de Trading',
-        description: 'Dashboard completo para análisis de mercado',
-        userId,
-        // Nota: userId y projectId son mutuamente excluyentes
-        // Si se proporciona userId, no se debe incluir projectId
-      });
-
-      // 2. Crear widget de gráfico para AAPL
-      const chartWidget = await this.marketsSDK.createWidget({
-        workspaceId: workspace.id,
-        type: 'CHART',
-        name: 'Gráfico AAPL',
-        instruments: [{ uniqueKey: 'AAPL_US', symbol: 'AAPL' }],
+      // 1. Obtener campos del instrumento
+      const fields = await this.marketsSDK.getInstrumentFields({
+        instrumentKey,
       });
 
-      // 3. Crear widget de tabla para múltiples instrumentos
-      const tableWidget = await this.marketsSDK.createWidget({
-        workspaceId: workspace.id,
-        type: 'DYNAMIC_TABLE',
-        name: 'Portafolio',
-        instruments: [
-          { uniqueKey: 'AAPL_US', symbol: 'AAPL' },
-          { uniqueKey: 'MSFT_US', symbol: 'MSFT' },
-          { uniqueKey: 'GOOGL_US', symbol: 'GOOGL' },
-        ],
-      });
-
-      // 4. Obtener datos del gráfico
+      // 2. Obtener datos del gráfico
       const chartData = await this.marketsSDK.getChartData({
-        instrumentKey: 'AAPL_US',
+        instrumentKey,
         period: { type: 'day', value: 30, interval: 1 },
       });
 
-      // 5. Obtener perfil del instrumento
+      // 3. Obtener perfil del instrumento
       const profile = await this.marketsSDK.getInstrumentDetailProfile({
-        instrumentId: 'AAPL_US',
+        instrumentKey,
       });
 
+      // 4. Obtener datos financieros
+      const [quarterly, annual, financialReasons] = await Promise.all([
+        this.marketsSDK.getInstrumentDetailFinancialQuartely({
+          instrumentKey,
+          exercise: '2023',
+          period: 4,
+        }),
+        this.marketsSDK.getInstrumentDetailFinancialAnnual({
+          instrumentKey,
+          exercise: '2023',
+          fields: 'revenue,profit',
+        }),
+        this.marketsSDK.getInstrumentDetailFinancialReasons({
+          instrumentKey,
+          exercise: '2023',
+          period: 'Q4',
+        }),
+      ]);
+
       return {
-        workspace,
-        widgets: [chartWidget, tableWidget],
+        fields,
         chartData,
         profile,
+        quarterly,
+        annual,
+        financialReasons,
       };
     } catch (error) {
-      console.error('Error creando dashboard:', error);
+      console.error('Error obteniendo datos del instrumento:', error);
       throw error;
     }
   }
@@ -561,19 +373,21 @@ class TradingDashboard {
   }
 
   // Obtener datos financieros
-  async getFinancialData(instrumentId: string) {
+  async getFinancialData(instrumentKey: string) {
     try {
       const [quarterly, annual, profile] = await Promise.all([
         this.marketsSDK.getInstrumentDetailFinancialQuartely({
-          instrumentId,
-          period: 'QUARTERLY',
+          instrumentKey,
+          exercise: '2023',
+          period: 4,
         }),
         this.marketsSDK.getInstrumentDetailFinancialAnnual({
-          instrumentId,
-          period: 'ANNUAL',
+          instrumentKey,
+          exercise: '2023',
+          fields: 'revenue,profit',
         }),
         this.marketsSDK.getInstrumentDetailProfile({
-          instrumentId,
+          instrumentKey,
         }),
       ]);
 
@@ -588,18 +402,22 @@ class TradingDashboard {
 // Uso del dashboard
 async function main() {
   const dashboard = new TradingDashboard();
-  
+
   try {
-    // Crear dashboard completo
-    const result = await dashboard.createCompleteDashboard('user-123');
-    console.log('Dashboard creado:', result);
+    // Obtener datos completos de un instrumento
+    const instrumentData = await dashboard.getCompleteInstrumentData(
+      '1/12576/0/AC*/AAPL',
+    );
+    console.log('Datos del instrumento:', instrumentData);
 
     // Buscar instrumentos
     const searchResults = await dashboard.searchInstruments('TECH', 5);
     console.log('Resultados de búsqueda:', searchResults);
 
     // Obtener datos financieros
-    const financialData = await dashboard.getFinancialData('AAPL_US');
+    const financialData = await dashboard.getFinancialData(
+      '1/12576/0/AC*/AAPL',
+    );
     console.log('Datos financieros:', financialData);
   } catch (error) {
     console.error('Error en main:', error);
@@ -623,8 +441,8 @@ class AdvancedInstrumentSearch {
   async searchWithFilters(options: {
     query: string;
     marketTypes?: number[]; // Tipos de mercado (ej: [1, 2] para Acciones y Bonos)
-    valueTypes?: number[];  // Tipos de valor (ej: [1] para Equity)
-    exchanges?: number[];   // Exchanges (ej: [1, 2] para NYSE y NASDAQ)
+    valueTypes?: number[]; // Tipos de valor (ej: [1] para Equity)
+    exchanges?: number[]; // Exchanges (ej: [1, 2] para NYSE y NASDAQ)
     limit?: number;
   }) {
     try {
@@ -674,113 +492,6 @@ const nasdaqStocks = await searchSystem.searchByExchange('NASDAQ');
 console.log('Acciones del NASDAQ:', nasdaqStocks);
 ```
 
-### 📊 Gestor de Widgets
-
-```typescript
-class WidgetManager {
-  private marketsSDK: InfoselMarkets;
-
-  constructor(marketsSDK: InfoselMarkets) {
-    this.marketsSDK = marketsSDK;
-  }
-
-  // Crear widget de gráfico
-  async createChartWidget(workspaceId: string, instrument: string, name: string) {
-    try {
-      const widget = await this.marketsSDK.createWidget({
-        workspaceId,
-        type: 'CHART',
-        name,
-        instruments: [{ uniqueKey: instrument, symbol: instrument }],
-      });
-
-      return widget;
-    } catch (error) {
-      console.error('Error creando widget de gráfico:', error);
-      throw error;
-    }
-  }
-
-  // Crear widget de tabla
-  async createTableWidget(
-    workspaceId: string,
-    instruments: string[],
-    name: string
-  ) {
-    try {
-      const widget = await this.marketsSDK.createWidget({
-        workspaceId,
-        type: 'DYNAMIC_TABLE',
-        name,
-        instruments: instruments.map(instrument => ({
-          uniqueKey: instrument,
-          symbol: instrument,
-        })),
-      });
-
-      return widget;
-    } catch (error) {
-      console.error('Error creando widget de tabla:', error);
-      throw error;
-    }
-  }
-
-  // Actualizar instrumentos de un widget
-  async updateWidgetInstruments(widgetId: string, instruments: string[]) {
-    try {
-      const updatedInstruments = await this.marketsSDK.updateWidgetInstruments({
-        widgetId,
-        instruments: { keys: instruments },
-      });
-
-      return updatedInstruments;
-    } catch (error) {
-      console.error('Error actualizando instrumentos:', error);
-      throw error;
-    }
-  }
-
-  // Eliminar widget
-  async deleteWidget(widgetId: string) {
-    try {
-      const result = await this.marketsSDK.deleteWidget(widgetId);
-      return result;
-    } catch (error) {
-      console.error('Error eliminando widget:', error);
-      throw error;
-    }
-  }
-}
-
-// Uso del gestor de widgets
-const widgetManager = new WidgetManager(marketsSDK);
-
-// Crear widgets en un workspace
-async function setupWorkspaceWidgets(workspaceId: string) {
-  try {
-    // Widget de gráfico para AAPL
-    const chartWidget = await widgetManager.createChartWidget(
-      workspaceId,
-      'AAPL_US',
-      'Gráfico de Apple'
-    );
-
-    // Widget de tabla para portafolio
-    const tableWidget = await widgetManager.createTableWidget(
-      workspaceId,
-      ['AAPL_US', 'MSFT_US', 'GOOGL_US'],
-      'Portafolio Principal'
-    );
-
-    console.log('Widgets creados:', { chartWidget, tableWidget });
-    return { chartWidget, tableWidget };
-  } catch (error) {
-    console.error('Error configurando widgets:', error);
-    throw error;
-  }
-}
-```
-
 ## 📚 Referencia de API
 
 ### Clases Principales
@@ -803,77 +514,53 @@ Mapeador de datos para convertir entre modelos de API y dominio.
 
 ### Métodos Disponibles
 
-#### 🔍 Gestión de Instrumentos
+#### 🔍 Búsqueda y Campos de Instrumentos
 
-| Método | Descripción | Parámetros |
-|--------|-------------|------------|
-| `searchInstruments()` | Buscar instrumentos financieros | `SearchInstrumentRequest` |
-| `getInstruments()` | Obtener lista de instrumentos | `GetInstrumentsRequest` |
-| `createInstrument()` | Crear nuevo instrumento | `CreateInstrumentRequest` |
-| `deleteInstrument()` | Eliminar instrumento | `string` (ID) |
-| `getInstrumentFields()` | Obtener campos del instrumento | `string` (ID) |
+| Método                          | Descripción                              | Parámetros                |
+| ------------------------------- | ---------------------------------------- | ------------------------- |
+| `searchInstruments()`           | Buscar instrumentos financieros          | `SearchInstrumentRequest` |
+| `getInstrumentFields()`         | Obtener campos del instrumento           | `GetLastRequest`          |
+| `getInstrumentMultipleFields()` | Obtener campos de múltiples instrumentos | `GetLastRequest`          |
 
 #### 📊 Detalles de Instrumentos
 
-| Método | Descripción | Parámetros |
-|--------|-------------|------------|
-| `getInstrumentDetailProfile()` | Obtener perfil del instrumento | `InstrumentDetailProfileRequest` |
-| `getInstrumentDetailFinancialQuartely()` | Datos financieros trimestrales | `InstrumentDetailFinancialQuarterlyRequest` |
-| `getInstrumentDetailFinancialAnnual()` | Datos financieros anuales | `InstrumentDetailFinancialAnnualRequest` |
-| `getInstrumentDetailFinancialReasons()` | Razones financieras | `InstrumentDetailFinancialReasonsRequest` |
-| `getInstrumentReportFinancialReasons()` | Reportes financieros con razones | `InstrumentReportFinancialReasonsRequest` |
-
-#### 🎯 Gestión de Widgets
-
-| Método | Descripción | Parámetros |
-|--------|-------------|------------|
-| `createWidget()` | Crear nuevo widget | `CreateWidgetRequest` |
-| `deleteWidget()` | Eliminar widget | `string` (ID) |
-| `updateWidgetInstruments()` | Actualizar instrumentos del widget | `UpdateWidgetInstrumentsRequest` |
-| `getProjectWidgets()` | Obtener widgets del proyecto | `GetProjectWidgetsRequest` |
-
-#### 🏢 Gestión de Espacios de Trabajo
-
-| Método | Descripción | Parámetros |
-|--------|-------------|------------|
-| `createWorkspace()` | Crear nuevo espacio de trabajo | `CreateWorkspaceRequest` |
-| `getWorkspaces()` | Obtener espacios de trabajo | `GetWorkspacesRequest` |
-| `getWorkspacesByUser()` | Obtener espacios de trabajo del usuario | `GetWorkspacesByUserRequest` |
-| `getUserWorkspaces()` | Obtener espacios de trabajo específicos del usuario | `GetUserWorkspaceRequest` |
-| `getWorkspace()` | Obtener detalles del workspace | `GetWorkspaceRequest` |
-| `deleteWorkspace()` | Eliminar espacio de trabajo | `DeleteWorkspaceRequest` |
+| Método                                   | Descripción                      | Parámetros                                  |
+| ---------------------------------------- | -------------------------------- | ------------------------------------------- |
+| `getInstrumentDetailProfile()`           | Obtener perfil del instrumento   | `InstrumentDetailProfileRequest`            |
+| `getInstrumentDetailFinancialQuartely()` | Datos financieros trimestrales   | `InstrumentDetailFinancialQuarterlyRequest` |
+| `getInstrumentDetailFinancialAnnual()`   | Datos financieros anuales        | `InstrumentDetailFinancialAnnualRequest`    |
+| `getInstrumentDetailFinancialReasons()`  | Razones financieras              | `InstrumentDetailFinancialReasonsRequest`   |
+| `getInstrumentReportFinancialReasons()`  | Reportes financieros con razones | `InstrumentReportFinancialReasonsRequest`   |
 
 #### 📈 Datos de Gráficos
 
-| Método | Descripción | Parámetros |
-|--------|-------------|------------|
+| Método           | Descripción               | Parámetros     |
+| ---------------- | ------------------------- | -------------- |
 | `getChartData()` | Obtener datos de gráficos | `ChartRequest` |
 
 ### Entidades
 
 #### Entidades Principales
 
-- `Instrument`: Representación de instrumento financiero
-- `Widget`: Configuración y datos del widget
-- `Workspace`: Espacio de trabajo del usuario
+- `Instrument`: Representación básica de instrumento financiero (instrumentKey, symbol)
+- `InstrumentFields`: Campos completos de mercado de un instrumento
 - `ChartItem`: Punto de datos del gráfico
 - `SearchResultItem`: Elemento de resultado de búsqueda
+- `InstrumentDetailProfile`: Perfil detallado del instrumento
+- `InstrumentDetailFinancial`: Datos financieros del instrumento
+- `InstrumentDetailFinancialReasons`: Razones financieras del instrumento
+- `InstrumentReportFinancialReasons`: Reporte financiero con razones
 
 #### Entidades de Solicitud/Respuesta
 
-- `SearchInstrumentsRequest`: Parámetros de búsqueda
-- `CreateWidgetRequest`: Parámetros de creación de widget
-- `CreateWorkspaceRequest`: Parámetros de creación de espacio de trabajo
+- `SearchInstrumentsRequest`: Parámetros de búsqueda de instrumentos
+- `GetLastRequest`: Parámetros para obtener campos de instrumento
 - `ChartRequest`: Parámetros de solicitud de datos de gráfico
-
-#### Tipos de Widgets
-
-- `DYNAMIC_TABLE`: Tabla dinámica con datos en tiempo real
-- `PREDEFINED_TABLE`: Tabla predefinida con estructura fija
-- `CUSTOM_TABLE`: Tabla personalizable
-- `NEWS_LIST`: Lista de noticias financieras
-- `TICKER_TAPE`: Cinta de ticker con precios
-- `CHART`: Gráfico de precios y volúmenes
+- `InstrumentDetailProfileRequest`: Parámetros para obtener perfil
+- `InstrumentDetailFinancialAnnualRequest`: Parámetros para datos anuales
+- `InstrumentDetailFinancialQuarterlyRequest`: Parámetros para datos trimestrales
+- `InstrumentDetailFinancialReasonsRequest`: Parámetros para razones financieras
+- `InstrumentReportFinancialReasonsRequest`: Parámetros para reporte financiero
 
 #### Tipos de Períodos de Gráficos
 
@@ -969,7 +656,8 @@ El script `run-e2e.sh` proporciona una interfaz fácil para ejecutar pruebas e2e
 
 - **SDK Core Configuration**: Verificación de inicialización y autenticación
 - **Markets API Integration**: Conexión real a la API de markets
-- **Workspace Operations**: Operaciones de workspace con datos reales
+- **Instrument Search**: Búsqueda de instrumentos con datos reales
+- **Instrument Fields**: Obtención de campos de instrumentos
 - **Performance and Reliability**: Verificación de tiempos de respuesta y concurrencia
 
 #### Notas Importantes
@@ -982,7 +670,6 @@ El script `run-e2e.sh` proporciona una interfaz fácil para ejecutar pruebas e2e
 
 Para más detalles, consulta el [README de pruebas e2e](src/__tests__/e2e/README.md).
 
-
 ## 📞 Soporte
 
 Para soporte y preguntas, por favor contacta al equipo de desarrollo de Infosel.
@@ -990,6 +677,7 @@ Para soporte y preguntas, por favor contacta al equipo de desarrollo de Infosel.
 ## 🔗 Paquetes Relacionados
 
 - `@infosel-sdk/core`: Funcionalidad core del SDK (versión ^0.0.4)
+- `@infosel-sdk/widgets`: SDK de widgets y espacios de trabajo (versión ^1.0.0)
 - `@infosel-sdk/news`: SDK de noticias y contenido
 - `@infosel-sdk/securities`: SDK de valores y trading