feat(fundamental): add macroeconomic_indicators and macroeconomic methods

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.1] - 2026-06-12
+
+### Added
+
+- **All languages:** `FundamentalContext` gains `macroeconomic_indicators(country, offset, limit)` — list macroeconomic indicators via `GET /v1/quote/macrodata`; filter by country (`MacroeconomicCountry::HongKong / China / UnitedStates / EuroZone / Japan / Singapore`); response includes `count` (total matching)
+- **All languages:** `FundamentalContext` gains `macroeconomic(indicator_code, start_date, end_date, offset, limit)` — historical data for a specific indicator via `GET /v1/quote/macrodata/{indicator_code}`; `start_date` / `end_date` accept `"YYYY-MM-DD"` strings; response includes `count` (total data points)
+- New types: `MultiLanguageText`, `MacroeconomicCountry`, `MacroeconomicImportance`, `MacroeconomicIndicator`, `MacroeconomicIndicatorListResponse`, `Macroeconomic`, `MacroeconomicResponse`
+
+### Fixed
+
+- `MacroeconomicIndicator.describe` / `name` / `MacroeconomicResponse.info`: handle `null` responses from API without deserializing error
+
 ## [4.3.0]
 
 ### Added

Cargo.toml

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

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

@@ -451,6 +451,14 @@ public static native void fundamentalContextGetFinancialReportSnapshot(long cont
                         Object opts,
                         AsyncCallback callback);
 
+        public static native void fundamentalContextMacroeconomicIndicators(long context,
+                        Object country, Object offset, Object limit,
+                        AsyncCallback callback);
+
+        public static native void fundamentalContextMacroeconomic(long context,
+                        Object indicatorCode, Object startTime, Object endTime, Object offset, Object limit,
+                        AsyncCallback callback);
+
         public static native void portfolioContextProfitAnalysisFlows(long context, Object opts,
                         AsyncCallback callback);
 

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

@@ -334,4 +334,24 @@ public CompletableFuture<ValuationComparisonResponse> getValuationComparison(Val
             SdkNative.fundamentalContextValuationComparison(raw, opts, callback);
         });
     }
+
+    /**
+     * 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 {
+        return AsyncCallback.executeTask((callback) -> {
+            SdkNative.fundamentalContextMacroeconomicIndicators(raw, country, offset, limit, callback);
+        });
+    }
+
+    /**
+     * Get historical data for a macroeconomic indicator.
+     * startDate and endDate are date strings in "YYYY-MM-DD" format.
+     */
+    public CompletableFuture<MacroeconomicResponse> getMacroeconomic(String indicatorCode, String startDate, String endDate, Integer offset, Integer limit) throws OpenApiException {
+        return AsyncCallback.executeTask((callback) -> {
+            SdkNative.fundamentalContextMacroeconomic(raw, indicatorCode, startDate, endDate, offset, limit, callback);
+        });
+    }
 }

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

@@ -0,0 +1,15 @@
+package com.longbridge.fundamental;
+
+/** One historical data point for a macroeconomic indicator. */
+public class Macroeconomic {
+    /** Statistical period (e.g. 2024-Q1, 2024-03). */
+    public String period;
+    public String releaseAt;
+    public String actualValue;
+    public String previousValue;
+    public String forecastValue;
+    public String revisedValue;
+    public String nextReleaseAt;
+    public MultiLanguageText unit;
+    public MultiLanguageText unitPrefix;
+}

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

@@ -0,0 +1,19 @@
+package com.longbridge.fundamental;
+
+/** Metadata for one macroeconomic indicator. */
+public class MacroeconomicIndicator {
+    /** External vendor code (input to getEconomicIndicator). */
+    public String indicatorCode;
+    public String sourceOrg;
+    public String country;
+    public MultiLanguageText name;
+    public String adjustmentFactor;
+    /** Release periodicity (e.g. monthly / quarterly). */
+    public String periodicity;
+    public String category;
+    public MultiLanguageText describe;
+    /** Importance — higher is more important. */
+    public int importance;
+    /** Start date of data coverage (unix timestamp string). */
+    public String startDate;
+}

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

@@ -0,0 +1,8 @@
+package com.longbridge.fundamental;
+
+/** Response for {@link FundamentalContext#getMacroeconomicIndicators}. */
+public class MacroeconomicIndicatorListResponse {
+    public MacroeconomicIndicator[] data;
+    /** Total number of indicators matching the query. */
+    public int count;
+}

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

@@ -0,0 +1,9 @@
+package com.longbridge.fundamental;
+
+/** Response for {@link FundamentalContext#getMacroeconomic}. */
+public class MacroeconomicResponse {
+    public MacroeconomicIndicator info;
+    public Macroeconomic[] data;
+    /** Total number of historical data points. */
+    public int count;
+}

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

@@ -0,0 +1,8 @@
+package com.longbridge.fundamental;
+
+/** Localized text in simplified Chinese, traditional Chinese, and English. */
+public class MultiLanguageText {
+    public String english;
+    public String simplifiedChinese;
+    public String traditionalChinese;
+}

java/src/fundamental_context.rs

@@ -262,3 +262,69 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_fundamentalContextVa
         Ok(())
     })
 }
+
+#[unsafe(no_mangle)]
+pub unsafe extern "system" fn Java_com_longbridge_SdkNative_fundamentalContextMacroeconomicIndicators(
+    mut env: JNIEnv,
+    _class: JClass,
+    context: i64,
+    country: JObject,
+    offset: JObject,
+    limit: JObject,
+    callback: JObject,
+) {
+    jni_result(&mut env, (), |env| {
+        let context = &*(context as *const ContextObj);
+        let country: Option<String> = FromJValue::from_jvalue(env, country.into())?;
+        let country = country.and_then(|s| {
+            use longbridge::fundamental::MacroeconomicCountry::*;
+            match s.as_str() {
+                "HK" | "Hong Kong SAR China" => Some(HongKong),
+                "CN" | "China (Mainland)" => Some(China),
+                "US" | "United States" => Some(UnitedStates),
+                "EU" | "Euro Zone" => Some(EuroZone),
+                "JP" | "Japan" => Some(Japan),
+                "SG" | "Singapore" => Some(Singapore),
+                _ => None,
+            }
+        });
+        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)
+                .await?)
+        })?;
+        Ok(())
+    })
+}
+
+#[unsafe(no_mangle)]
+pub unsafe extern "system" fn Java_com_longbridge_SdkNative_fundamentalContextMacroeconomic(
+    mut env: JNIEnv,
+    _class: JClass,
+    context: i64,
+    indicator_code: JObject,
+    start_time: JObject,
+    end_time: JObject,
+    offset: JObject,
+    limit: JObject,
+    callback: JObject,
+) {
+    jni_result(&mut env, (), |env| {
+        let context = &*(context as *const ContextObj);
+        let indicator_code: String = FromJValue::from_jvalue(env, indicator_code.into())?;
+        let start_date: Option<String> = FromJValue::from_jvalue(env, start_time.into())?;
+        let end_date: Option<String> = FromJValue::from_jvalue(env, end_time.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(indicator_code, start_date, end_date, offset, limit)
+                .await?)
+        })?;
+        Ok(())
+    })
+}

java/src/types/classes.rs

@@ -2698,6 +2698,66 @@ impl_java_class!(
     ]
 );
 
+impl_java_class!(
+    "com/longbridge/fundamental/MultiLanguageText",
+    longbridge::fundamental::MultiLanguageText,
+    [english, simplified_chinese, traditional_chinese]
+);
+
+impl_java_class!(
+    "com/longbridge/fundamental/MacroeconomicIndicator",
+    longbridge::fundamental::MacroeconomicIndicator,
+    [
+        indicator_code,
+        source_org,
+        country,
+        name,
+        adjustment_factor,
+        periodicity,
+        category,
+        describe,
+        importance,
+        start_date
+    ]
+);
+
+impl_java_class!(
+    "com/longbridge/fundamental/Macroeconomic",
+    longbridge::fundamental::Macroeconomic,
+    [
+        period,
+        release_at,
+        actual_value,
+        previous_value,
+        forecast_value,
+        revised_value,
+        next_release_at,
+        unit,
+        unit_prefix
+    ]
+);
+
+impl_java_class!(
+    "com/longbridge/fundamental/MacroeconomicIndicatorListResponse",
+    longbridge::fundamental::MacroeconomicIndicatorListResponse,
+    [
+        #[java(objarray)]
+        data,
+        count
+    ]
+);
+
+impl_java_class!(
+    "com/longbridge/fundamental/MacroeconomicResponse",
+    longbridge::fundamental::MacroeconomicResponse,
+    [
+        info,
+        #[java(objarray)]
+        data,
+        count
+    ]
+);
+
 // ── MarketContext: top movers / rank ──────────────────────────────
 
 impl_java_class!(

nodejs/index.d.ts

@@ -618,6 +618,10 @@ export declare class FundamentalContext {
    * industry)
    */
   etfAssetAllocation(symbol: string): Promise<AssetAllocationResponse>
+  /** List macroeconomic indicators */
+  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>
 }
 
 /** Fund position */
@@ -4473,6 +4477,65 @@ export declare const enum Language {
   EN = 2
 }
 
+/** One historical data point for a macroeconomic indicator */
+export interface Macroeconomic {
+  period: string
+  /** Release datetime (unix timestamp in seconds; null if unset) */
+  releaseAt?: number
+  actualValue: string
+  previousValue: string
+  forecastValue: string
+  revisedValue: string
+  /** Next release datetime (unix timestamp in seconds; null if unset) */
+  nextReleaseAt?: number
+  unit: MultiLanguageText
+  unitPrefix: MultiLanguageText
+}
+
+/** Country code for filtering macroeconomic indicators */
+export declare const enum MacroeconomicCountry {
+  /** Hong Kong SAR China */
+  HongKong = 0,
+  /** China (Mainland) */
+  China = 1,
+  /** United States */
+  UnitedStates = 2,
+  /** Euro Zone */
+  EuroZone = 3,
+  /** Japan */
+  Japan = 4,
+  /** Singapore */
+  Singapore = 5
+}
+
+/** Metadata for one macroeconomic indicator */
+export interface MacroeconomicIndicator {
+  indicatorCode: string
+  sourceOrg: string
+  country: string
+  name: MultiLanguageText
+  adjustmentFactor: string
+  periodicity: string
+  category: string
+  describe: MultiLanguageText
+  importance: number
+  /** Start date of data coverage (unix timestamp in seconds; null if unset) */
+  startDate?: number
+}
+
+/** Response for macroeconomic_indicators */
+export interface MacroeconomicIndicatorListResponse {
+  data: Array<MacroeconomicIndicator>
+  count: number
+}
+
+/** Response for macroeconomic */
+export interface MacroeconomicResponse {
+  info: MacroeconomicIndicator
+  data: Array<Macroeconomic>
+  count: number
+}
+
 export declare const enum Market {
   /** Unknown */
   Unknown = 0,
@@ -4515,6 +4578,13 @@ export interface MarketTimeItem {
   delaySubStatus: number
 }
 
+/** Localized text in simplified Chinese, traditional Chinese, and English */
+export interface MultiLanguageText {
+  english: string
+  simplifiedChinese: string
+  traditionalChinese: string
+}
+
 /** Options for listing topics created by the current authenticated user */
 export interface MyTopicsRequest {
   /** Page number (default 1) */

nodejs/index.js

@@ -689,6 +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.Market = nativeBinding.Market
 module.exports.OptionDirection = nativeBinding.OptionDirection
 module.exports.OptionType = nativeBinding.OptionType