4. Securities List

Get stock lists by exchange, index, and view details

Objective

Build watchlist/screener by market criteria — get stock lists by exchange (HOSE, HNX), by index (VN30), and view details for each stock.

Flow

Screener → Market Data API (Securities) → Watchlist State

Sample Code — Sync

python/sample_04_securities.py
from ssi_sdk import Auth, Data, Config
from ssi_sdk.enums import Board
from auth_helper import ensure_auth

config = Config(
    client_id="<your_client_id>",
    api_key="<your_api_key>",
    api_secret="<your_api_secret>",
    private_key="<your_private_key>",
)

with Auth(config) as auth:
    ensure_auth(auth)
    with Data(auth) as data:
        hose = data.market_data.get_securities_info_by_board(Board.HOSE)
        hnx = data.market_data.get_securities_info_by_board(Board.HNX)
        vn30 = data.market_data.get_securities_info_by_index("VN30")
        info = data.market_data.get_securities_info("SSI")
        print(f"  {info.symbol} | {info.symbol_name_vi} | {info.board}")

Sample Code — Async

python/sample_04_securities_async.py
import asyncio
from ssi_sdk import AsyncAuth, AsyncData, Config
from ssi_sdk.enums import Board
from auth_helper import ensure_auth_async

config = Config(...)

async def main():
    async with AsyncAuth(config) as auth:
        await ensure_auth_async(auth)
        async with AsyncData(auth) as data:
            hose, hnx = await asyncio.gather(
                data.market_data.get_securities_info_by_board(Board.HOSE),
                data.market_data.get_securities_info_by_board(Board.HNX),
            )
            vn30 = await data.market_data.get_securities_info_by_index("VN30")
            info = await data.market_data.get_securities_info("SSI")

asyncio.run(main())

API Methods

MethodDescription
get_securities_info_by_board(board)Get stocks by exchange
get_securities_info_by_index(index)Get stocks by index
get_securities_info(symbol)Get detail of a specific stock

On this page