reportify-sdk 0.3.25 → 0.3.27

package/dist/index.d.mts

@@ -656,33 +656,19 @@ declare class DocsModule {
 /**
  * Quant Module
  *
- * Provides quantitative analysis tools including indicators, factors, quotes, and backtesting.
+ * Provides quantitative analysis tools including factors (technical and fundamental), quotes, and backtesting.
  * Based on Mai-language syntax compatible with TongDaXin/TongHuaShun.
+ *
+ * All technical indicators (RSI, MACD, KDJ, etc.) are now available as factors through the unified factors API.
  */
 
 type StockMarket = 'cn' | 'hk' | 'us';
-interface IndicatorMeta {
-    name: string;
-    description: string;
-    fields: string[];
-}
-interface IndicatorComputeParams {
-    symbols: string[];
-    formula: string;
-    market?: StockMarket;
-    startDate?: string;
-    endDate?: string;
-}
-interface IndicatorData {
-    symbol: string;
-    date: string;
-    [key: string]: unknown;
-}
 interface FactorMeta {
     name: string;
     type: 'variable' | 'function';
     level: 0 | 1 | 2;
     description: string;
+    fields?: string[];
 }
 interface FactorComputeParams {
     symbols: string[];
@@ -714,6 +700,16 @@ interface BatchOHLCVParams {
     startDate?: string;
     endDate?: string;
 }
+interface FactorComputeData {
+    symbol: string;
+    date: string;
+    name?: string;
+    name_en?: string;
+    close?: number;
+    factor_value?: number | boolean;
+    indicators?: Record<string, number | boolean>;
+    [key: string]: unknown;
+}
 interface OHLCVData {
     symbol: string;
     date: string;
@@ -797,10 +793,21 @@ interface BacktestResult {
 /**
  * Quantitative analysis module
  *
+ * Access factors (including technical indicators and fundamental factors), OHLCV quotes, and backtesting functionality.
+ * Uses Mai-language syntax for formulas.
+ *
+ * Technical indicators are now part of the unified factors system:
+ * - Level 0: Basic variables (CLOSE, OPEN, HIGH, LOW, VOLUME) and core functions (MA, EMA, REF, etc.)
+ * - Level 1: Application functions (CROSS, COUNT, EVERY, etc.)
+ * - Level 2: Technical indicators (RSI, MACD, KDJ, BOLL, etc.) and fundamental factors (PE, ROE, etc.)
+ *
  * @example
  * ```typescript
- * // Compute RSI indicator
- * const data = await client.quant.indicatorsCompute({
+ * // List all available factors (including technical indicators)
+ * const factors = await client.quant.factors();
+ *
+ * // Compute RSI (now through factors API)
+ * const data = await client.quant.factorsCompute({
  *   symbols: ['000001'],
  *   formula: 'RSI(14)'
  * });
@@ -815,63 +822,31 @@ declare class QuantModule {
     private client;
     constructor(client: Reportify);
     /**
-     * Get list of available technical indicators
+     * Get list of available factors (variables, functions, and indicators)
      *
-     * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
-     *
-     * @returns Array of indicator definitions
-     *
-     * @example
-     * ```typescript
-     * const indicators = await client.quant.indicators();
-     * indicators.forEach(ind => {
-     *   console.log(`${ind.name}: ${ind.description}`);
-     *   console.log(`  Fields: ${ind.fields.join(', ')}`);
-     * });
-     * ```
-     */
-    indicators(): Promise<IndicatorMeta[]>;
-    /**
-     * Compute indicator values for given symbols
+     * Returns factors organized by level:
+     * - Level 0 Variables: CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT (price data, no parentheses)
+     * - Level 0 Functions: MA(), EMA(), REF(), HHV(), LLV(), STD(), etc. (require parentheses)
+     * - Level 1 Functions: CROSS(), COUNT(), EVERY(), etc. (require parentheses)
+     * - Level 2 Functions: Technical indicators (MACD(), KDJ(), RSI(), BOLL(), etc.) and fundamental factors (PE(), ROE(), etc.)
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
-     * @param params - Indicator computation parameters
-     * @returns Array of indicator data
+     * @returns Array of factor definitions with name, type, level, description, and optional fields
      *
      * @example
      * ```typescript
-     * // RSI indicator
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'RSI(14)'
-     * });
-     *
-     * // MACD indicator
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'MACD()'
-     * });
-     *
-     * // Standard deviation
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'STD(CLOSE, 20)'
+     * const factors = await client.quant.factors();
+     * factors.forEach(f => {
+     *   console.log(`${f.name} (${f.type}, level ${f.level})`);
+     *   if (f.fields) {
+     *     console.log(`  Fields: ${f.fields.join(', ')}`);
+     *   }
      * });
      * ```
      */
-    indicatorsCompute(params: IndicatorComputeParams): Promise<IndicatorData[]>;
-    /**
-     * Get list of available factors (variables and functions)
-     *
-     * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
-     *
-     * @returns Array of factor definitions organized by level
-     */
     factors(): Promise<FactorMeta[]>;
     /**
      * Compute factor values for given symbols
@@ -879,7 +854,7 @@ declare class QuantModule {
      * Uses Mai-language syntax compatible with TongDaXin/TongHuaShun.
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Factor computation parameters
@@ -887,37 +862,37 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * // Simple indicator
+     * // Technical indicators (RSI, MACD, etc.)
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
-     * // MACD DIF line
+     * // MACD indicator
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD().dif'
      * });
      *
-     * // Close above 20-day MA
+     * // Core functions
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
-     *   formula: 'CLOSE > MA(CLOSE, 20)'
+     *   formula: 'MA(CLOSE, 20)'
      * });
      *
-     * // Fundamental factors (note: functions require parentheses)
+     * // Fundamental factors
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'PE()'
      * });
      * ```
      */
-    factorsCompute(params: FactorComputeParams): Promise<IndicatorData[]>;
+    factorsCompute(params: FactorComputeParams): Promise<FactorComputeData[]>;
     /**
      * Screen stocks based on factor formula
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Screening parameters
@@ -925,7 +900,7 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * // RSI oversold
+     * // Technical screening
      * const stocks = await client.quant.factorsScreen({
      *   formula: 'RSI(14) < 30'
      * });
@@ -935,12 +910,7 @@ declare class QuantModule {
      *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
-     * // Uptrend
-     * const stocks = await client.quant.factorsScreen({
-     *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
-     * });
-     *
-     * // Fundamental screening (note: functions require parentheses)
+     * // Fundamental screening
      * const stocks = await client.quant.factorsScreen({
      *   formula: '(PE() < 20) & (ROE() > 0.15)'
      * });
@@ -1049,7 +1019,7 @@ declare class QuantModule {
      * Execute strategy backtest
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Backtest parameters
@@ -1087,7 +1057,7 @@ declare class QuantModule {
      *     for data in datas:
      *         symbol = data.name
      *         if not context.portfolio.get_position(symbol):
-     *             if data.pe < 20 and data.rsi < 30:  # Use pre-calculated factors
+     *             if data.pe < 20 and data.rsi < 30:  // Use pre-calculated factors
      *                 context.order_target_percent(symbol, 0.2)
      *         elif data.rsi > 70:
      *             context.order_target_percent(symbol, 0)
@@ -1947,4 +1917,4 @@ declare class Reportify {
     getBytes(path: string): Promise<ArrayBuffer>;
 }
 
-export { APIError, type AgentConversation, type AgentMessage, AgentModule, AuthenticationError, type BacktestParams, type BacktestResult, type BatchKline1mParams, type BatchMinuteParams, type BatchOHLCVOutput, type BatchOHLCVParams, type Calendar, type Channel, ChannelsModule, type ChatCompletionOptions, type ChatCompletionResponse, type ChatMode, ChatModule, type Chunk, type ChunkSearchOptions, type CommodityData, type CommodityType, type CompanyInfo, type CompanyOverview, type Concept, type ConceptDoc, type ConceptEvent, type ConceptFeed, type ConceptStock, ConceptsModule, type DocsListOptions, DocsModule, type Document, type DocumentInput, type EarningsEvent, type EarningsSearchOptions, type FactorComputeParams, type FactorMeta, type FinancialStatement, type FollowedCompany, FollowingModule, type IPOEvent, type IPOStatus, type IndexConstituent, type IndexFund, type IndicatorComputeParams, type IndicatorData, type IndicatorMeta, type IndustryConstituent, KBModule, type KBSearchOptions, type Kline1mParams, MacroModule, type Market, type MinuteParams, NotFoundError, type OHLCVData, type OHLCVParams, type PaginatedResponse, type Period, type PriceData, QuantModule, type Quote, RateLimitError, Reportify, type ReportifyConfig, ReportifyError, type ScreenParams, type ScreenedStock, SearchModule, type SearchOptions, type Shareholder, type ShareholderType, type StockInfo, type StockMarket, StockModule, TimelineModule, type TimelineOptions, type UploadDocRequest, UserModule };
+export { APIError, type AgentConversation, type AgentMessage, AgentModule, AuthenticationError, type BacktestParams, type BacktestResult, type BatchKline1mParams, type BatchMinuteParams, type BatchOHLCVOutput, type BatchOHLCVParams, type Calendar, type Channel, ChannelsModule, type ChatCompletionOptions, type ChatCompletionResponse, type ChatMode, ChatModule, type Chunk, type ChunkSearchOptions, type CommodityData, type CommodityType, type CompanyInfo, type CompanyOverview, type Concept, type ConceptDoc, type ConceptEvent, type ConceptFeed, type ConceptStock, ConceptsModule, type DocsListOptions, DocsModule, type Document, type DocumentInput, type EarningsEvent, type EarningsSearchOptions, type FactorComputeData, type FactorComputeParams, type FactorMeta, type FinancialStatement, type FollowedCompany, FollowingModule, type IPOEvent, type IPOStatus, type IndexConstituent, type IndexFund, type IndustryConstituent, KBModule, type KBSearchOptions, type Kline1mParams, MacroModule, type Market, type MinuteParams, NotFoundError, type OHLCVData, type OHLCVParams, type PaginatedResponse, type Period, type PriceData, QuantModule, type Quote, RateLimitError, Reportify, type ReportifyConfig, ReportifyError, type ScreenParams, type ScreenedStock, SearchModule, type SearchOptions, type Shareholder, type ShareholderType, type StockInfo, type StockMarket, StockModule, TimelineModule, type TimelineOptions, type UploadDocRequest, UserModule };

package/dist/index.d.ts

@@ -656,33 +656,19 @@ declare class DocsModule {
 /**
  * Quant Module
  *
- * Provides quantitative analysis tools including indicators, factors, quotes, and backtesting.
+ * Provides quantitative analysis tools including factors (technical and fundamental), quotes, and backtesting.
  * Based on Mai-language syntax compatible with TongDaXin/TongHuaShun.
+ *
+ * All technical indicators (RSI, MACD, KDJ, etc.) are now available as factors through the unified factors API.
  */
 
 type StockMarket = 'cn' | 'hk' | 'us';
-interface IndicatorMeta {
-    name: string;
-    description: string;
-    fields: string[];
-}
-interface IndicatorComputeParams {
-    symbols: string[];
-    formula: string;
-    market?: StockMarket;
-    startDate?: string;
-    endDate?: string;
-}
-interface IndicatorData {
-    symbol: string;
-    date: string;
-    [key: string]: unknown;
-}
 interface FactorMeta {
     name: string;
     type: 'variable' | 'function';
     level: 0 | 1 | 2;
     description: string;
+    fields?: string[];
 }
 interface FactorComputeParams {
     symbols: string[];
@@ -714,6 +700,16 @@ interface BatchOHLCVParams {
     startDate?: string;
     endDate?: string;
 }
+interface FactorComputeData {
+    symbol: string;
+    date: string;
+    name?: string;
+    name_en?: string;
+    close?: number;
+    factor_value?: number | boolean;
+    indicators?: Record<string, number | boolean>;
+    [key: string]: unknown;
+}
 interface OHLCVData {
     symbol: string;
     date: string;
@@ -797,10 +793,21 @@ interface BacktestResult {
 /**
  * Quantitative analysis module
  *
+ * Access factors (including technical indicators and fundamental factors), OHLCV quotes, and backtesting functionality.
+ * Uses Mai-language syntax for formulas.
+ *
+ * Technical indicators are now part of the unified factors system:
+ * - Level 0: Basic variables (CLOSE, OPEN, HIGH, LOW, VOLUME) and core functions (MA, EMA, REF, etc.)
+ * - Level 1: Application functions (CROSS, COUNT, EVERY, etc.)
+ * - Level 2: Technical indicators (RSI, MACD, KDJ, BOLL, etc.) and fundamental factors (PE, ROE, etc.)
+ *
  * @example
  * ```typescript
- * // Compute RSI indicator
- * const data = await client.quant.indicatorsCompute({
+ * // List all available factors (including technical indicators)
+ * const factors = await client.quant.factors();
+ *
+ * // Compute RSI (now through factors API)
+ * const data = await client.quant.factorsCompute({
  *   symbols: ['000001'],
  *   formula: 'RSI(14)'
  * });
@@ -815,63 +822,31 @@ declare class QuantModule {
     private client;
     constructor(client: Reportify);
     /**
-     * Get list of available technical indicators
+     * Get list of available factors (variables, functions, and indicators)
      *
-     * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
-     *
-     * @returns Array of indicator definitions
-     *
-     * @example
-     * ```typescript
-     * const indicators = await client.quant.indicators();
-     * indicators.forEach(ind => {
-     *   console.log(`${ind.name}: ${ind.description}`);
-     *   console.log(`  Fields: ${ind.fields.join(', ')}`);
-     * });
-     * ```
-     */
-    indicators(): Promise<IndicatorMeta[]>;
-    /**
-     * Compute indicator values for given symbols
+     * Returns factors organized by level:
+     * - Level 0 Variables: CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT (price data, no parentheses)
+     * - Level 0 Functions: MA(), EMA(), REF(), HHV(), LLV(), STD(), etc. (require parentheses)
+     * - Level 1 Functions: CROSS(), COUNT(), EVERY(), etc. (require parentheses)
+     * - Level 2 Functions: Technical indicators (MACD(), KDJ(), RSI(), BOLL(), etc.) and fundamental factors (PE(), ROE(), etc.)
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
-     * @param params - Indicator computation parameters
-     * @returns Array of indicator data
+     * @returns Array of factor definitions with name, type, level, description, and optional fields
      *
      * @example
      * ```typescript
-     * // RSI indicator
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'RSI(14)'
-     * });
-     *
-     * // MACD indicator
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'MACD()'
-     * });
-     *
-     * // Standard deviation
-     * const data = await client.quant.indicatorsCompute({
-     *   symbols: ['000001'],
-     *   formula: 'STD(CLOSE, 20)'
+     * const factors = await client.quant.factors();
+     * factors.forEach(f => {
+     *   console.log(`${f.name} (${f.type}, level ${f.level})`);
+     *   if (f.fields) {
+     *     console.log(`  Fields: ${f.fields.join(', ')}`);
+     *   }
      * });
      * ```
      */
-    indicatorsCompute(params: IndicatorComputeParams): Promise<IndicatorData[]>;
-    /**
-     * Get list of available factors (variables and functions)
-     *
-     * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
-     *
-     * @returns Array of factor definitions organized by level
-     */
     factors(): Promise<FactorMeta[]>;
     /**
      * Compute factor values for given symbols
@@ -879,7 +854,7 @@ declare class QuantModule {
      * Uses Mai-language syntax compatible with TongDaXin/TongHuaShun.
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Factor computation parameters
@@ -887,37 +862,37 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * // Simple indicator
+     * // Technical indicators (RSI, MACD, etc.)
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'RSI(14)'
      * });
      *
-     * // MACD DIF line
+     * // MACD indicator
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'MACD().dif'
      * });
      *
-     * // Close above 20-day MA
+     * // Core functions
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
-     *   formula: 'CLOSE > MA(CLOSE, 20)'
+     *   formula: 'MA(CLOSE, 20)'
      * });
      *
-     * // Fundamental factors (note: functions require parentheses)
+     * // Fundamental factors
      * const data = await client.quant.factorsCompute({
      *   symbols: ['000001'],
      *   formula: 'PE()'
      * });
      * ```
      */
-    factorsCompute(params: FactorComputeParams): Promise<IndicatorData[]>;
+    factorsCompute(params: FactorComputeParams): Promise<FactorComputeData[]>;
     /**
      * Screen stocks based on factor formula
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Screening parameters
@@ -925,7 +900,7 @@ declare class QuantModule {
      *
      * @example
      * ```typescript
-     * // RSI oversold
+     * // Technical screening
      * const stocks = await client.quant.factorsScreen({
      *   formula: 'RSI(14) < 30'
      * });
@@ -935,12 +910,7 @@ declare class QuantModule {
      *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
-     * // Uptrend
-     * const stocks = await client.quant.factorsScreen({
-     *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
-     * });
-     *
-     * // Fundamental screening (note: functions require parentheses)
+     * // Fundamental screening
      * const stocks = await client.quant.factorsScreen({
      *   formula: '(PE() < 20) & (ROE() > 0.15)'
      * });
@@ -1049,7 +1019,7 @@ declare class QuantModule {
      * Execute strategy backtest
      *
      * Variables vs Functions:
-     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+     * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
      * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Backtest parameters
@@ -1087,7 +1057,7 @@ declare class QuantModule {
      *     for data in datas:
      *         symbol = data.name
      *         if not context.portfolio.get_position(symbol):
-     *             if data.pe < 20 and data.rsi < 30:  # Use pre-calculated factors
+     *             if data.pe < 20 and data.rsi < 30:  // Use pre-calculated factors
      *                 context.order_target_percent(symbol, 0.2)
      *         elif data.rsi > 70:
      *             context.order_target_percent(symbol, 0)
@@ -1947,4 +1917,4 @@ declare class Reportify {
     getBytes(path: string): Promise<ArrayBuffer>;
 }
 
-export { APIError, type AgentConversation, type AgentMessage, AgentModule, AuthenticationError, type BacktestParams, type BacktestResult, type BatchKline1mParams, type BatchMinuteParams, type BatchOHLCVOutput, type BatchOHLCVParams, type Calendar, type Channel, ChannelsModule, type ChatCompletionOptions, type ChatCompletionResponse, type ChatMode, ChatModule, type Chunk, type ChunkSearchOptions, type CommodityData, type CommodityType, type CompanyInfo, type CompanyOverview, type Concept, type ConceptDoc, type ConceptEvent, type ConceptFeed, type ConceptStock, ConceptsModule, type DocsListOptions, DocsModule, type Document, type DocumentInput, type EarningsEvent, type EarningsSearchOptions, type FactorComputeParams, type FactorMeta, type FinancialStatement, type FollowedCompany, FollowingModule, type IPOEvent, type IPOStatus, type IndexConstituent, type IndexFund, type IndicatorComputeParams, type IndicatorData, type IndicatorMeta, type IndustryConstituent, KBModule, type KBSearchOptions, type Kline1mParams, MacroModule, type Market, type MinuteParams, NotFoundError, type OHLCVData, type OHLCVParams, type PaginatedResponse, type Period, type PriceData, QuantModule, type Quote, RateLimitError, Reportify, type ReportifyConfig, ReportifyError, type ScreenParams, type ScreenedStock, SearchModule, type SearchOptions, type Shareholder, type ShareholderType, type StockInfo, type StockMarket, StockModule, TimelineModule, type TimelineOptions, type UploadDocRequest, UserModule };
+export { APIError, type AgentConversation, type AgentMessage, AgentModule, AuthenticationError, type BacktestParams, type BacktestResult, type BatchKline1mParams, type BatchMinuteParams, type BatchOHLCVOutput, type BatchOHLCVParams, type Calendar, type Channel, ChannelsModule, type ChatCompletionOptions, type ChatCompletionResponse, type ChatMode, ChatModule, type Chunk, type ChunkSearchOptions, type CommodityData, type CommodityType, type CompanyInfo, type CompanyOverview, type Concept, type ConceptDoc, type ConceptEvent, type ConceptFeed, type ConceptStock, ConceptsModule, type DocsListOptions, DocsModule, type Document, type DocumentInput, type EarningsEvent, type EarningsSearchOptions, type FactorComputeData, type FactorComputeParams, type FactorMeta, type FinancialStatement, type FollowedCompany, FollowingModule, type IPOEvent, type IPOStatus, type IndexConstituent, type IndexFund, type IndustryConstituent, KBModule, type KBSearchOptions, type Kline1mParams, MacroModule, type Market, type MinuteParams, NotFoundError, type OHLCVData, type OHLCVParams, type PaginatedResponse, type Period, type PriceData, QuantModule, type Quote, RateLimitError, Reportify, type ReportifyConfig, ReportifyError, type ScreenParams, type ScreenedStock, SearchModule, type SearchOptions, type Shareholder, type ShareholderType, type StockInfo, type StockMarket, StockModule, TimelineModule, type TimelineOptions, type UploadDocRequest, UserModule };

package/dist/index.js

@@ -619,80 +619,34 @@ var QuantModule = class {
     this.client = client;
   }
   // ===========================================================================
-  // Indicators
+  // Factors (includes technical indicators and fundamental factors)
   // ===========================================================================
   /**
-   * Get list of available technical indicators
+   * Get list of available factors (variables, functions, and indicators)
    *
-   * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
-   *
-   * @returns Array of indicator definitions
-   *
-   * @example
-   * ```typescript
-   * const indicators = await client.quant.indicators();
-   * indicators.forEach(ind => {
-   *   console.log(`${ind.name}: ${ind.description}`);
-   *   console.log(`  Fields: ${ind.fields.join(', ')}`);
-   * });
-   * ```
-   */
-  async indicators() {
-    return this.client.get("/v1/quant/indicators");
-  }
-  /**
-   * Compute indicator values for given symbols
+   * Returns factors organized by level:
+   * - Level 0 Variables: CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT (price data, no parentheses)
+   * - Level 0 Functions: MA(), EMA(), REF(), HHV(), LLV(), STD(), etc. (require parentheses)
+   * - Level 1 Functions: CROSS(), COUNT(), EVERY(), etc. (require parentheses)
+   * - Level 2 Functions: Technical indicators (MACD(), KDJ(), RSI(), BOLL(), etc.) and fundamental factors (PE(), ROE(), etc.)
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
-   * @param params - Indicator computation parameters
-   * @returns Array of indicator data
+   * @returns Array of factor definitions with name, type, level, description, and optional fields
    *
    * @example
    * ```typescript
-   * // RSI indicator
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'RSI(14)'
-   * });
-   *
-   * // MACD indicator
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'MACD()'
-   * });
-   *
-   * // Standard deviation
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'STD(CLOSE, 20)'
+   * const factors = await client.quant.factors();
+   * factors.forEach(f => {
+   *   console.log(`${f.name} (${f.type}, level ${f.level})`);
+   *   if (f.fields) {
+   *     console.log(`  Fields: ${f.fields.join(', ')}`);
+   *   }
    * });
    * ```
    */
-  async indicatorsCompute(params) {
-    const response = await this.client.post("/v1/quant/indicators/compute", {
-      symbols: params.symbols,
-      formula: params.formula,
-      market: params.market || "cn",
-      start_date: params.startDate,
-      end_date: params.endDate
-    });
-    return response.datas || [];
-  }
-  // ===========================================================================
-  // Factors
-  // ===========================================================================
-  /**
-   * Get list of available factors (variables and functions)
-   *
-   * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
-   *
-   * @returns Array of factor definitions organized by level
-   */
   async factors() {
     return this.client.get("/v1/quant/factors");
   }
@@ -702,7 +656,7 @@ var QuantModule = class {
    * Uses Mai-language syntax compatible with TongDaXin/TongHuaShun.
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Factor computation parameters
@@ -710,25 +664,25 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * // Simple indicator
+   * // Technical indicators (RSI, MACD, etc.)
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
-   * // MACD DIF line
+   * // MACD indicator
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD().dif'
    * });
    *
-   * // Close above 20-day MA
+   * // Core functions
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
-   *   formula: 'CLOSE > MA(CLOSE, 20)'
+   *   formula: 'MA(CLOSE, 20)'
    * });
    *
-   * // Fundamental factors (note: functions require parentheses)
+   * // Fundamental factors
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'PE()'
@@ -749,7 +703,7 @@ var QuantModule = class {
    * Screen stocks based on factor formula
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Screening parameters
@@ -757,7 +711,7 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * // RSI oversold
+   * // Technical screening
    * const stocks = await client.quant.factorsScreen({
    *   formula: 'RSI(14) < 30'
    * });
@@ -767,12 +721,7 @@ var QuantModule = class {
    *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
-   * // Uptrend
-   * const stocks = await client.quant.factorsScreen({
-   *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
-   * });
-   *
-   * // Fundamental screening (note: functions require parentheses)
+   * // Fundamental screening
    * const stocks = await client.quant.factorsScreen({
    *   formula: '(PE() < 20) & (ROE() > 0.15)'
    * });
@@ -943,7 +892,7 @@ var QuantModule = class {
    * Execute strategy backtest
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Backtest parameters
@@ -981,7 +930,7 @@ var QuantModule = class {
    *     for data in datas:
    *         symbol = data.name
    *         if not context.portfolio.get_position(symbol):
-   *             if data.pe < 20 and data.rsi < 30:  # Use pre-calculated factors
+   *             if data.pe < 20 and data.rsi < 30:  // Use pre-calculated factors
    *                 context.order_target_percent(symbol, 0.2)
    *         elif data.rsi > 70:
    *             context.order_target_percent(symbol, 0)

package/dist/index.mjs

@@ -575,80 +575,34 @@ var QuantModule = class {
     this.client = client;
   }
   // ===========================================================================
-  // Indicators
+  // Factors (includes technical indicators and fundamental factors)
   // ===========================================================================
   /**
-   * Get list of available technical indicators
+   * Get list of available factors (variables, functions, and indicators)
    *
-   * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
-   *
-   * @returns Array of indicator definitions
-   *
-   * @example
-   * ```typescript
-   * const indicators = await client.quant.indicators();
-   * indicators.forEach(ind => {
-   *   console.log(`${ind.name}: ${ind.description}`);
-   *   console.log(`  Fields: ${ind.fields.join(', ')}`);
-   * });
-   * ```
-   */
-  async indicators() {
-    return this.client.get("/v1/quant/indicators");
-  }
-  /**
-   * Compute indicator values for given symbols
+   * Returns factors organized by level:
+   * - Level 0 Variables: CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT (price data, no parentheses)
+   * - Level 0 Functions: MA(), EMA(), REF(), HHV(), LLV(), STD(), etc. (require parentheses)
+   * - Level 1 Functions: CROSS(), COUNT(), EVERY(), etc. (require parentheses)
+   * - Level 2 Functions: Technical indicators (MACD(), KDJ(), RSI(), BOLL(), etc.) and fundamental factors (PE(), ROE(), etc.)
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
-   * @param params - Indicator computation parameters
-   * @returns Array of indicator data
+   * @returns Array of factor definitions with name, type, level, description, and optional fields
    *
    * @example
    * ```typescript
-   * // RSI indicator
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'RSI(14)'
-   * });
-   *
-   * // MACD indicator
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'MACD()'
-   * });
-   *
-   * // Standard deviation
-   * const data = await client.quant.indicatorsCompute({
-   *   symbols: ['000001'],
-   *   formula: 'STD(CLOSE, 20)'
+   * const factors = await client.quant.factors();
+   * factors.forEach(f => {
+   *   console.log(`${f.name} (${f.type}, level ${f.level})`);
+   *   if (f.fields) {
+   *     console.log(`  Fields: ${f.fields.join(', ')}`);
+   *   }
    * });
    * ```
    */
-  async indicatorsCompute(params) {
-    const response = await this.client.post("/v1/quant/indicators/compute", {
-      symbols: params.symbols,
-      formula: params.formula,
-      market: params.market || "cn",
-      start_date: params.startDate,
-      end_date: params.endDate
-    });
-    return response.datas || [];
-  }
-  // ===========================================================================
-  // Factors
-  // ===========================================================================
-  /**
-   * Get list of available factors (variables and functions)
-   *
-   * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
-   *
-   * @returns Array of factor definitions organized by level
-   */
   async factors() {
     return this.client.get("/v1/quant/factors");
   }
@@ -658,7 +612,7 @@ var QuantModule = class {
    * Uses Mai-language syntax compatible with TongDaXin/TongHuaShun.
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Factor computation parameters
@@ -666,25 +620,25 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * // Simple indicator
+   * // Technical indicators (RSI, MACD, etc.)
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'RSI(14)'
    * });
    *
-   * // MACD DIF line
+   * // MACD indicator
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'MACD().dif'
    * });
    *
-   * // Close above 20-day MA
+   * // Core functions
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
-   *   formula: 'CLOSE > MA(CLOSE, 20)'
+   *   formula: 'MA(CLOSE, 20)'
    * });
    *
-   * // Fundamental factors (note: functions require parentheses)
+   * // Fundamental factors
    * const data = await client.quant.factorsCompute({
    *   symbols: ['000001'],
    *   formula: 'PE()'
@@ -705,7 +659,7 @@ var QuantModule = class {
    * Screen stocks based on factor formula
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Screening parameters
@@ -713,7 +667,7 @@ var QuantModule = class {
    *
    * @example
    * ```typescript
-   * // RSI oversold
+   * // Technical screening
    * const stocks = await client.quant.factorsScreen({
    *   formula: 'RSI(14) < 30'
    * });
@@ -723,12 +677,7 @@ var QuantModule = class {
    *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
-   * // Uptrend
-   * const stocks = await client.quant.factorsScreen({
-   *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
-   * });
-   *
-   * // Fundamental screening (note: functions require parentheses)
+   * // Fundamental screening
    * const stocks = await client.quant.factorsScreen({
    *   formula: '(PE() < 20) & (ROE() > 0.15)'
    * });
@@ -899,7 +848,7 @@ var QuantModule = class {
    * Execute strategy backtest
    *
    * Variables vs Functions:
-   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
+   * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, AMOUNT
    * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Backtest parameters
@@ -937,7 +886,7 @@ var QuantModule = class {
    *     for data in datas:
    *         symbol = data.name
    *         if not context.portfolio.get_position(symbol):
-   *             if data.pe < 20 and data.rsi < 30:  # Use pre-calculated factors
+   *             if data.pe < 20 and data.rsi < 30:  // Use pre-calculated factors
    *                 context.order_target_percent(symbol, 0.2)
    *         elif data.rsi > 70:
    *             context.order_target_percent(symbol, 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reportify-sdk",
-  "version": "0.3.25",
+  "version": "0.3.27",
   "description": "TypeScript SDK for Reportify API - Financial data and document search",
   "main": "dist/index.js",
   "module": "dist/index.mjs",