thanhnp-uel/vietnam-listed-companies-financial-statements

Vietnamese Listed Companies Financial Data

Overview

This dataset provides standardized financial statement data for Vietnamese listed companies.

The original financial information was collected from publicly available financial statements and annual reports published through official stock exchange portals and company websites.

The source data has been transformed into a standardized long-format Parquet structure for research, educational, analytical, and data-processing purposes.

Dataset Version

• —Dataset version: v1.0.0
• —Schema version: 1.0
• —Format: Parquet
• —Data structure: Long format

Data Provenance

The source data was collected from:

• —Official stock exchange portals
• —Official company websites
• —Publicly available financial statements
• —Publicly available annual reports

The dataset represents a standardized and structured transformation of the source documents.

Users are encouraged to consult the original source documents when verifying individual financial figures.

Data Structure

Each observation represents a financial statement item for a company and reporting year.

Financial Statements

The dataset contains standardized financial statement information organized by statement type.

The main statement categories include:

• —Balance Sheet
• —Income Statement
• —Cash Flow Statement

The exact available statement categories and records depend on the released dataset snapshot.

Long-Format Design

The dataset uses a long-format structure rather than preserving the original spreadsheet layout.

Conceptually:

ticker
year
exchange
statement
item_code
item_name
value

This structure is intended to make the data easier to:

• —filter by company;
• —filter by year;
• —select individual financial statement items;
• —analyze across companies;
• —analyze across years;
• —load efficiently using Python and pandas;
• —access programmatically through the vnfinancialdata package.

Data Quality and Transformation

The source spreadsheets were transformed into standardized Parquet files.

The transformation process includes:

1. 1.Reading the source financial statement files.
2. 2.Standardizing the financial statement structure.
3. 3.Converting the data into long format.
4. 4.Preserving company, year, exchange, statement, and source information.
5. 5.Assigning standardized item codes and item names.
6. 6.Exporting the resulting data to Parquet.
7. 7.Validating the resulting dataset schema and record counts.

The released dataset corresponds to the immutable v1.0.0 snapshot.

Intended Use

This dataset is intended for:

• —academic research;
• —financial data analysis;
• —educational purposes;
• —data science projects;
• —financial modeling and experimentation;
• —reproducible analytical workflows.

Access Through Python

The dataset can be accessed programmatically through the vnfinancialdata Python package.

Example:

import vnfinancialdata as vnf

df = vnf.load(
    exchange="HNX",
    statement="balance_sheet"
)

Example filtering by company and year:

df = vnf.get(
    ticker="AAA",
    exchange="HSX",
    statement="balance_sheet",
    start=2020,
    end=2025
)

Reproducibility

The dataset is released using a versioned snapshot.

For reproducible research, users should record:

Dataset version: v1.0.0
Schema version: 1.0

The vnfinancialdata package also records the dataset revision used by the API.

License

The dataset is released under:

Open Data / Public Domain

The dataset is derived from publicly available financial statements and annual reports.

Users should nevertheless verify the applicable terms associated with the original source documents when using the data for specific commercial, redistribution, or other purposes.

Disclaimer

This dataset is provided for research, educational, and analytical purposes.

Although the data has been standardized and validated during the transformation process, no guarantee is made that every observation is free from errors or omissions.

Users should verify important financial information against the original financial statements, annual reports, stock exchange publications, or company disclosures before making investment, financial, legal, or other consequential decisions.

The dataset is not investment advice.

Citation

When using this dataset in academic research or other publications, please cite the dataset and specify the dataset version:

Vietnamese Listed Companies Financial Data,
Dataset version v1.0.0.

Please also acknowledge the original public sources from which the financial statements and annual reports were collected.

Related Python Package

The dataset is designed to be accessed through:

vnfinancialdata

The package provides programmatic access to the dataset and metadata APIs.

Versioning

Dataset releases use semantic version identifiers.

Current release:

v1.0.0

Future releases may contain:

• —additional companies;
• —additional reporting years;
• —additional financial statements;
• —corrections;
• —metadata improvements;
• —schema changes.

Changes between releases will be documented in the corresponding release notes.

Contact and Issues

For data-quality issues, reproducibility questions, or technical issues related to the dataset or Python package, please use the project's designated issue or contact channel.

Dataset version: v1.0.0 Schema version: 1.0