選股篩選

按策略 ID 或自定義指標條件篩選股票，支持分頁。

接口：POST /v1/quote/ai/screener/search

JSON 輸出格式說明： 響應使用扁平的 items[] 數組（非 stocks[]），所有數值字段為 JSON 數字類型（非字符串），指標鍵名不含 filter_ 前綴。

SDK Links

Python	longport.openapi.ScreenerContext.screener_search
Rust	longport::screener::ScreenerContext#screener_search
Go	ScreenerContext.ScreenerSearch
Node.js	ScreenerContext#screenerSearch

Parameters

SDK 方法參數。

Name	Type	Required	Description
market	string	是	市場：US、HK、CN、SG
strategy_id	integer	否	策略 ID；與自定義條件二選一，或同時使用
conditions	ScreenerCondition[]	否	自定義篩選條件（模式 B，不傳 strategy_id 時使用）
show	string[]	否	額外需要返回的指標鍵名，在默認 7 列之外追加
page	integer	否	頁碼，從 0 開始，默認 0
size	integer	否	每頁條數，默認 20

Request Example

from longport.openapi import ScreenerContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = ScreenerContext(config)

# 按策略 ID 篩選
resp = ctx.screener_search("US", strategy_id=42)
print(resp)

import asyncio
from longport.openapi import AsyncScreenerContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncScreenerContext.create(config)

    resp = await ctx.screener_search("US", strategy_id=42, page=1, size=20)
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, ScreenerContext, OAuth } = require('longport')

async function main() {
  const oauth = await OAuth.build('your-client-id', (_, url) => {
    console.log('Open this URL to authorize: ' + url)
  })
  const config = Config.fromOAuth(oauth)
  const ctx = ScreenerContext.new(config)
  const resp = await ctx.screenerSearch('US', { strategyId: 42, page: 1, size: 20 })
  console.log(resp)
}
main().catch(console.error)

import com.longport.*;
import com.longport.screener.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             ScreenerContext ctx = ScreenerContext.create(config)) {
            var resp = ctx.screenerSearch("US", 19L, null, List.of(), 0, 20).get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longport::{oauth::OAuthBuilder, screener::ScreenerContext, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = ScreenerContext::new(config);
    // 模式 A：運行策略
    let resp = ctx.screener_search("", Some(19), vec![], vec![], 0, 20).await?;
    println!("{:?}", resp);
    // 模式 B：自定義條件
    use longport::screener::ScreenerCondition;
    let conditions = vec![ScreenerCondition { key: "pettm".into(), min: "10".into(), max: "50".into(), tech_values: serde_json::json!({}) }];
    let resp = ctx.screener_search("HK", None, conditions, vec![], 0, 20).await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longport.hpp>

using namespace longport;
using namespace longport::screener;

int main() {
    OAuthBuilder("your-client-id").build(
        [](const std::string& url) { std::cout << "Open: " << url << std::endl; },
        [](auto res) {
            if (!res) return;
            Config config = Config::from_oauth(*res);
            ScreenerContext ctx = ScreenerContext::create(config);
            ctx.screener_search("US", 42, 1, 20, [](auto resp) {
                if (resp) std::cout << "OK" << std::endl;
            });
        });
    std::cin.get();
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longportapp/openapi-go/config"
	"github.com/longportapp/openapi-go/oauth"
	"github.com/longportapp/openapi-go/screener"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	c, err := screener.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	defer c.Close()
	// 模式 A：運行策略
	stratID := int64(19)
	resp, err := c.ScreenerSearch(context.Background(), "", &stratID, nil, nil, 0, 20)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp)

	// 模式 B：自定義條件
	conditions := []screener.ScreenerCondition{
		{Key: "pettm", Min: "10", Max: "50"},
		{Key: "roe", Min: "5"},
	}
	resp2, err := c.ScreenerSearch(context.Background(), "HK", nil, conditions, []string{"roe"}, 0, 20)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp2)
}

Response

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 88,
    "page": 0,
    "market": "US",
    "items": [
      {
        "symbol": "AAPL.US",
        "name": "蘋果公司",
        "prevchg": 0.62,
        "marketcap": 3241500000000,
        "pettm": 32.15,
        "pbmrq": 50.21,
        "salesgrowthyoy": 8.04
      },
      {
        "symbol": "MSFT.US",
        "name": "微軟",
        "prevchg": 1.05,
        "marketcap": 3085000000000,
        "pettm": 35.42,
        "pbmrq": 12.87,
        "salesgrowthyoy": 12.61
      }
    ]
  }
}

Response Status

Status	Description	Schema
200	成功	ScreenerSearchResponse
400	請求錯誤	None

Schemas

ScreenerSearchResponse

Name	Type	Required	Description
total	integer	false	滿足條件的股票總數
page	integer	false	當前頁碼（從零開始）
market	string	false	結果集的市場
items	object[]	false	篩選結果股票列表
∟ symbol	string	false	證券代碼
∟ name	string	false	證券名稱
∟ prevchg	number	false	昨日漲跌幅（如 1.24 表示 1.24%）
∟ marketcap	number	false	市值（數字類型）
∟ pettm	number	false	市盈率 TTM（數字類型）
∟ pbmrq	number	false	市淨率 MRQ（數字類型）
∟ salesgrowthyoy	number	false	營收同比增速（%）
∟ industry	string	false	行業分類

所有數值指標字段均為 JSON 數字類型。具體返回字段取決於所用策略或篩選條件。指標鍵名不含 filter_ 前綴。