Why choose EcoData?
An economic-financial data platform, standardized and ready for research and teaching.
Clean, publication-ready data
All data is cleaned and standardized into panel/time-series formats, ready for research and international publication.
Rich and up to date
A multi-domain, multi-source data repository, regularly updated from official agencies and organizations.
Complete international macro indicators
Coverage of macro indicators from trusted sources: World Bank, IMF, ADB, UN, FRED, OECD, ILO...
Official Vietnamese data
General Statistics Office (Statistical Yearbook, socio-economic reports), General Department of Customs (import/export by commodity), survey data (PAPI, PCI, PAR, SIPAS, ICT) and VHLSS, VARHS, VES microdata...
EcoData Overview
EcoData is a professional economic-financial data platform built to help lecturers, graduate students, researchers and analysts access trusted domestic and international data sources through a unified interface. From macro indicators to corporate financial reports, from General Statistics Office data to Customs figures – everything is standardized, updated and ready for research, teaching and decision-making.
Platform capabilities
- Integrated data from 10+ trusted international sources (World Bank, IMF, OECD, ADB, FRED...)
- Comprehensive stock data for 2,500+ Vietnamese listed companies
- Provincial-level statistics from General Statistics Office (GSO)
- Detailed import/export data from General Department of Customs
- Multi-format data export: Excel, CSV, JSON
- Bilingual interface (Vietnamese – English), light/dark theme support
Target audience
- Economics, finance and statistics lecturers – using data for teaching and research
- Graduate students and researchers – obtaining data for theses and research projects
- Data analysts and financial professionals – monitoring indicators and market reports
- Administrators – managing data, users and system configuration
Architecture & Technology
EcoData is designed with a modern client-server architecture, suited for the in-depth data analysis needs of academic and research environments.
Technology stack
| Frontend | React 19 + TypeScript + Vite – modern web SPA |
| Backend | FastAPI + SQLAlchemy (Python) – high-performance REST API |
| Database | PostgreSQL (production) / SQLite (development) |
| Cache | Redis – query acceleration and API load reduction |
| Task Queue | Celery – background task processing (ingestion, export) |
Data processing workflow
- 1Collect data from public APIs of international organizations and government agencies
- 2Standardize formats, clean and validate data consistency
- 3Store in central database with bilingual metadata (Vietnamese – English)
- 4Provide search, filter, preview and export interface for end users
System Login
Access EcoData with your email and password, or sign in with Google. The session uses a short-lived access token and a refresh token to maintain a secure experience.
Login steps
- 1Open your browser and go to: ecodata.io.vn
- 2Click "Sign In" or "Start Free Trial" on the landing page
- 3Enter your email and password (or sign in quickly with Google)
- 4Click "Sign In" – the system will verify your credentials
- 5If correct, you will be redirected to the Dashboard
Login security
| Rate limit | Limited to 5 failed attempts per 10 minutes – IP temporarily blocked when exceeded |
| Access session | The access token is valid for up to 24 hours; the session may be renewed while its refresh token remains valid |
| Logout | Signing out ends the current session on the device in use |
Dashboard Overview
After logging in, you will be directed to the main Dashboard – the central hub for all economic indicators from international data sources.
Dashboard features
- Multi-dimensional filters: category, data source, country, time period
- Quick keyword search in indicator names (supports both Vietnamese and English)
- View indicator details: description, unit, chart, historical data
- Select multiple indicators for simultaneous export
- Interface toggle: Light / Dark theme
- Language toggle: Vietnamese / English
Membership payments
Your payment flow depends on whether you request an electronic invoice. Always verify the recipient account, amount and transfer memo shown on the order.
Payment without an invoice
- 1Sign in, open Checkout and select the membership plan you need.
- 2Leave “Request electronic invoice” unchecked. EcoData shows only the Personal account and its matching QR code.
- 3Transfer the exact amount with the order memo. You may upload the receipt and then select “I have transferred”.
- 4The payment remains Pending while reconciliation runs. Once matched successfully, the plan is activated and a confirmation email is sent to you.
Payment with an electronic invoice
- 1Select “Request electronic invoice”, choose the buyer type and complete the invoice details.
- 2Review the details before creating the order. Company, Individual and Foreigner buyers all see only the Business account.
- 3Transfer the exact amount with the order memo to the displayed Business account. Do not transfer to the Personal account.
- 4Upload the transfer receipt, which is required, and select “I have transferred”. The payment stays Pending because the Business account has no automatic reconciliation connector.
- 5After the responsible team reviews and confirms it manually, the plan is activated, a confirmation email is sent and the invoice request enters the issuance workflow.
Status and membership term
| Pending | The transfer has not been matched or its receipt is awaiting review |
| Success | The payment is confirmed and the membership has been activated |
| Start date | The successful payment or activation time, not the order creation time |
| Upgrade | When moving from a lower to a higher plan, the unused value of the lower plan is converted into additional days on the new plan |
Retry a pending payment
- 1If your latest payment is Pending, open the Membership Dashboard and select “Pay again”.
- 2EcoData restores the plan and saved invoice details; you must still review and confirm them before creating a new order.
- 3Once the new order is created successfully, the previous pending order is cancelled and superseded to prevent two plans from being activated.
Opening the retry checkout without creating a new order does not change your current pending payment.
International Economic Indicators
EcoData integrates data from the world's leading economic organizations, providing macro, trade, financial and social indicators for over 200 countries and territories.
Data sources
World Bank
World development indicators, poverty, education, health
International Monetary Fund
International financial data, exchange rates, public debt
Organisation for Economic Co-operation and Development
Developed economy data
International Labour Organization
Labor, employment, wages data
United Nations
Sustainable Development Goals (SDGs) indicators
World Trade Organization
International trade data
Food and Agriculture Organization
Agriculture and food data
Eurostat
European Union statistics
Asian Development Bank
Asia-Pacific economic data
Federal Reserve Economic Data
US and global economic data
Bank for International Settlements
International financial and credit data
Indicator categories
- Macroeconomics (GDP, GNI, inflation, growth...)
- International Trade & FDI (imports/exports, capital flows...)
- Finance & Monetary (exchange rates, interest rates, capital markets...)
- Social Development (education, health, poverty...)
- Environment (emissions, energy, resources...)
- Infrastructure (transportation, telecommunications, urbanization...)
- Technology (R&D, patents, digitalization...)
Vietnam Stock Market
Comprehensive stock data for over 2,500 tickers across 3 exchanges: HOSE, HNX and UpCOM. Data sourced from VCI (Vietcap) with quarterly and annual financial reports.
Stock exchanges
Ho Chi Minh Stock Exchange
Vietnam's largest stock exchange
Hanoi Stock Exchange
Second largest exchange
Unlisted Public Company Market
Market for unlisted public companies
Financial reports
- Balance Sheet – Assets, liabilities, equity
- Income Statement – Revenue, expenses, profit
- Cash Flow Statement – Operating, investing, financing activities
- Financial Ratios – ROE, ROA, P/E, P/B and other ratios
Additional features
- Corporate event calendar (dividends, AGM, issuances...)
- Filter by ICB industry classification
- Filter by reporting period
- Bulk export multiple tickers to Excel
General Statistics Office (GSO) Data
Provincial-level statistics from Vietnam's General Statistics Office, covering 100+ socio-economic indicators organized by province and year.
Key features
- Select multiple provinces simultaneously or view nationwide data
- Filter by year range and category (economy, society, environment...)
- Search indicators by keyword in indicator names
- 3 view modes: Data Table, Pivot Table, Chart
- Export to Excel (.xlsx) and CSV (.csv)
- Bilingual metadata (Vietnamese – English) for each indicator
Requires Basic tier or above to access GSO data.
Customs Data
Detailed import/export data from Vietnam's General Department of Customs, supporting multiple analysis perspectives.
4 analysis perspectives
| Commodity | Import/export by HS code and commodity name |
| Country | Import/export by trading partner |
| Transport Mode | By sea, air, road transport... |
| Province | Import/export by province/city |
Report types
- Monthly reports (1X/1N) – Monthly import/export figures
- Quarterly reports (2X/2N) – Quarterly aggregation and comparison
- Year-over-year comparison (HTX) – Changes vs same period last year
Provided metrics
- Period values (monthly/quarterly) and cumulative
- Period volume and cumulative
- Year-over-year growth rate (YoY %)
Requires Premium tier to access Customs data.
Survey & Governance Data
Provincial survey indices on governance, competitiveness and public administration reform in Vietnam, standardized by province and year.
Index sets
Provincial Governance and Public Administration Performance Index
Citizens' experience of public governance
Provincial Competitiveness Index
Quality of provincial economic governance
Public Administration Reform Index
Administrative reform results of ministries and localities
Satisfaction Index of Public Administrative Services
Satisfaction of citizens and organizations
ICT Readiness Index
Digital transformation and IT infrastructure readiness
Available in the Vietnam Data area of the app.
Microdata
Household- and enterprise-level micro survey datasets for in-depth analysis and quantitative research.
Datasets
Vietnam Household Living Standards Survey
Household income, expenditure, education and health
Vietnam Access to Resources Household Survey
Rural land, credit and labor
Vietnam Enterprise Survey
Firm size, labor and business performance
Some microdata sets require an upgraded tier to download full data.
EcoData retrieval toolkit
Use the client toolkit when you need EcoData inside your research software, not only as a browser export. All clients call the same /api/v1/sdmx API and require a personal API key.
Create and protect the API key
- 1Open Dashboard > API Access and create a key named after the research project or software client.
- 2Copy the full key once and store it in an environment variable, ~/.ecodata, Office task pane storage, or a secure password manager.
- 3Revoke the key from the dashboard when a project ends, a device is lost, or a collaborator no longer needs access.
Choose the dataflow
- MACRO_INTL for international macro indicators by indicator, country, and frequency.
- GSO_VN for Vietnam GSO indicators by indicator, province, dataset, and frequency.
- CUSTOMS_VN for import-export panels by province, flow, measure, and frequency.
- STOCK_VN for Vietnam market series by symbol, metric, and frequency.
Run the client in your software
Python, R, and Stata core clients have passed production live smokes with real data. Stata and Excel have self-hosted routes. PyPI, CRAN, SSC, AppSource, and manual Excel runtime gates remain separate release steps where noted.
Python
Core verified; PyPI pending
pip install ecodata- 1Set ECODATA_API_KEY or save the key in ~/.ecodata.
- 2Use EcoData().dataflows() to inspect available dataflows.
- 3Call series(...) with dimensions such as indicator, ref_area, freq, start, and end.
eco.series("MACRO_INTL", indicator="NY.GDP.MKTP.CD", ref_area=["VNM", "USA"], freq="A", start=2010)R
Core verified; CRAN pending
install.packages("ecodata_0.1.0.tar.gz", repos = NULL, type = "source")- 1Set options(ecodata.api_key=...) or ECODATA_API_KEY.
- 2Use eco_dataflows() and eco_search_indicators() before querying a series.
- 3Call eco_series(...) to return a tidy tibble with TIME_PERIOD and OBS_VALUE.
eco_series("MACRO_INTL", indicator = "NY.GDP.MKTP.CD", ref_area = c("VNM", "USA"), freq = "A", start = 2010)Stata
Self-host verified; SSC pending
net install ecodata, from("https://ecodata.io.vn/clients/stata") replace- 1Install from the self-hosted /clients/stata route.
- 2Run ecodata setkey eco_live_... for the current Stata session.
- 3Use ecodata use to load SDMX-CSV into a frame or replace memory with clear.
ecodata use MACRO_INTL, indicator(NY.GDP.MKTP.CD) ref_area(VNM USA) freq(A) start(2015) frame(gdp)Excel
Self-host data layer verified; AppSource pending
https://ecodata.io.vn/excel/manifest.xml- 1Use the self-hosted manifest for sideloading while AppSource review is pending.
- 2Save the API key in the task pane before inserting or refreshing data.
- 3Use the task pane insert flow or the ECODATA.SERIES custom function.
=ECODATA.SERIES("MACRO_INTL","NY.GDP.MKTP.CD.VNM.A","2019","2023")Econometric Analysis
The built-in Econometric Analysis tool helps students and researchers immediately assess the practicality and feasibility of their research, following an end-to-end workflow from data preparation to exporting reproducible code.
A 4-step workflow
Data preparation
Filter data scope → select indicators → compute variables → clean data → descriptive statistics.
Analysis models
Build proposed and alternative models → estimate and test → robustness checks and model selection.
Report presentation
Export results in citation styles: APA 7th, Chicago 8th, Harvard 2008, IEEE 2008 and MLA 7th.
Export reproducible code
Generate complete code from indicator selection to report export, ready to run on Stata, R and Python.
Supported citation styles
Code export targets
Available to paid membership tiers.
Using Econometric Analysis
Guide to running a complete econometric analysis workflow.
- 1Open the Econometric Analysis area and start the analysis flow
- 2Step 1 – Data preparation: filter scope, select indicators, create computed variables, clean and view descriptive statistics
- 3Step 2 – Models: build proposed and alternative models, estimate and test, run robustness checks
- 4Step 3 – Report: choose a presentation style (APA 7th, Chicago 8th, Harvard 2008, IEEE 2008, MLA 7th) and export the report
- 5Step 4 – Reproduce: export the complete code to run on Stata, R or Python
Search Economic Indicators
Guide to using the Dashboard to find, filter and view international economic indicators.
- 1Log in and navigate to the Dashboard (/app)
- 2Use the left-side filters to narrow scope: select category, data source, country
- 3Type keywords in the "Search" box to quickly filter by indicator name
- 4Click on an indicator name to view details: description, chart, historical data
- 5Check the indicators you need with checkboxes, then click "Export Data"
Using Stock Explorer
Guide to searching Vietnam stock market data.
- 1Navigate to the Stocks page at /stocks (from menu or direct URL)
- 2Search for a ticker using the search box, or filter by group (exchange, index) and ICB industry
- 3Click on a ticker to view its detail page
- 4Select report type: Balance Sheet, Income Statement, Cash Flow, Financial Ratios
- 5Choose reporting period: Annual or Quarterly
- 6For bulk export: select multiple tickers and click "Bulk Export" to download Excel file
Using GSO Explorer
Guide to searching General Statistics Office data.
- 1Navigate to the GSO page at /data/gso (requires Basic tier or above)
- 2Select provinces from the left panel (you can select multiple)
- 3Choose the year range for data viewing
- 4Select economic categories and indicators from the list
- 5Switch view mode: Data Table, Pivot Table, or Chart
- 6Click "Export Data" to download Excel (.xlsx) or CSV (.csv) file
Using Customs Explorer
Guide to searching import/export data.
- 1Navigate to the Customs page at /data/customs (requires Premium tier)
- 2Select analysis perspective: Commodity, Country, Transport Mode, or Province
- 3Set up filters: year, month, keyword search for commodity or country
- 4View data in paginated table (500 rows/page, click "Load More" for more)
- 5Click export button to download CSV or JSON file
Export & Download Data
Guide to exporting data from Explorer pages.
- 1Select the data you want to export (check individual indicators or select all)
- 2Click the "Export Data" button or the download icon
- 3Choose format: Excel (.xlsx), CSV (.csv), or JSON (.json) depending on the page
- 4Preview data before downloading (if option available)
- 5File will be downloaded with auto-generated date-stamped name (e.g., GSO_Data_2026-03-24.xlsx)
Supported formats by page
| Dashboard (International Indicators) | Excel, CSV |
| Stock Explorer | Excel (.xlsx) |
| GSO Explorer | Excel (.xlsx), CSV (.csv) |
| Customs Explorer | CSV (.csv), JSON (.json) |
Export limits by membership tier
| Free | Limited indicators and daily export quota |
| Basic / Premium | Increased export limits and advanced data access |
| Lifetime | Unlimited exports, full data access |
Glossary
Definitions of economic and technical terms used in EcoData.
| Term | Full Name | Definition |
|---|---|---|
| GDP | Gross Domestic Product | Total value of goods and services produced within a country during a specific time period. |
| GNI | Gross National Income | GDP plus net income from abroad. |
| CPI | Consumer Price Index | Measures changes in the price of a basket of consumer goods and services over time. |
| FDI | Foreign Direct Investment | Long-term investment by foreign individuals or organizations into another country. |
| ODA | Official Development Assistance | Aid or concessional loans from governments and international organizations. |
| HOSE | Ho Chi Minh Stock Exchange | Vietnam's largest stock exchange, located in Ho Chi Minh City. |
| HNX | Hanoi Stock Exchange | Vietnam's second stock exchange, located in Hanoi. |
| UpCOM | Unlisted Public Company Market | Market for trading shares of public companies not listed on official exchanges. |
| ICB | Industry Classification Benchmark | International industry classification system used to categorize listed companies. |
| HS Code | Harmonized System | International commodity classification system used in import/export trade. |
| Pivot Table | - | A data reorganization tool that arranges data along multiple dimensions for analysis and comparison. |
| Bulk Export | - | Batch download – export multiple datasets at once instead of individually. |
| API | Application Programming Interface | Allows external systems to connect to and retrieve data from EcoData. |
| JWT | JSON Web Token | Authentication token format that verifies user identity when calling APIs. |
| GSO | General Statistics Office | Vietnam's national statistics agency providing official socio-economic data. |
| WB | World Bank | International financial organization supporting development and global economic data. |
| IMF | International Monetary Fund | International organization overseeing the global financial system and economic stability. |
| YoY | Year-over-Year | Comparison with the same period of the previous year. |
| ROE | Return on Equity | Return on equity – measures how efficiently a company uses shareholder capital. |
| ROA | Return on Assets | Return on total assets – measures how efficiently a company uses assets to generate profit. |
| P/E | Price-to-Earnings Ratio | Most common stock valuation metric, showing how much investors pay for each unit of earnings. |