Skip to main content
POST
/
v1
/
stock
/
screener
Stock Screener
curl --request POST \
  --url https://api.reportify.cn/v1/stock/screener \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "market_cap_more_than": 123,
  "market_cap_lower_than": 123,
  "price_more_than": 123,
  "price_lower_than": 123,
  "change_percentage_more_than": 123,
  "change_percentage_lower_than": 123,
  "volume_more_than": 123,
  "volume_lower_than": 123,
  "country": "<string>",
  "exchange": "<string>",
  "dividend_yield_more_than": 123,
  "dividend_yield_lower_than": 123,
  "pe_ttm_more_than": 123,
  "pe_ttm_lower_than": 123,
  "limit": 123
}
'
{
  "status": 123,
  "code": 123,
  "message": "<string>",
  "data": {}
}

​
股票筛选器

URL: /v1/stock/screener 方法: POST
描述: 根据多种条件筛选股票。

​
请求参数

参数名类型必填描述
market_cap_more_thannumber否市值大于。
market_cap_lower_thannumber否市值小于。
price_more_thannumber否股价大于。
price_lower_thannumber否股价小于。
change_percentage_more_thannumber否涨跌幅大于（如 0.02 表示 2%）。
change_percentage_lower_thannumber否涨跌幅小于（如 0.04 表示 4%）。
volume_more_thanint否成交量大于。
volume_lower_thanint否成交量小于。
countrystr否国家代码（如 US, CN, HK）。
exchangestr否交易所代码（如 NASDAQ, NYSE, HKEX）。
dividend_yield_more_thannumber否股息率大于。
dividend_yield_lower_thannumber否股息率小于。
pe_ttm_more_thannumber否市盈率（TTM）大于。
pe_ttm_lower_thannumber否市盈率（TTM）小于。
limitint否返回结果数量限制，默认 100。

​
响应参数

参数名类型描述
statusintHTTP 状态码。
codeint响应代码（0 表示成功）。
messagestr响应消息。
dataobject筛选结果数据。
  itemsarray股票列表。
    tickerstr股票代码。
    namestr股票名称。
    english_namestr股票英文名称。
    chinese_namestr股票中文名称。
    countrystr国家代码。
    exchangestr交易所代码。
    pricenumber当前价格。
    change_percentagenumber涨跌幅（小数形式）。
    changenumber涨跌额。
    day_highnumber最高价。
    opennumber开盘价。
    day_lownumber最低价。
    market_capnumber市值。
    volumeint成交量。
    timestampstr时间戳（ISO 8601 格式）。
    dividend_yieldnumber股息率。
    pe_ttmnumber市盈率（TTM）。

​
请求示例

cURL 
curl -X POST https://api.reportify.cn/v1/stock/screener \
-H "Authorization: Bearer 447460****09c9" \
-H "Content-Type: application/json" \
-d '{
    "country": "HK",
    "limit": 3
}'
Python 
import requests

url = "https://api.reportify.cn/v1/stock/screener"
headers = {
    "Authorization": "Bearer 447460****09c9",
    "Content-Type": "application/json"
}
data = {
    "country": "HK",
    "limit": 3
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

​
响应示例

{
  "status": 200,
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "ticker": "00700",
        "name": "腾讯控股",
        "english_name": "TENCENT",
        "chinese_name": "腾讯控股",
        "country": "HK",
        "exchange": "HK",
        "price": 602.5,
        "change_percentage": -0.0041,
        "change": -2.5,
        "day_high": 610,
        "open": 609.5,
        "day_low": 596,
        "market_cap": 5509795433315,
        "volume": 17431321,
        "timestamp": "2025-12-09T16:00:00+08:00",
        "dividend_yield": 0.0075,
        "pe_ttm": 23.9193
      },
      {
        "ticker": "09988",
        "name": "阿里巴巴",
        "english_name": "BABA",
        "chinese_name": "阿里巴巴",
        "country": "HK",
        "exchange": "HK",
        "price": 150.9,
        "change_percentage": -0.0163,
        "change": -2.5,
        "day_high": 156.8,
        "open": 155.1,
        "day_low": 150.4,
        "market_cap": 2880475372644.3003,
        "volume": 69789164,
        "timestamp": "2025-12-09T16:00:00+08:00",
        "dividend_yield": 0.0129,
        "pe_ttm": 21.5757
      },
      {
        "ticker": "03750",
        "name": "宁德时代",
        "english_name": "CATL",
        "chinese_name": "宁德时代",
        "country": "HK",
        "exchange": "HK",
        "price": 496,
        "change_percentage": -0.0207,
        "change": -10.5,
        "day_high": 508,
        "open": 508,
        "day_low": 493,
        "market_cap": 2263549579408,
        "volume": 1948121,
        "timestamp": "2025-12-09T16:00:00+08:00",
        "dividend_yield": 0.0022,
        "pe_ttm": 33.4434
      }
    ]
  }
}

​
错误响应

状态码描述
422请求参数验证失败。

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input schema for stock screener

​
market_cap_more_than
number

Market cap greater than

​
market_cap_lower_than
number

Market cap less than

​
price_more_than
number

Stock price greater than

​
price_lower_than
number

Stock price less than

​
change_percentage_more_than
number

Change percentage greater than (e.g., 0.02 for 2%)

​
change_percentage_lower_than
number

Change percentage less than (e.g., 0.04 for 4%)

​
volume_more_than
integer

Trading volume greater than

​
volume_lower_than
integer

Trading volume less than

​
country
string

Country code (e.g., US, CN, HK)

​
exchange
string

Exchange code (e.g., NASDAQ, NYSE, HKEX)

​
dividend_yield_more_than
number

Dividend yield greater than

​
dividend_yield_lower_than
number

Dividend yield less than

​
pe_ttm_more_than
number

PE TTM greater than

​
pe_ttm_lower_than
number

PE TTM less than

​
limit
integer

Maximum number of results, default 100

Response

Successful Response

Generic response wrapper from stock API

​
status
integer

HTTP status code

​
code
integer

Response code (0 for success)

​
message
string

Response message

​
data
Data · object

Response data (structure varies by endpoint)