feat(fundamental): add macroeconomic_indicators and macroeconomic methods (#540)

## Summary

Two new methods on `FundamentalContext` across all language SDKs (Rust,
Python, Node.js, Java):

- `macroeconomic_indicators(country, offset, limit)` — `GET
/v1/quote/macrodata` — list macroeconomic indicators; filter by country;
response includes `count` (total matching)
- `macroeconomic(indicator_code, start_date, end_date, offset, limit)` —
`GET /v1/quote/macrodata/{indicator_code}` — historical data for a
specific indicator; `start_date` / `end_date` accept `"YYYY-MM-DD"`
strings; response includes `count` (total data points)

## New Types

| Type | Description |
|------|-------------|
| `MultiLanguageText` | Localized text (English / Simplified Chinese /
Traditional Chinese) |
| `MacroeconomicCountry` | Country filter enum: `HongKong` / `China` /
`UnitedStates` / `EuroZone` / `Japan` / `Singapore` (SDK accepts short
codes, converts to full names for API) |
| `MacroeconomicImportance` | Importance level: `Low=1` / `Medium=2` /
`High=3` |
| `MacroeconomicIndicator` | Indicator metadata (code, country,
category, periodicity, importance, etc.) |
| `MacroeconomicIndicatorListResponse` | `data:
Vec<MacroeconomicIndicator>` + `count: i32` |
| `Macroeconomic` | One historical data point (period,
actual/previous/forecast/revised values, release timestamps, unit) |
| `MacroeconomicResponse` | `info: MacroeconomicIndicator` + `data:
Vec<Macroeconomic>` + `count: i32` |

## Fixes

- `MacroeconomicIndicator.describe` / `name` /
`MacroeconomicResponse.info`: handle `null` API responses without
deserializing error

## Related

- Go SDK: longbridge/openapi-go#99

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Author: hogan-yuan

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(())
+    })
+}