VNBroker v1.0

VNBroker: Python Library for Vietnam Market Data

A unified data access layer pulling directly from providers (Direct Provider), supporting stock, forex, crypto, world indices, and fund data in Vietnam. The library standardizes output as Pandas DataFrames, integrates Private Brokerage APIs, and does not depend on PAT or Gateway.

pip install vnbroker
✔ Fetch price, profile, and listing data
✔ Try it now in the playground

System Audit & Architecture Analysis

A detailed internal technical review of the VNBroker library’s Python class structure, data routing algorithms, concurrency control, and data standardization policies.

1.1. Core Package Components

VNBroker

Top-level client that orchestrates all data flows for stock, FX, crypto, world indices, and funds using Direct Provider Architecture.

Quote

Provides historical OHLCV price data, intraday matched trades, and price depth information.

Company

Corporate profiles, board of directors, insider transactions, and ownership ratios.

Finance

Balance sheets, income statements, cash flow statements, and financial ratios.

Listing

Listed stock codes, index groupings (VN30, HNX30), and industry sector classifications.

Trading

Real-time trading data and market board display.

Screener

Dynamic stock screener with TCBS data source integration.

News

Standardized news aggregated from reputable sources (Cafef, Vneconomy, etc.).

MarketSnapshot

Market snapshot for heatmap visualization and rapid sector statistics.

Fund

Fund certificate info and growth history from the FMarket portal.

Messenger

Real-time alerts and notifications via Webhook to Slack, Telegram, Discord, and Lark.

Broker

Direct private brokerage account management supporting order placement (buy/sell/cancel/modify), balance queries, and portfolio retrieval via TCBS iFlash OpenAPI, DNSE (VNDirect API), and SSI.

1.2. Supported Data Providers

The library manages connections and automatically standardizes data from both official partner APIs and public extraction tools (scraping):

Vietnam Stocks
TCBS APIDNSE APIKBSVCI
Forex & International
MSN CurrencyFMP APIBinance API
Investment Funds & News
FMarket APIRSS CafefRSS Vneconomy