feat(fundamental): add macroeconomic_indicators_v2 and macroeconomic_v2 methods (v2 endpoints)

CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.3.2] - 2026-06-13
+
+### Added
+
+- **All languages:** `macroeconomic_indicators` gains `keyword` parameter for fuzzy name filtering
+- **All languages:** `macroeconomic` switches to `GET /v2/quote/macrodata/{id}`, defaults to `sort=desc`
+
+### Changed
+
+- `MacroeconomicIndicator.name` / `.describe`: `MultiLanguageText` → `string`
+- `Macroeconomic.unit` / `.unit_prefix`: `MultiLanguageText` → `string`
+
 ## [4.3.1] - 2026-06-12
 
 ### Added

Cargo.toml

@@ -3,7 +3,7 @@ resolver = "3"
 members = ["rust", "python", "nodejs", "java", "c"]
 
 [workspace.package]
-version = "4.3.1"
+version = "4.3.2"
 edition = "2024"
 
 [profile.release]

java/javasrc/src/main/java/com/longbridge/SdkNative.java

@@ -452,7 +452,7 @@ public static native void fundamentalContextGetFinancialReportSnapshot(long cont
                         AsyncCallback callback);
 
         public static native void fundamentalContextMacroeconomicIndicators(long context,
-                        Object country, Object offset, Object limit,
+                        Object country, Object keyword, Object offset, Object limit,
                         AsyncCallback callback);
 
         public static native void fundamentalContextMacroeconomic(long context,

java/javasrc/src/main/java/com/longbridge/fundamental/FundamentalContext.java

@@ -339,9 +339,9 @@ public CompletableFuture<ValuationComparisonResponse> getValuationComparison(Val
      * List macroeconomic indicators.
      * country: ISO country code string (e.g. "US", "CN", "EU"); pass null for all countries.
      */
-    public CompletableFuture<MacroeconomicIndicatorListResponse> getMacroeconomicIndicators(String country, Integer offset, Integer limit) throws OpenApiException {
+    public CompletableFuture<MacroeconomicIndicatorListResponse> getMacroeconomicIndicators(String country, String keyword, Integer offset, Integer limit) throws OpenApiException {
         return AsyncCallback.executeTask((callback) -> {
-            SdkNative.fundamentalContextMacroeconomicIndicators(raw, country, offset, limit, callback);
+            SdkNative.fundamentalContextMacroeconomicIndicators(raw, country, keyword, offset, limit, callback);
         });
     }
 
@@ -354,4 +354,10 @@ public CompletableFuture<MacroeconomicResponse> getMacroeconomic(String indicato
             SdkNative.fundamentalContextMacroeconomic(raw, indicatorCode, startDate, endDate, offset, limit, callback);
         });
     }
+
+    /**
+     * List macroeconomic indicators (v2) with optional keyword filter.
+     * country: "HK","CN","US","EU","JP","SG" or null for ALL.
+     * keyword: optional fuzzy filter on indicator name.
+     */
 }

java/javasrc/src/main/java/com/longbridge/fundamental/Macroeconomic.java

@@ -10,6 +10,6 @@ public class Macroeconomic {
     public String forecastValue;
     public String revisedValue;
     public String nextReleaseAt;
-    public MultiLanguageText unit;
-    public MultiLanguageText unitPrefix;
+    public String unit;
+    public String unitPrefix;
 }

java/javasrc/src/main/java/com/longbridge/fundamental/MacroeconomicIndicator.java

@@ -6,12 +6,12 @@ public class MacroeconomicIndicator {
     public String indicatorCode;
     public String sourceOrg;
     public String country;
-    public MultiLanguageText name;
+    public String name;
     public String adjustmentFactor;
     /** Release periodicity (e.g. monthly / quarterly). */
     public String periodicity;
     public String category;
-    public MultiLanguageText describe;
+    public String describe;
     /** Importance — higher is more important. */
     public int importance;
     /** Start date of data coverage (unix timestamp string). */

java/src/fundamental_context.rs

@@ -269,6 +269,7 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_fundamentalContextMa
     _class: JClass,
     context: i64,
     country: JObject,
+    keyword: JObject,
     offset: JObject,
     limit: JObject,
     callback: JObject,
@@ -288,12 +289,13 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_fundamentalContextMa
                 _ => None,
             }
         });
+        let keyword: Option<String> = FromJValue::from_jvalue(env, keyword.into())?;
         let offset: Option<i32> = FromJValue::from_jvalue(env, offset.into())?;
         let limit: Option<i32> = FromJValue::from_jvalue(env, limit.into())?;
         async_util::execute(env, callback, async move {
             Ok(context
                 .ctx
-                .macroeconomic_indicators(country, offset, limit)
+                .macroeconomic_indicators(country, keyword, offset, limit)
                 .await?)
         })?;
         Ok(())

nodejs/index.d.ts

@@ -622,6 +622,10 @@ export declare class FundamentalContext {
   macroeconomicIndicators(country?: MacroeconomicCountry | undefined | null, offset?: number | undefined | null, limit?: number | undefined | null): Promise<MacroeconomicIndicatorListResponse>
   /** Get historical data for a macroeconomic indicator */
   macroeconomic(indicatorCode: string, startDate?: string | undefined | null, endDate?: string | undefined | null, offset?: number | undefined | null, limit?: number | undefined | null): Promise<MacroeconomicResponse>
+  /** List macroeconomic indicators (v2) with optional keyword filter */
+  macroeconomicIndicatorsV2(country?: MacroeconomicCountry | undefined | null, keyword?: string | undefined | null, offset?: number | undefined | null, limit?: number | undefined | null): Promise<MacroeconomicIndicatorListResponse>
+  /** Get historical data for a macroeconomic indicator (v2) with sort support */
+  macroeconomicV2(indicatorCode: string, startDate?: string | undefined | null, endDate?: string | undefined | null, offset?: number | undefined | null, limit?: number | undefined | null, sort?: string | undefined | null): Promise<MacroeconomicResponse>
 }
 
 /** Fund position */
@@ -4488,8 +4492,8 @@ export interface Macroeconomic {
   revisedValue: string
   /** Next release datetime (unix timestamp in seconds; null if unset) */
   nextReleaseAt?: number
-  unit: MultiLanguageText
-  unitPrefix: MultiLanguageText
+  unit: string
+  unitPrefix: string
 }
 
 /** Country code for filtering macroeconomic indicators */
@@ -4513,11 +4517,11 @@ export interface MacroeconomicIndicator {
   indicatorCode: string
   sourceOrg: string
   country: string
-  name: MultiLanguageText
+  name: string
   adjustmentFactor: string
   periodicity: string
   category: string
-  describe: MultiLanguageText
+  describe: string
   importance: number
   /** Start date of data coverage (unix timestamp in seconds; null if unset) */
   startDate?: number

nodejs/index.js

@@ -689,7 +689,7 @@ module.exports.FlowDirection = nativeBinding.FlowDirection
 module.exports.Granularity = nativeBinding.Granularity
 module.exports.InstitutionRecommend = nativeBinding.InstitutionRecommend
 module.exports.Language = nativeBinding.Language
-module.exports.MacrodataCountry = nativeBinding.MacrodataCountry
+module.exports.MacroeconomicCountry = nativeBinding.MacroeconomicCountry
 module.exports.Market = nativeBinding.Market
 module.exports.OptionDirection = nativeBinding.OptionDirection
 module.exports.OptionType = nativeBinding.OptionType

nodejs/src/fundamental/context.rs

@@ -293,12 +293,13 @@ impl FundamentalContext {
     pub async fn macroeconomic_indicators(
         &self,
         country: Option<MacroeconomicCountry>,
+        keyword: Option<String>,
         offset: Option<i32>,
         limit: Option<i32>,
     ) -> Result<MacroeconomicIndicatorListResponse> {
         Ok(self
             .ctx
-            .macroeconomic_indicators(country.map(Into::into), offset, limit)
+            .macroeconomic_indicators(country.map(Into::into), keyword, offset, limit)
             .await
             .map_err(ErrorNewType)?
             .into())

nodejs/src/fundamental/types.rs

@@ -1979,11 +1979,11 @@ pub struct MacroeconomicIndicator {
     pub indicator_code: String,
     pub source_org: String,
     pub country: String,
-    pub name: MultiLanguageText,
+    pub name: String,
     pub adjustment_factor: String,
     pub periodicity: String,
     pub category: String,
-    pub describe: MultiLanguageText,
+    pub describe: String,
     pub importance: i32,
     /// Start date of data coverage (unix timestamp in seconds; null if unset)
     pub start_date: Option<i64>,
@@ -1995,11 +1995,11 @@ impl From<lb::MacroeconomicIndicator> for MacroeconomicIndicator {
             indicator_code: v.indicator_code,
             source_org: v.source_org,
             country: v.country,
-            name: v.name.into(),
+            name: v.name,
             adjustment_factor: v.adjustment_factor,
             periodicity: v.periodicity,
             category: v.category,
-            describe: v.describe.into(),
+            describe: v.describe,
             importance: v.importance,
             start_date: v.start_date.map(|dt| dt.unix_timestamp()),
         }
@@ -2019,8 +2019,8 @@ pub struct Macroeconomic {
     pub revised_value: String,
     /// Next release datetime (unix timestamp in seconds; null if unset)
     pub next_release_at: Option<i64>,
-    pub unit: MultiLanguageText,
-    pub unit_prefix: MultiLanguageText,
+    pub unit: String,
+    pub unit_prefix: String,
 }
 
 impl From<lb::Macroeconomic> for Macroeconomic {
@@ -2033,8 +2033,8 @@ impl From<lb::Macroeconomic> for Macroeconomic {
             forecast_value: v.forecast_value,
             revised_value: v.revised_value,
             next_release_at: v.next_release_at.map(|dt| dt.unix_timestamp()),
-            unit: v.unit.into(),
-            unit_prefix: v.unit_prefix.into(),
+            unit: v.unit,
+            unit_prefix: v.unit_prefix,
         }
     }
 }

python/pysrc/longbridge/openapi.pyi

@@ -10118,12 +10118,12 @@ class MacroeconomicIndicator:
     """External vendor code (input to macroeconomic)"""
     source_org: str
     country: str
-    name: MultiLanguageText
+    name: str
     adjustment_factor: str
     periodicity: str
     """Release periodicity (e.g. monthly / quarterly)"""
     category: str
-    describe: MultiLanguageText
+    describe: str
     importance: int
     start_date: datetime | None
     """Start date of data coverage"""
@@ -10140,8 +10140,8 @@ class Macroeconomic:
     forecast_value: str
     revised_value: str
     next_release_at: datetime | None
-    unit: MultiLanguageText
-    unit_prefix: MultiLanguageText
+    unit: str
+    unit_prefix: str
 
 
 class MacroeconomicResponse:

python/src/fundamental/context.rs

@@ -213,12 +213,13 @@ impl FundamentalContext {
     fn macroeconomic_indicators(
         &self,
         country: Option<MacroeconomicCountry>,
+        keyword: Option<String>,
         offset: Option<i32>,
         limit: Option<i32>,
     ) -> PyResult<MacroeconomicIndicatorListResponse> {
         Ok(self
             .ctx
-            .macroeconomic_indicators(country.map(Into::into), offset, limit)
+            .macroeconomic_indicators(country.map(Into::into), keyword, offset, limit)
             .map_err(ErrorNewType)?
             .into())
     }

python/src/fundamental/context_async.rs

@@ -323,13 +323,14 @@ impl AsyncFundamentalContext {
         &self,
         py: Python<'_>,
         country: Option<MacroeconomicCountry>,
+        keyword: Option<String>,
         offset: Option<i32>,
         limit: Option<i32>,
     ) -> PyResult<Py<PyAny>> {
         let ctx = self.ctx.clone();
         pyo3_async_runtimes::tokio::future_into_py(py, async move {
             Ok(MacroeconomicIndicatorListResponse::from(
-                ctx.macroeconomic_indicators(country.map(Into::into), offset, limit)
+                ctx.macroeconomic_indicators(country.map(Into::into), keyword, offset, limit)
                     .await
                     .map_err(ErrorNewType)?,
             ))

python/src/fundamental/types.rs

@@ -2036,11 +2036,11 @@ pub(crate) struct MacroeconomicIndicator {
     pub indicator_code: String,
     pub source_org: String,
     pub country: String,
-    pub name: MultiLanguageText,
+    pub name: String,
     pub adjustment_factor: String,
     pub periodicity: String,
     pub category: String,
-    pub describe: MultiLanguageText,
+    pub describe: String,
     pub importance: i32,
     pub start_date: Option<crate::time::PyOffsetDateTimeWrapper>,
 }
@@ -2051,11 +2051,11 @@ impl From<lb::MacroeconomicIndicator> for MacroeconomicIndicator {
             indicator_code: v.indicator_code,
             source_org: v.source_org,
             country: v.country,
-            name: v.name.into(),
+            name: v.name,
             adjustment_factor: v.adjustment_factor,
             periodicity: v.periodicity,
             category: v.category,
-            describe: v.describe.into(),
+            describe: v.describe,
             importance: v.importance,
             start_date: v.start_date.map(crate::time::PyOffsetDateTimeWrapper),
         }
@@ -2073,8 +2073,8 @@ pub(crate) struct Macroeconomic {
     pub forecast_value: String,
     pub revised_value: String,
     pub next_release_at: Option<crate::time::PyOffsetDateTimeWrapper>,
-    pub unit: MultiLanguageText,
-    pub unit_prefix: MultiLanguageText,
+    pub unit: String,
+    pub unit_prefix: String,
 }
 
 impl From<lb::Macroeconomic> for Macroeconomic {
@@ -2087,8 +2087,8 @@ impl From<lb::Macroeconomic> for Macroeconomic {
             forecast_value: v.forecast_value,
             revised_value: v.revised_value,
             next_release_at: v.next_release_at.map(crate::time::PyOffsetDateTimeWrapper),
-            unit: v.unit.into(),
-            unit_prefix: v.unit_prefix.into(),
+            unit: v.unit,
+            unit_prefix: v.unit_prefix,
         }
     }
 }

rust/src/blocking/fundamental.rs

@@ -295,11 +295,13 @@ impl FundamentalContextSync {
     pub fn macroeconomic_indicators(
         &self,
         country: Option<MacroeconomicCountry>,
+        keyword: Option<impl Into<String> + Send + 'static>,
         offset: Option<i32>,
         limit: Option<i32>,
     ) -> Result<MacroeconomicIndicatorListResponse> {
         self.rt.call(move |ctx| async move {
-            ctx.macroeconomic_indicators(country, offset, limit).await
+            ctx.macroeconomic_indicators(country, keyword, offset, limit)
+                .await
         })
     }
 
@@ -317,4 +319,34 @@ impl FundamentalContextSync {
                 .await
         })
     }
+
+    /// List macroeconomic indicators (v2) with optional keyword filter
+    pub(crate) fn macroeconomic_indicators_v2(
+        &self,
+        country: Option<MacroeconomicCountry>,
+        keyword: Option<impl Into<String> + Send + 'static>,
+        offset: Option<i32>,
+        limit: Option<i32>,
+    ) -> Result<MacroeconomicIndicatorListResponse> {
+        self.rt.call(move |ctx| async move {
+            ctx.macroeconomic_indicators_v2(country, keyword, offset, limit)
+                .await
+        })
+    }
+
+    /// Get historical data for a macroeconomic indicator (v2) with sort support
+    pub(crate) fn macroeconomic_v2(
+        &self,
+        indicator_code: impl Into<String> + Send + 'static,
+        start_date: Option<impl Into<String> + Send + 'static>,
+        end_date: Option<impl Into<String> + Send + 'static>,
+        offset: Option<i32>,
+        limit: Option<i32>,
+        sort: Option<impl Into<String> + Send + 'static>,
+    ) -> Result<MacroeconomicResponse> {
+        self.rt.call(move |ctx| async move {
+            ctx.macroeconomic_v2(indicator_code, start_date, end_date, offset, limit, sort)
+                .await
+        })
+    }
 }