reportify-sdk 0.3.3 → 0.3.5

package/README.md

@@ -58,8 +58,7 @@ const quote = await client.stock.quote('US:AAPL');
 const overview = await client.stock.overview('US:AAPL');
 const shareholders = await client.stock.shareholders('US:AAPL');
 
-// Screening and calendar
-const stocks = await client.stock.screener({ country: 'US', marketCapMoreThan: 1e10 });
+// Earnings calendar
 const earnings = await client.stock.earningsCalendar({ market: 'us', startDate: '2024-01-01', endDate: '2024-01-31' });
 ```
 
@@ -114,7 +113,7 @@ const macd = await client.quant.computeIndicators({
 
 // Screen stocks by formula
 const oversold = await client.quant.screen({ formula: 'RSI(14) < 30' });
-const goldenCross = await client.quant.screen({ formula: 'CROSS(MA(5), MA(20))' });
+const goldenCross = await client.quant.screen({ formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))' });
 
 // Get OHLCV data
 const ohlcv = await client.quant.ohlcv({ symbol: '000001', startDate: '2024-01-01' });
@@ -125,8 +124,8 @@ const result = await client.quant.backtest({
   startDate: '2023-01-01',
   endDate: '2024-01-01',
   symbol: '000001',
-  entryFormula: 'CROSS(MA(5), MA(20))',
-  exitFormula: 'CROSSDOWN(MA(5), MA(20))'
+  entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',
+  exitFormula: 'CROSSDOWN(MA(CLOSE, 5), MA(CLOSE, 20))'
 });
 console.log(`Total Return: ${(result.total_return_pct * 100).toFixed(2)}%`);
 ```

package/dist/index.d.mts

@@ -424,26 +424,6 @@ declare class StockModule {
         startDate?: string;
         endDate?: string;
     }): Promise<PriceData[]>;
-    /**
-     * Screen stocks based on various criteria
-     */
-    screener(options?: {
-        marketCapMoreThan?: number;
-        marketCapLowerThan?: number;
-        priceMoreThan?: number;
-        priceLowerThan?: number;
-        changePercentageMoreThan?: number;
-        changePercentageLowerThan?: number;
-        volumeMoreThan?: number;
-        volumeLowerThan?: number;
-        country?: string;
-        exchange?: string;
-        dividendYieldMoreThan?: number;
-        dividendYieldLowerThan?: number;
-        peTtmMoreThan?: number;
-        peTtmLowerThan?: number;
-        limit?: number;
-    }): Promise<CompanyOverview[]>;
     /**
      * Get earnings announcement calendar
      *
@@ -800,7 +780,7 @@ declare class QuantModule {
     /**
      * Get list of available technical indicators
      *
-     * All indicators are functions and require parentheses when used (e.g., MA(20), RSI(14), MACD()).
+     * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
      *
      * @returns Array of indicator definitions
      *
@@ -819,7 +799,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-     * - Functions (with parentheses): MA(20), RSI(14), MACD(), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
      *
      * @param params - Indicator computation parameters
      * @returns Array of indicator data
@@ -851,7 +831,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @returns Array of factor definitions organized by level
      */
@@ -863,7 +843,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Factor computation parameters
      * @returns Array of factor data
@@ -885,7 +865,7 @@ declare class QuantModule {
      * // Close above 20-day MA
      * const data = await client.quant.computeFactors({
      *   symbols: ['000001'],
-     *   formula: 'CLOSE > MA(20)'
+     *   formula: 'CLOSE > MA(CLOSE, 20)'
      * });
      *
      * // Fundamental factors (note: functions require parentheses)
@@ -901,7 +881,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Screening parameters
      * @returns Array of stocks that passed the filter
@@ -915,12 +895,12 @@ declare class QuantModule {
      *
      * // Golden cross
      * const stocks = await client.quant.screen({
-     *   formula: 'CROSS(MA(5), MA(10))'
+     *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
      * // Uptrend
      * const stocks = await client.quant.screen({
-     *   formula: '(CLOSE > MA(20)) & (MA(20) > MA(60))'
+     *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
      * });
      *
      * // Fundamental screening (note: functions require parentheses)
@@ -965,7 +945,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Backtest parameters
      * @returns Backtest results
@@ -977,7 +957,7 @@ declare class QuantModule {
      *   startDate: '2023-01-01',
      *   endDate: '2024-01-01',
      *   symbol: '000001',
-     *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy when MA5 crosses above MA20
+     *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy when MA5 crosses above MA20
      *   initialCash: 100000
      * });
      *
@@ -990,8 +970,8 @@ declare class QuantModule {
      *   startDate: '2023-01-01',
      *   endDate: '2024-01-01',
      *   symbol: '000001',
-     *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy signal
-     *   exitFormula: 'CROSSDOWN(MA(5), MA(20))'  // Sell signal
+     *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy signal
+     *   exitFormula: 'CROSSDOWN(MA(CLOSE, 5), MA(CLOSE, 20))'  // Sell signal
      * });
      *
      * // Fundamental screening backtest (note: functions require parentheses)
@@ -1009,7 +989,7 @@ declare class QuantModule {
      *   symbol: '000001',
      *   entryFormula: 'RSI(14) < 30',
      *   exitFormula: 'RSI(14) > 70',
-     *   labels: { rsi: 'RSI(14)', ma20: 'MA(20)' }
+     *   labels: { rsi: 'RSI(14)', ma20: 'MA(CLOSE, 20)' }
      * });
      * ```
      */

package/dist/index.d.ts

@@ -424,26 +424,6 @@ declare class StockModule {
         startDate?: string;
         endDate?: string;
     }): Promise<PriceData[]>;
-    /**
-     * Screen stocks based on various criteria
-     */
-    screener(options?: {
-        marketCapMoreThan?: number;
-        marketCapLowerThan?: number;
-        priceMoreThan?: number;
-        priceLowerThan?: number;
-        changePercentageMoreThan?: number;
-        changePercentageLowerThan?: number;
-        volumeMoreThan?: number;
-        volumeLowerThan?: number;
-        country?: string;
-        exchange?: string;
-        dividendYieldMoreThan?: number;
-        dividendYieldLowerThan?: number;
-        peTtmMoreThan?: number;
-        peTtmLowerThan?: number;
-        limit?: number;
-    }): Promise<CompanyOverview[]>;
     /**
      * Get earnings announcement calendar
      *
@@ -800,7 +780,7 @@ declare class QuantModule {
     /**
      * Get list of available technical indicators
      *
-     * All indicators are functions and require parentheses when used (e.g., MA(20), RSI(14), MACD()).
+     * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
      *
      * @returns Array of indicator definitions
      *
@@ -819,7 +799,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-     * - Functions (with parentheses): MA(20), RSI(14), MACD(), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
      *
      * @param params - Indicator computation parameters
      * @returns Array of indicator data
@@ -851,7 +831,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @returns Array of factor definitions organized by level
      */
@@ -863,7 +843,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Factor computation parameters
      * @returns Array of factor data
@@ -885,7 +865,7 @@ declare class QuantModule {
      * // Close above 20-day MA
      * const data = await client.quant.computeFactors({
      *   symbols: ['000001'],
-     *   formula: 'CLOSE > MA(20)'
+     *   formula: 'CLOSE > MA(CLOSE, 20)'
      * });
      *
      * // Fundamental factors (note: functions require parentheses)
@@ -901,7 +881,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Screening parameters
      * @returns Array of stocks that passed the filter
@@ -915,12 +895,12 @@ declare class QuantModule {
      *
      * // Golden cross
      * const stocks = await client.quant.screen({
-     *   formula: 'CROSS(MA(5), MA(10))'
+     *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
      * });
      *
      * // Uptrend
      * const stocks = await client.quant.screen({
-     *   formula: '(CLOSE > MA(20)) & (MA(20) > MA(60))'
+     *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
      * });
      *
      * // Fundamental screening (note: functions require parentheses)
@@ -965,7 +945,7 @@ declare class QuantModule {
      *
      * Variables vs Functions:
      * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-     * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+     * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
      *
      * @param params - Backtest parameters
      * @returns Backtest results
@@ -977,7 +957,7 @@ declare class QuantModule {
      *   startDate: '2023-01-01',
      *   endDate: '2024-01-01',
      *   symbol: '000001',
-     *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy when MA5 crosses above MA20
+     *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy when MA5 crosses above MA20
      *   initialCash: 100000
      * });
      *
@@ -990,8 +970,8 @@ declare class QuantModule {
      *   startDate: '2023-01-01',
      *   endDate: '2024-01-01',
      *   symbol: '000001',
-     *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy signal
-     *   exitFormula: 'CROSSDOWN(MA(5), MA(20))'  // Sell signal
+     *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy signal
+     *   exitFormula: 'CROSSDOWN(MA(CLOSE, 5), MA(CLOSE, 20))'  // Sell signal
      * });
      *
      * // Fundamental screening backtest (note: functions require parentheses)
@@ -1009,7 +989,7 @@ declare class QuantModule {
      *   symbol: '000001',
      *   entryFormula: 'RSI(14) < 30',
      *   exitFormula: 'RSI(14) > 70',
-     *   labels: { rsi: 'RSI(14)', ma20: 'MA(20)' }
+     *   labels: { rsi: 'RSI(14)', ma20: 'MA(CLOSE, 20)' }
      * });
      * ```
      */

package/dist/index.js

@@ -265,35 +265,8 @@ var StockModule = class {
     return this.normalizeArrayResponse(response);
   }
   // ===========================================================================
-  // Screening and Calendar
+  // Calendar
   // ===========================================================================
-  /**
-   * Screen stocks based on various criteria
-   */
-  async screener(options = {}) {
-    const body = {
-      limit: options.limit || 100
-    };
-    if (options.marketCapMoreThan !== void 0) body.market_cap_more_than = options.marketCapMoreThan;
-    if (options.marketCapLowerThan !== void 0) body.market_cap_lower_than = options.marketCapLowerThan;
-    if (options.priceMoreThan !== void 0) body.price_more_than = options.priceMoreThan;
-    if (options.priceLowerThan !== void 0) body.price_lower_than = options.priceLowerThan;
-    if (options.changePercentageMoreThan !== void 0) body.change_percentage_more_than = options.changePercentageMoreThan;
-    if (options.changePercentageLowerThan !== void 0) body.change_percentage_lower_than = options.changePercentageLowerThan;
-    if (options.volumeMoreThan !== void 0) body.volume_more_than = options.volumeMoreThan;
-    if (options.volumeLowerThan !== void 0) body.volume_lower_than = options.volumeLowerThan;
-    if (options.country) body.country = options.country;
-    if (options.exchange) body.exchange = options.exchange;
-    if (options.dividendYieldMoreThan !== void 0) body.dividend_yield_more_than = options.dividendYieldMoreThan;
-    if (options.dividendYieldLowerThan !== void 0) body.dividend_yield_lower_than = options.dividendYieldLowerThan;
-    if (options.peTtmMoreThan !== void 0) body.pe_ttm_more_than = options.peTtmMoreThan;
-    if (options.peTtmLowerThan !== void 0) body.pe_ttm_lower_than = options.peTtmLowerThan;
-    const response = await this.client.post(
-      "/v1/stock/screener",
-      body
-    );
-    return this.normalizeArrayResponse(response);
-  }
   /**
    * Get earnings announcement calendar
    *
@@ -663,7 +636,7 @@ var QuantModule = class {
   /**
    * Get list of available technical indicators
    *
-   * All indicators are functions and require parentheses when used (e.g., MA(20), RSI(14), MACD()).
+   * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
    *
    * @returns Array of indicator definitions
    *
@@ -684,7 +657,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-   * - Functions (with parentheses): MA(20), RSI(14), MACD(), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
    *
    * @param params - Indicator computation parameters
    * @returns Array of indicator data
@@ -728,7 +701,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @returns Array of factor definitions organized by level
    */
@@ -742,7 +715,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Factor computation parameters
    * @returns Array of factor data
@@ -764,7 +737,7 @@ var QuantModule = class {
    * // Close above 20-day MA
    * const data = await client.quant.computeFactors({
    *   symbols: ['000001'],
-   *   formula: 'CLOSE > MA(20)'
+   *   formula: 'CLOSE > MA(CLOSE, 20)'
    * });
    *
    * // Fundamental factors (note: functions require parentheses)
@@ -789,7 +762,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Screening parameters
    * @returns Array of stocks that passed the filter
@@ -803,12 +776,12 @@ var QuantModule = class {
    *
    * // Golden cross
    * const stocks = await client.quant.screen({
-   *   formula: 'CROSS(MA(5), MA(10))'
+   *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
    * // Uptrend
    * const stocks = await client.quant.screen({
-   *   formula: '(CLOSE > MA(20)) & (MA(20) > MA(60))'
+   *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
    * });
    *
    * // Fundamental screening (note: functions require parentheses)
@@ -883,7 +856,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Backtest parameters
    * @returns Backtest results
@@ -895,7 +868,7 @@ var QuantModule = class {
    *   startDate: '2023-01-01',
    *   endDate: '2024-01-01',
    *   symbol: '000001',
-   *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy when MA5 crosses above MA20
+   *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy when MA5 crosses above MA20
    *   initialCash: 100000
    * });
    *
@@ -908,8 +881,8 @@ var QuantModule = class {
    *   startDate: '2023-01-01',
    *   endDate: '2024-01-01',
    *   symbol: '000001',
-   *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy signal
-   *   exitFormula: 'CROSSDOWN(MA(5), MA(20))'  // Sell signal
+   *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy signal
+   *   exitFormula: 'CROSSDOWN(MA(CLOSE, 5), MA(CLOSE, 20))'  // Sell signal
    * });
    *
    * // Fundamental screening backtest (note: functions require parentheses)
@@ -927,7 +900,7 @@ var QuantModule = class {
    *   symbol: '000001',
    *   entryFormula: 'RSI(14) < 30',
    *   exitFormula: 'RSI(14) > 70',
-   *   labels: { rsi: 'RSI(14)', ma20: 'MA(20)' }
+   *   labels: { rsi: 'RSI(14)', ma20: 'MA(CLOSE, 20)' }
    * });
    * ```
    */
@@ -1711,7 +1684,7 @@ var Reportify = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "User-Agent": "reportify-sdk-js/0.3.3"
+          "User-Agent": "reportify-sdk-js/0.3.5"
         },
         body: options.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1772,7 +1745,7 @@ var Reportify = class {
       headers: {
         Authorization: `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": "reportify-sdk-typescript/0.3.3"
+        "User-Agent": "reportify-sdk-typescript/0.3.5"
       }
     });
     if (!response.ok) {

package/dist/index.mjs

@@ -223,35 +223,8 @@ var StockModule = class {
     return this.normalizeArrayResponse(response);
   }
   // ===========================================================================
-  // Screening and Calendar
+  // Calendar
   // ===========================================================================
-  /**
-   * Screen stocks based on various criteria
-   */
-  async screener(options = {}) {
-    const body = {
-      limit: options.limit || 100
-    };
-    if (options.marketCapMoreThan !== void 0) body.market_cap_more_than = options.marketCapMoreThan;
-    if (options.marketCapLowerThan !== void 0) body.market_cap_lower_than = options.marketCapLowerThan;
-    if (options.priceMoreThan !== void 0) body.price_more_than = options.priceMoreThan;
-    if (options.priceLowerThan !== void 0) body.price_lower_than = options.priceLowerThan;
-    if (options.changePercentageMoreThan !== void 0) body.change_percentage_more_than = options.changePercentageMoreThan;
-    if (options.changePercentageLowerThan !== void 0) body.change_percentage_lower_than = options.changePercentageLowerThan;
-    if (options.volumeMoreThan !== void 0) body.volume_more_than = options.volumeMoreThan;
-    if (options.volumeLowerThan !== void 0) body.volume_lower_than = options.volumeLowerThan;
-    if (options.country) body.country = options.country;
-    if (options.exchange) body.exchange = options.exchange;
-    if (options.dividendYieldMoreThan !== void 0) body.dividend_yield_more_than = options.dividendYieldMoreThan;
-    if (options.dividendYieldLowerThan !== void 0) body.dividend_yield_lower_than = options.dividendYieldLowerThan;
-    if (options.peTtmMoreThan !== void 0) body.pe_ttm_more_than = options.peTtmMoreThan;
-    if (options.peTtmLowerThan !== void 0) body.pe_ttm_lower_than = options.peTtmLowerThan;
-    const response = await this.client.post(
-      "/v1/stock/screener",
-      body
-    );
-    return this.normalizeArrayResponse(response);
-  }
   /**
    * Get earnings announcement calendar
    *
@@ -621,7 +594,7 @@ var QuantModule = class {
   /**
    * Get list of available technical indicators
    *
-   * All indicators are functions and require parentheses when used (e.g., MA(20), RSI(14), MACD()).
+   * All indicators are functions and require parentheses when used (e.g., MA(CLOSE, 20), RSI(14), MACD()).
    *
    * @returns Array of indicator definitions
    *
@@ -642,7 +615,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME (aliases: C, O, H, L, V, VOL)
-   * - Functions (with parentheses): MA(20), RSI(14), MACD(), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), RSI(14), MACD(), etc.
    *
    * @param params - Indicator computation parameters
    * @returns Array of indicator data
@@ -686,7 +659,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME, PE_TTM, ROE_TTM, etc.
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @returns Array of factor definitions organized by level
    */
@@ -700,7 +673,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Factor computation parameters
    * @returns Array of factor data
@@ -722,7 +695,7 @@ var QuantModule = class {
    * // Close above 20-day MA
    * const data = await client.quant.computeFactors({
    *   symbols: ['000001'],
-   *   formula: 'CLOSE > MA(20)'
+   *   formula: 'CLOSE > MA(CLOSE, 20)'
    * });
    *
    * // Fundamental factors (note: functions require parentheses)
@@ -747,7 +720,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Screening parameters
    * @returns Array of stocks that passed the filter
@@ -761,12 +734,12 @@ var QuantModule = class {
    *
    * // Golden cross
    * const stocks = await client.quant.screen({
-   *   formula: 'CROSS(MA(5), MA(10))'
+   *   formula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 10))'
    * });
    *
    * // Uptrend
    * const stocks = await client.quant.screen({
-   *   formula: '(CLOSE > MA(20)) & (MA(20) > MA(60))'
+   *   formula: '(CLOSE > MA(CLOSE, 20)) & (MA(CLOSE, 20) > MA(CLOSE, 60))'
    * });
    *
    * // Fundamental screening (note: functions require parentheses)
@@ -841,7 +814,7 @@ var QuantModule = class {
    *
    * Variables vs Functions:
    * - Variables (no parentheses): CLOSE, OPEN, HIGH, LOW, VOLUME
-   * - Functions (with parentheses): MA(20), PE(), ROE(), RSI(14), etc.
+   * - Functions (TongDaXin style: col first, n second): MA(CLOSE, 20), PE(), ROE(), RSI(14), etc.
    *
    * @param params - Backtest parameters
    * @returns Backtest results
@@ -853,7 +826,7 @@ var QuantModule = class {
    *   startDate: '2023-01-01',
    *   endDate: '2024-01-01',
    *   symbol: '000001',
-   *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy when MA5 crosses above MA20
+   *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy when MA5 crosses above MA20
    *   initialCash: 100000
    * });
    *
@@ -866,8 +839,8 @@ var QuantModule = class {
    *   startDate: '2023-01-01',
    *   endDate: '2024-01-01',
    *   symbol: '000001',
-   *   entryFormula: 'CROSS(MA(5), MA(20))',  // Buy signal
-   *   exitFormula: 'CROSSDOWN(MA(5), MA(20))'  // Sell signal
+   *   entryFormula: 'CROSS(MA(CLOSE, 5), MA(CLOSE, 20))',  // Buy signal
+   *   exitFormula: 'CROSSDOWN(MA(CLOSE, 5), MA(CLOSE, 20))'  // Sell signal
    * });
    *
    * // Fundamental screening backtest (note: functions require parentheses)
@@ -885,7 +858,7 @@ var QuantModule = class {
    *   symbol: '000001',
    *   entryFormula: 'RSI(14) < 30',
    *   exitFormula: 'RSI(14) > 70',
-   *   labels: { rsi: 'RSI(14)', ma20: 'MA(20)' }
+   *   labels: { rsi: 'RSI(14)', ma20: 'MA(CLOSE, 20)' }
    * });
    * ```
    */
@@ -1669,7 +1642,7 @@ var Reportify = class {
         headers: {
           Authorization: `Bearer ${this.apiKey}`,
           "Content-Type": "application/json",
-          "User-Agent": "reportify-sdk-js/0.3.3"
+          "User-Agent": "reportify-sdk-js/0.3.5"
         },
         body: options.body ? JSON.stringify(options.body) : void 0,
         signal: controller.signal
@@ -1730,7 +1703,7 @@ var Reportify = class {
       headers: {
         Authorization: `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": "reportify-sdk-typescript/0.3.3"
+        "User-Agent": "reportify-sdk-typescript/0.3.5"
       }
     });
     if (!response.ok) {

package/package.json

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