Intelligent Stocks Screener

Base URL: https://api.intellectia.ai Staj

Endpoint

• GET /gateway/v1/stock/screener-list

Full URL:

• https://api.intellectia.ai/gateway/v1/stock/screener-list

Query parameters

• symbol_type (int): Asset type 0=stock 1=etf 2=crypto
• period_type (int): Period 0=day 1=week 2=month
• trend_type (int): Trend 0=bullish 1=bearish
• profit_asc (bool): Sort by profit ascending (true = small → large)
• market_cap (int): Market cap filter
  • 0=any
  • 1=micro <300M
  • 2=small 300M-2B
  • 3=mid 2B-10B
  • 4=large 10B-200B
  • 5=mega >200B
• price (int): Price filter
  • 0=any
  • 1=<5
  • 2=<50
  • 3=>5
  • 4=>50
  • 5=5-50
• page (int): Page number (example: 1)
• size (int): Page size (example: 20)

Response (200)

Example response (shape):

{
  "ret": 0,
  "msg": "",
  "data": {
    "list": [
      {
        "code": "BKD.N",
        "symbol": "BKD",
        "symbol_type": 0,
        "name": "Brookdale Senior Living Inc",
        "logo": "https://intellectia-public-documents.s3.amazonaws.com/image/logo/BKD_logo.png",
        "pre_close": 14.5,
        "price": 15,
        "change_ratio": 3.45,
        "timestamp": "1769749200",
        "simiar_num": 10,
        "probability": 80,
        "profit": 5.27,
        "klines": [{ "close": 15, "timestamp": "1769749200" }],
        "trend_list": [
          {
            "symbol": "BKD",
            "symbol_type": 0,
            "is_main": true,
            "list": [{ "change_ratio": 5.27, "timestamp": "1730260800", "close": 16 }]
          }
        ],
        "update_time": "1769806800"
      }
    ],
    "total": 3,
    "detail": {
      "cover_url": "https://d159e3ysga2l0q.cloudfront.net/image/cover_image/stock-1.png",
      "name": "Stocks Bullish Tomorrow",
      "screener_type": 1011,
      "params": "{}",
      "desc": "..."
    }
  }
}

Field reference

Top-level:

• ret (int): Status code (typically 0 means success)
• msg (string): Message (empty string when OK)
• data (object): Payload

data:

• data.list (array): Result rows
• data.total (int): Total number of rows
• data.detail (object): Screener metadata

Each item in data.list:

• code (string): Full instrument code (may include exchange suffix, e.g. BKD.N)
• symbol (string): Ticker symbol (e.g. BKD)
• symbol_type (int): Asset type (0=stock 1=etf 2=crypto)
• name (string): Display name
• logo (string): Logo URL
• pre_close (number): Previous close price
• price (number): Current price
• change_ratio (number): Percent change vs previous close
• timestamp (string): Quote timestamp (Unix seconds)
• simiar_num (int): Similarity count (as returned by API; spelling kept as-is)
• probability (int): Model confidence (0-100)
• profit (number): Predicted/expected return (as returned by API)
• klines (array): Price series
  • klines[].close (number): Close price
  • klines[].timestamp (string): Unix seconds
• trend_list (array): Trend comparison series
  • trend_list[].symbol (string): Symbol for the series (may be empty for non-main series)
  • trend_list[].symbol_type (int): Asset type
  • trend_list[].is_main (bool): Whether this is the main series
  • trend_list[].list (array): Time points
    • trend_list[].list[].change_ratio (number): Percent change at that point
    • trend_list[].list[].timestamp (string): Unix seconds
    • trend_list[].list[].close (number): Close price at that point
• update_time (string): Last update time (Unix seconds)

data.detail:

• cover_url (string): Cover image URL
• name (string): Screener title
• screener_type (int): Screener type ID
• params (string): Serialized params (often JSON string)
• desc (string): Screener description
• num (int, optional): As returned by API (may be absent)

Examples

cURL

curl -sS "https://api.intellectia.ai/gateway/v1/stock/screener-list?symbol_type=0&period_type=0&trend_type=0&profit_asc=false&market_cap=0&price=0&page=1&size=20"

Python (requests)

python3 - <<'PY'
import requests

base_url = "https://api.intellectia.ai"
params = {
  "symbol_type": 0,
  "period_type": 0,
  "trend_type": 0,
  "profit_asc": False,
  "market_cap": 0,
  "price": 0,
  "page": 1,
  "size": 20,
}

r = requests.get(f"{base_url}/gateway/v1/stock/screener-list", params=params, timeout=30)
r.raise_for_status()
payload = r.json()

print("ret:", payload.get("ret"))
print("msg:", payload.get("msg"))
data = payload.get("data") or {}
rows = data.get("list") or []
print("total:", data.get("total"))
for row in rows[:10]:
  print(row.get("symbol"), row.get("price"), row.get("change_ratio"), row.get("probability"), row.get("profit"))
PY

Notes

• No authentication required.
• If you see rate limits, reduce size and add backoff/retry in client code.