feat(screener): migrate to /v1/quote/ai/screener/* endpoints (#530)

## Summary

Migrates all screener endpoints from `/v1/quote/screener/*` to
`/v1/quote/ai/screener/*` per [longbridge-terminal PR
#217](longbridge/longbridge-terminal#217).

## Changes

| Old endpoint | New endpoint |
|---|---|
| `GET /v1/quote/screener/strategies/recommend` | `GET
/v1/quote/ai/screener/strategies/recommend` |
| `GET /v1/quote/screener/strategies/mine` | `GET
/v1/quote/ai/screener/strategies/mine` |
| `GET /v1/quote/screener/strategy?id=N` | `GET
/v1/quote/ai/screener/strategy/{id}` |
| `POST /v1/quote/screener/search` | `POST /v1/quote/ai/screener/search`
|
| `GET /v1/quote/screener/indicators` | `GET
/v1/quote/ai/screener/indicators` |

### Breaking changes

- `screener_recommend_strategies(market)` and
`screener_user_strategies(market)` now require a `market` parameter
(Rust/Python/Node.js/Java/C)
- `screener_strategy(id)` uses path param instead of query param

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

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

Author: hogan-yuan

CHANGELOG.md

@@ -4,6 +4,16 @@ 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.2.1]
+
+### Changed
+
+- `ScreenerContext`: screener endpoints migrated to `/v1/quote/ai/screener/*`; `screener_recommend_strategies` / `screener_user_strategies` now accept a `market` parameter; `screener_search` accepts typed `ScreenerCondition` objects (Mode B) instead of raw strings
+
+### Fixed
+
+- `OperatingFinancial`: renamed `counter_id` → `symbol` (converts `ST/US/AAPL` → `AAPL.US`)
+
 ## [4.2.0]
 
 ### Added

Cargo.toml

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

c/csrc/include/longbridge.h

@@ -10193,6 +10193,7 @@ void lb_screener_context_release(const struct lb_screener_context_t *ctx);
  * Returns `CScreenerRecommendStrategiesResponse`.
  */
 void lb_screener_context_recommend_strategies(const struct lb_screener_context_t *ctx,
+                                              const char *market,
                                               lb_async_callback_t callback,
                                               void *userdata);
 
@@ -10201,6 +10202,7 @@ void lb_screener_context_recommend_strategies(const struct lb_screener_context_t
  * Returns `CScreenerUserStrategiesResponse`.
  */
 void lb_screener_context_user_strategies(const struct lb_screener_context_t *ctx,
+                                         const char *market,
                                          lb_async_callback_t callback,
                                          void *userdata);
 

c/src/screener_context/context.rs

@@ -38,14 +38,16 @@ pub unsafe extern "C" fn lb_screener_context_release(ctx: *const CScreenerContex
 #[unsafe(no_mangle)]
 pub unsafe extern "C" fn lb_screener_context_recommend_strategies(
     ctx: *const CScreenerContext,
+    market: *const c_char,
     callback: CAsyncCallback,
     userdata: *mut c_void,
 ) {
     let ctx_inner = (*ctx).ctx.clone();
+    let market = cstr_to_rust(market);
     execute_async(callback, ctx, userdata, async move {
         let resp: CCow<CScreenerRecommendStrategiesResponseOwned> =
             CCow::new(CScreenerRecommendStrategiesResponseOwned::from(
-                ctx_inner.screener_recommend_strategies().await?,
+                ctx_inner.screener_recommend_strategies(market).await?,
             ));
         Ok(resp)
     });
@@ -56,14 +58,17 @@ pub unsafe extern "C" fn lb_screener_context_recommend_strategies(
 #[unsafe(no_mangle)]
 pub unsafe extern "C" fn lb_screener_context_user_strategies(
     ctx: *const CScreenerContext,
+    market: *const c_char,
     callback: CAsyncCallback,
     userdata: *mut c_void,
 ) {
     let ctx_inner = (*ctx).ctx.clone();
+    let market = cstr_to_rust(market);
     execute_async(callback, ctx, userdata, async move {
-        let resp: CCow<CScreenerUserStrategiesResponseOwned> = CCow::new(
-            CScreenerUserStrategiesResponseOwned::from(ctx_inner.screener_user_strategies().await?),
-        );
+        let resp: CCow<CScreenerUserStrategiesResponseOwned> =
+            CCow::new(CScreenerUserStrategiesResponseOwned::from(
+                ctx_inner.screener_user_strategies(market).await?,
+            ));
         Ok(resp)
     });
 }
@@ -110,7 +115,7 @@ pub unsafe extern "C" fn lb_screener_context_search(
         let resp: CCow<CScreenerSearchResponseOwned> =
             CCow::new(CScreenerSearchResponseOwned::from(
                 ctx_inner
-                    .screener_search(market, strategy_id, page, size)
+                    .screener_search(market, strategy_id, vec![], vec![], page, size)
                     .await?,
             ));
         Ok(resp)

cpp/include/screener_context.hpp

@@ -24,11 +24,13 @@ class ScreenerContext
 
   static ScreenerContext create(const Config& config);
 
-  /// Get recommended built-in screener strategies (raw JSON string)
-  void screener_recommend_strategies(AsyncCallback<ScreenerContext, std::string> callback) const;
+  /// Get preset screener strategies for a given market (raw JSON string)
+  void screener_recommend_strategies(const std::string& market,
+                                     AsyncCallback<ScreenerContext, std::string> callback) const;
 
   /// Get the current user's saved screener strategies (raw JSON string)
-  void screener_user_strategies(AsyncCallback<ScreenerContext, std::string> callback) const;
+  void screener_user_strategies(const std::string& market,
+                                AsyncCallback<ScreenerContext, std::string> callback) const;
 
   /// Get detail for one screener strategy by ID (raw JSON string)
   void screener_strategy(int64_t id, AsyncCallback<ScreenerContext, std::string> callback) const;

cpp/src/screener_context.cpp

@@ -8,8 +8,7 @@ extern "C" {
 const lb_screener_context_t* lb_screener_context_new(const lb_config_t* config);
 void lb_screener_context_retain(const lb_screener_context_t* ctx);
 void lb_screener_context_release(const lb_screener_context_t* ctx);
-void lb_screener_context_recommend_strategies(const lb_screener_context_t*, lb_async_callback_t, void*);
-void lb_screener_context_user_strategies(const lb_screener_context_t*, lb_async_callback_t, void*);
+// Declarations already present in longbridge.h (with market param) — no need to redeclare.
 void lb_screener_context_strategy(const lb_screener_context_t*, int64_t, lb_async_callback_t, void*);
 void lb_screener_context_search(const lb_screener_context_t*, const char*, int64_t, bool, uint32_t, uint32_t, lb_async_callback_t, void*);
 void lb_screener_context_indicators(const lb_screener_context_t*, lb_async_callback_t, void*);
@@ -39,12 +38,12 @@ ScreenerContext ScreenerContext::create(const Config& config) {
   else{(*cb)(AsyncResult<ScreenerContext,std::string>(sctx,std::move(status),nullptr));} \
 }, new AsyncCallback<ScreenerContext,std::string>(callback))
 
-void ScreenerContext::screener_recommend_strategies(AsyncCallback<ScreenerContext, std::string> callback) const {
-  S_JSON(lb_screener_context_recommend_strategies, lb_screener_recommend_strategies_response_t, ctx_);
+void ScreenerContext::screener_recommend_strategies(const std::string& market, AsyncCallback<ScreenerContext, std::string> callback) const {
+  S_JSON(lb_screener_context_recommend_strategies, lb_screener_recommend_strategies_response_t, ctx_, market.c_str());
 }
 
-void ScreenerContext::screener_user_strategies(AsyncCallback<ScreenerContext, std::string> callback) const {
-  S_JSON(lb_screener_context_user_strategies, lb_screener_user_strategies_response_t, ctx_);
+void ScreenerContext::screener_user_strategies(const std::string& market, AsyncCallback<ScreenerContext, std::string> callback) const {
+  S_JSON(lb_screener_context_user_strategies, lb_screener_user_strategies_response_t, ctx_, market.c_str());
 }
 
 void ScreenerContext::screener_strategy(int64_t id, AsyncCallback<ScreenerContext, std::string> callback) const {

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

@@ -335,9 +335,11 @@ public static native void marketContextRankList(long context, Object opts,
         public static native void freeScreenerContext(long context);
 
         public static native void screenerContextRecommendStrategies(long context,
+                        String market,
                         AsyncCallback callback);
 
         public static native void screenerContextUserStrategies(long context,
+                        String market,
                         AsyncCallback callback);
 
         public static native void screenerContextStrategy(long context, Object opts,

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

@@ -4,8 +4,8 @@
 public class OperatingFinancial {
     /** Ticker code (may be empty). */
     public String code;
-    /** Raw counter ID (may be empty). */
-    public String counterId;
+    /** Symbol in CODE.MARKET format (may be empty). */
+    public String symbol;
     /** Reporting currency. */
     public String currency;
     /** Company name. */

java/javasrc/src/main/java/com/longbridge/screener/ScreenerContext.java

@@ -20,14 +20,24 @@ public void close() throws Exception {
         SdkNative.freeScreenerContext(raw);
     }
 
-    /** Get platform-recommended screener strategies. */
+    /** Get platform-preset screener strategies for the given market (default "US"). */
+    public CompletableFuture<ScreenerRecommendStrategiesResponse> getRecommendStrategies(String market) throws OpenApiException {
+        return AsyncCallback.executeTask((callback) -> SdkNative.screenerContextRecommendStrategies(raw, market, callback));
+    }
+
+    /** Get platform-preset screener strategies (defaults to US market). */
     public CompletableFuture<ScreenerRecommendStrategiesResponse> getRecommendStrategies() throws OpenApiException {
-        return AsyncCallback.executeTask((callback) -> SdkNative.screenerContextRecommendStrategies(raw, callback));
+        return getRecommendStrategies("US");
+    }
+
+    /** Get the current user's saved screener strategies for the given market (default "US"). */
+    public CompletableFuture<ScreenerUserStrategiesResponse> getUserStrategies(String market) throws OpenApiException {
+        return AsyncCallback.executeTask((callback) -> SdkNative.screenerContextUserStrategies(raw, market, callback));
     }
 
-    /** Get the current user's saved screener strategies. */
+    /** Get the current user's saved screener strategies (defaults to US market). */
     public CompletableFuture<ScreenerUserStrategiesResponse> getUserStrategies() throws OpenApiException {
-        return AsyncCallback.executeTask((callback) -> SdkNative.screenerContextUserStrategies(raw, callback));
+        return getUserStrategies("US");
     }
 
     /** Get detail for one screener strategy by ID. */

java/src/screener_context.rs

@@ -2,14 +2,14 @@ use std::sync::Arc;
 
 use jni::{
     JNIEnv,
-    objects::{JClass, JObject},
+    objects::{JClass, JObject, JString},
 };
 use longbridge::{Config, ScreenerContext};
 
 use crate::{
     async_util,
     error::jni_result,
-    types::{JavaInteger, get_field},
+    types::{FromJValue, JavaInteger, get_field},
 };
 
 struct ContextObj {
@@ -41,12 +41,14 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_screenerContextRecom
     mut env: JNIEnv,
     _class: JClass,
     context: i64,
+    market: JString,
     callback: JObject,
 ) {
     jni_result(&mut env, (), |env| {
         let context = &*(context as *const ContextObj);
+        let market: String = FromJValue::from_jvalue(env, market.into())?;
         async_util::execute(env, callback, async move {
-            let resp = context.ctx.screener_recommend_strategies().await?;
+            let resp = context.ctx.screener_recommend_strategies(market).await?;
             Ok(resp)
         })?;
         Ok(())
@@ -58,12 +60,14 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_screenerContextUserS
     mut env: JNIEnv,
     _class: JClass,
     context: i64,
+    market: JString,
     callback: JObject,
 ) {
     jni_result(&mut env, (), |env| {
         let context = &*(context as *const ContextObj);
+        let market: String = FromJValue::from_jvalue(env, market.into())?;
         async_util::execute(env, callback, async move {
-            let resp = context.ctx.screener_user_strategies().await?;
+            let resp = context.ctx.screener_user_strategies(market).await?;
             Ok(resp)
         })?;
         Ok(())
@@ -107,7 +111,7 @@ pub unsafe extern "system" fn Java_com_longbridge_SdkNative_screenerContextSearc
         async_util::execute(env, callback, async move {
             let resp = context
                 .ctx
-                .screener_search(market, strategy_id, page, size)
+                .screener_search(market, strategy_id, vec![], vec![], page, size)
                 .await?;
             Ok(resp)
         })?;