選股
鑑權
簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 請求時間戳,單位秒(Unix 時間)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
按策略 ID 或自定義指標條件篩選股票,支持分頁。
longbridge screener search --strategy-id 42
longbridge screener search --market HK --filter marketcap:100:1000
請求
請求體
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
market | string | 必填 | 選股市場,如 `US`、`HK`、`CN`。使用策略時取自策略。 |
filters | array | 必填 | 篩選條件。每項為 `{ "key": "filter_pettm", "min": "10", "max": "30", "tech_values": {} }`。 |
returns | array | 必填 | 每個匹配項需返回的指標 key 列表,如 `filter_pettm`。 |
page | integer | 必填 | 頁碼(從 0 開始)。 |
size | integer | 必填 | 每頁數量。 |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
total | integer | 可選 | 滿足條件的股票總數。 |
items | object[] | 可選 | 匹配的股票列表。 |
└ symbol | string | 可選 | 標的代碼,如 `WXT.US`。 |
└ name | string | 可選 | 標的名稱。 |
└ indicators | object[] | 可選 | 該股票的指標值。 |
└ ∟ key | string | 可選 | 指標鍵名,如 `filter_pettm`。 |
└ ∟ name | string | 可選 | 指標顯示名稱。 |
└ ∟ value | string | 可選 | 指標值(字符串),無數據時為空。 |
└ ∟ unit | string | 可選 | 數值單位,如 `%`、` 億`。 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"total": 88,
"page": 0,
"market": "US",
"items": [
{
"symbol": "AAPL.US",
"name": "Apple Inc.",
"prevchg": 0.62,
"marketcap": 3241500000000,
"pettm": 32.15,
"pbmrq": 50.21,
"salesgrowthyoy": 8.04
},
{
"symbol": "MSFT.US",
"name": "Microsoft",
"prevchg": 1.05,
"marketcap": 3085000000000,
"pettm": 35.42,
"pbmrq": 12.87,
"salesgrowthyoy": 12.61
}
]
}
}錯誤碼
參見錯誤碼文檔。