vnstock

Vnstock provides comprehensive data coverage across six main categories:

1. Equity (Cổ phiếu): Real-time stock prices, historical price data, financial statements, and company profiles.
2. Index (Chỉ số thị trường): Historical data for VNINDEX, HNX, UPCOM, and industry indices.
3. Warrant (Chứng quyền): Warrant information, actual prices, maturity dates, and trading status.
4. Futures (Phái sinh): VN30 futures contracts and corresponding terms.
5. Fund & ETF (Quỹ đầu tư): Portfolio information, FMarket open fund performance, and ETFs.
6. Macro & Commodities (Vĩ mô & Hàng hóa): Forex rates, Gold prices (SJC), and Crypto.

The ProxyManager utility is designed to handle network restrictions, ISP blocks, rate limiting, and IP rotation. It follows a lifecycle of Fetch (getting fresh proxies from APIs like Proxyscrape), Test (validating connectivity and measuring response times), Select (choosing optimal proxies based on speed), and Rotate (switching proxies automatically to distribute traffic). It supports HTTP, HTTPS, and SOCKS5 protocols and can be integrated with common libraries like requests, aiohttp, or scrapy.

from vnstock.core.utils.proxy_manager import ProxyManager

# Initialize manager
manager = ProxyManager(timeout=10)

# Fetch 5 free proxies
proxies = manager.fetch_proxies(limit=5)

# View available proxies
manager.print_proxies(proxies)

To troubleshoot proxy fetching or testing, enable detailed logging using the standard logging module. This will show debug logs during operations like fetch_proxies().

import logging

logging.basicConfig(level=logging.DEBUG)

manager = ProxyManager()
proxies = manager.fetch_proxies(limit=5)  # Will show debug logs

Install the vnstock library using pip to access Vietnamese stock market data.

!pip install vnstock

Vnstock v4+ uses a Unified UI pattern. You initialize data domains (Market, Reference, Fundamental) and then access specific data through their hierarchical structure. This allows you to fetch data without needing to manually manage underlying data sources.

from vnstock import Market, Reference, Fundamental

# Initialize data domains
market = Market()
ref = Reference()
fa = Fundamental()

# 1. Fetch historical stock prices (OHLCV)
df_history = market.equity.ohlcv(symbol='VNM', start='2024-01-01', end='2024-05-01')

# 2. Fetch general company profile
df_profile = ref.company.info(symbol='FPT')

# 3. Fetch financial data
df_balance = fa.equity.balance_sheet(symbol='TCB', period='year')

To use vnstock in your local Python environment, install it using pip. It is recommended to use the -U flag to ensure you are using the latest version.

pip install -U vnstock

You can save a list of Proxy objects to a JSON file and reload them later to avoid repeated fetching and rate limiting.

import json

def save_proxies(proxies, filename='proxies.json'):
    data = [
        {
            'protocol': p.protocol,
            'ip': p.ip,
            'port': p.port,
            'country': p.country,
            'speed': p.speed
        }
        for p in proxies
    ]
    with open(filename, 'w') as f:
        json.dump(data, f)

def load_proxies(filename='proxies.json'):
    from vnstock.core.utils.proxy_manager import Proxy

    with open(filename) as f:
        data = json.load(f)

    return [Proxy(**item) for item in data]

# Usage
proxies = manager.fetch_proxies(limit=10)
save_proxies(proxies)

# Later...
proxies = load_proxies()
working, _ = manager.test_proxies(proxies)

Once you have a list of Proxy objects, you can filter them using their attributes: protocol, speed (in ms), and country.

# Get only HTTP proxies
http_only = [p for p in proxies if p.protocol == 'http']

# Get only proxies under 100ms
fast_proxies = [p for p in proxies if p.speed < 100]

# Get specific country
vietnam_proxies = [p for p in proxies if 'Vietnam' in p.country]

The Market class is the entry point for the Unified UI, allowing you to access different asset classes through specific methods.

Initialize the market object as follows:

from vnstock import Market

mkt = Market()

Available asset layers include:

• mkt.equity(symbol): Stocks
• mkt.index(symbol): Market Indices
• mkt.futures(symbol): Futures contracts
• mkt.warrant(symbol): Warrants
• mkt.etf(symbol): ETFs
• mkt.fund(symbol): Mutual Funds
• mkt.crypto(symbol): Cryptocurrency (via Binance)
• mkt.forex(symbol): Forex and Gold

The Fundamental module in vnstock provides access to financial statements (Income Statement, Balance Sheet, Cash Flow) and Financial Ratios for equities.

To use it, initialize the layer with fun = Fundamental().

The module supports two flexible calling conventions (Proxy chaining):

1. Object-oriented style: fun.equity("SYMBOL").method() — Best for chaining operations on a specific ticker.
2. Utility function style: fun.equity.method("SYMBOL") — A functional approach to calling methods.

Both styles yield the same results.