fireant-stock

name	fireant-stock
description	Automated Vietnamese stock price and index checking on FireAnt.vn. Use when checking current stock prices, market indices, trading volumes, or financial information for Vietnamese stocks (HOSE, HNX, UPCOM) and market indices (VNINDEX, HNX30, VN30). Accepts stock symbols like DPM, VCB, FPT, or indices like VNINDEX. Returns formatted price/index data, market statistics, and key financial metrics.

FireAnt Stock Price Checker

Overview

Automatically retrieves real-time stock information from FireAnt.vn for Vietnamese equities. Handles the full workflow from searching to data extraction and formatting.

Quick Start

Check a single stock:

scripts/check_stock.py DPM

Check multiple stocks:

scripts/check_stock.py VCB FPT BID

Core Workflow

1. Search - Uses Google search to find the FireAnt stock page for the symbol
2. Navigate - Opens the FireAnt stock page via Agent Browser (Rust headless browser automation)
3. Extract - Parses current price, volume, market cap, and key statistics from page snapshot
4. Format - Returns structured data in readable format

Requirements

• Agent Browser - Fast Rust-based headless browser (agent-browser CLI must be installed)
• Python 3.x with standard libraries (sys, re, subprocess, json, typing)

Supported Data

For Stocks:

• Current Price - Real-time price with change percentage
• Trading Data - Volume, value, opening/high/low prices
• Market Metrics - Market cap, beta, P/E ratio, reference price
• Technical Analysis - Moving averages (MA10, MA50)
• Company Info - Full company name, stock exchange listing

For Indices (VNINDEX, HNX30, VN30, etc.):

• Current Index - Real-time index value with change percentage
• Trading Data - Total volume, matched volume, value traded
• Foreign Trading - NĐTNN (foreign investor) buy/sell activity and net position
• Technical Analysis - Moving averages (MA10, MA50)
• Market Overview - Reference price, opening, high/low range

Usage Patterns

Single stock inquiry: "Check giá cổ phiếu DPM" "What's the current price of VCB?"

Multiple stocks: "Compare VCB, BID, and CTG prices" "Show me bank stocks: VCB BID CTG"

Market indices: "Check VNINDEX" "How is the market doing today?" (→ VNINDEX) "Show me VN30 index"

Mixed (stocks + index): "Check ACB, L18, AAA và VNINDEX" "Give me tech stocks and market index: FPT VNM VNINDEX"

Market research: "Find information about DPM stock on FireAnt" "Get latest trading data for FPT"

Scripts

scripts/check_stock.py

Main script that automates the full stock checking workflow for one or more symbols (stocks or indices).

Usage: python3 scripts/check_stock.py <SYMBOL1> [SYMBOL2] ...

Examples:

# Check stocks
python3 scripts/check_stock.py ACB VCB FPT

# Check index
python3 scripts/check_stock.py VNINDEX

# Check mixed
python3 scripts/check_stock.py ACB L18 AAA VNINDEX

Returns: Formatted stock/index data including price/index value, volume, and key metrics.

Note: FireAnt URL format is the same for both stocks and indices: https://fireant.vn/ma-chung-khoan/{SYMBOL}