Why Choose EcoData?

EcoData Overview

EcoData is a professional economic and financial data platform designed to help lecturers, postgraduate students, researchers, and analysts access data from over 170 prestigious domestic and international sources in a unified interface. From macroeconomic indicators (200,000+ indicators from World Bank, IMF, OECD, ILO, FAO, UN, UNESCO...) to listed corporate financial statements, from General Statistics Office data to detailed Customs figures and household microdata surveys — all are cleaned, standardized, and publication-ready.

Core Platform Capabilities

• Integrated data from 170+ prestigious international sources (World Bank, IMF, OECD, ILO, FAO, UN, UNESCO, ADB, FRED, Eurostat, WTO, BIS...)
• Over 200,000 socioeconomic indicators standardized with the academic short code ss_dom_key_mod
• Comprehensive stock data for 2,500+ tickers on HOSE, HNX, and UpCOM with 4 financial statement types
• Provincial-level statistical data from the General Statistics Office (GSO) and governance surveys (PAPI, PCI, PAR, SIPAS)
• Household and enterprise microdata (VHLSS, VARHS, VES) and provincial VHLSS 8-dimension aggregate panels
• Multi-dimensional preview in Wide format matrix, smart numerical formatting, and data completeness slider
• Integrated econometric analysis tool, AI paper replication assistant, and natural language query chatbot
• Client ecosystem for direct integration: Python library, R package, Stata command, and Excel add-in

Target Audience

• Lecturers in economics, finance, and statistics – utilizing data for teaching and academic research
• Master and PhD candidates – accessing clean data for theses, dissertations, and ISI/Scopus publications
• Data analysts and financial specialists – monitoring macroeconomic, sector, and market trends
• Research institutes, universities, and policy centers – standardizing institutional research data

Architecture & Technology

EcoData is built on a modern client-server architecture combining columnar storage and high-throughput FIFO queuing, optimized for large-scale data retrieval and econometric analysis in academic environments.

Technology Stack

Standardized Data Processing Pipeline

1. 1Automated collection from 170+ open APIs via chunked ingestion and FIFO job queuing
2. 2Data cleaning, missing value handling, currency standardization, and ss_dom_key_mod mapping
3. 3Storage into optimized relational and columnar tables with bilingual metadata (VI/EN)
4. 4Delivery via intuitive exploration UI, Wide format matrix preview, and multi-format exports
5. 5Instant synchronization to SDMX endpoints serving Python, R, Stata, and Excel clients

System Authentication

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

1. 1Open your browser and go to: ecodata.io.vn
2. 2Click "Sign In" or "Start Free Trial" on the landing page
3. 3Enter your email and password (or sign in quickly with Google)
4. 4Click "Sign In" – the system will verify your credentials
5. 5If correct, you will be redirected to the Dashboard

Login Security

Dashboard Overview & Data Preview

Upon logging in, you will be directed to the main Dashboard (/app) – the command center unifying economic indicators from all international sources with instant preview and analytics.

Dashboard Features & New Enhancements

• Multi-dimensional filters: filter by economic domain, issuing organization, countries, and date ranges
• Smart search: bilingual (VI/EN) keyword search by indicator title or academic short code ss_dom_key_mod
• Wide format matrix preview: inspect multiple indicators simultaneously across countries in a wide table layout
• Smart numerical formatting: auto-compacts large numbers (K, M, B) on the web UI while preserving exact raw precision in export files
• Data completeness slider: filter time-series by continuity score from 0% to 100%
• Indicator drill-down: academic definitions, units of measurement, sources, interactive charts, and historical tables
• Multi-selection for bulk export or direct forwarding to the Econometric Analysis workspace

Membership Payment Guide

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

1. 1Sign in, open Checkout and select the membership plan you need.
2. 2Leave “Request electronic invoice” unchecked. EcoData shows only the Personal account and its matching QR code.
3. 3Transfer the exact amount with the order memo. You may upload the receipt and then select “I have transferred”.
4. 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

1. 1Select “Request electronic invoice”, choose the buyer type and complete the invoice details.
2. 2Review the details before creating the order. Company, Individual and Foreigner buyers all see only the Business account.
3. 3Transfer the exact amount with the order memo to the displayed Business account. Do not transfer to the Personal account.
4. 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.
5. 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

Retry a Pending Payment

1. 1If your latest payment is Pending, open the Membership Dashboard and select “Pay again”.
2. 2EcoData restores the plan and saved invoice details; you must still review and confirm them before creating a new order.
3. 3Once the new order is created successfully, the previous pending order is cancelled and superseded to prevent two plans from being activated.

International Economic Indicators & Coding Standards

EcoData integrates data from over 170 world-leading economic and financial institutions, providing 200,000+ macroeconomic, labor market, agricultural, trade, financial, and sustainable development indicators for more than 200 countries and territories.

Featured International Data Sources

Standardized Academic Short Code System (Ss_dom_key_mod)

To resolve indicator code fragmentation across international organizations, EcoData standardizes all indicator identifiers into the ss_dom_key_mod format for concise and intuitive coding:

Indicator Categories

• Macroeconomics (GDP, GNI, inflation, growth, budget deficits...)
• International Trade & FDI (imports, exports, trade balances, FDI inflows...)
• Labor Market & Society (employment, unemployment, wages, gender equality...)
• Agriculture, Food & Environment (FAO, food security, CO2 emissions...)
• Finance & Monetary (policy rates, exchange rates, M2 money supply...)
• Education, Science & Technology (UNESCO, R&D spending, patents...)
• Infrastructure & Digital Transformation (telecom, Internet, logistics...)

Vietnamese 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

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 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

Customs Data

Detailed import/export data from Vietnam's General Department of Customs, supporting multiple analysis perspectives.

4 Analysis Perspectives

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 %)

Survey & Governance Data

Provincial survey indices on governance, competitiveness and public administration reform in Vietnam, standardized by province and year.

Index Sets

Microdata

Household- and enterprise-level micro survey datasets for in-depth analysis and quantitative research.

Datasets

Provincial Living Standards Aggregate Data

The provincial aggregate dataset derived from the Vietnam Household Living Standard Survey (VHLSS) spans survey waves from 2010 to 2022 across all 63 provinces. Standardized from millions of raw household microdata records by the General Statistics Office into a local balanced panel, it is immediately ready for panel econometric regression models.

8 Quantified Socioeconomic Dimensions

• 1. Per capita income and composition by source (wages, agriculture, non-farm business)
• 2. Living expenditures and household consumption (food and non-food baskets)
• 3. Poverty and inequality: provincial Gini coefficient, general and multidimensional poverty rates
• 4. Housing and living conditions: average living area, permanent house ratio, electricity and clean water access
• 5. Education and training: net enrollment rates, household head educational attainment, education spending
• 6. Healthcare: health insurance coverage rate, medical visits, out-of-pocket health expenditure burden
• 7. Employment and livelihoods: trained labor ratio, provincial informal employment share
• 8. Social protection: social assistance beneficiary ratio and public transfer receipts

Technical Specifications for Econometrics

Ecodata Data 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 API Keys

1. 1Open Dashboard > API Access and create a key named after the research project or software client.
2. 2Copy the full key once and store it in an environment variable, ~/.ecodata, Office task pane storage, or a secure password manager.
3. 3Revoke the key from the dashboard when a project ends, a device is lost, or a collaborator no longer needs access.

Select Dataflows

• 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 Client in Your Environment

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

Supported Citation Styles

Code Export Targets

Using Econometric Analysis

Guide to running a complete econometric analysis workflow.

1. 1Open the Econometric Analysis area and start the analysis flow
2. 2Step 1 – Data preparation: filter scope, select indicators, create computed variables, clean and view descriptive statistics
3. 3Step 2 – Models: build proposed and alternative models, estimate and test, run robustness checks
4. 4Step 3 – Report: choose a presentation style (APA 7th, Chicago 8th, Harvard 2008, IEEE 2008, MLA 7th) and export the report
5. 5Step 4 – Reproduce: export the complete code to run on Stata, R or Python

AI Paper Replication Assistant

The AI Replication Assistant empowers postgraduate students, PhD researchers, and economists to verify, learn from, and replicate top-tier empirical economics papers. By pairing domain-tuned language models with EcoData's standardized data repository, the system creates a seamless end-to-end replication workflow.

4-step Automated Replication Workflow

1. 1Upload paper (PDF) or provide DOI: AI analyzes paper structure, research questions, and hypotheses
2. 2Extract econometric specifications: identifies dependent variables, core regressors, controls, and estimation methods (OLS, FE, RE, GMM, DID)
3. 3Automated variable mapping: maps paper variables to standardized indicators in EcoData's repository
4. 4Generate full replication bundle: downloads runnable scripts (Stata .do, R script, Python notebook) with extracted datasets for immediate robustness checks

Breakthrough Advantages for Researchers

• Reduces data preparation and econometric coding time from weeks to minutes
• Ensures complete research transparency and scientific reproducibility
• Enables seamless paper extensions with updated years or applied to Vietnam's context
• Session Tracking preserves research workflows and allows collaborative sharing

AI Chatbot & Economic Assistant

EcoData AI Chat is an intelligent conversational interface enabling researchers to interact directly with vast datasets using natural language. No need to memorize indicator codes or complex API parameters — ask questions just as you would with a seasoned data analyst.

Intelligent Analytical Capabilities

• Understands natural language in Vietnamese and English with economics domain context
• Automatically identifies economic entities: countries, provinces, relevant indicators, units, and timeframes
• Aggregates and derives metrics: computes growth rates, share breakdowns, and inflation-adjusted values
• Renders interactive summary tables and comparison charts directly inside the conversation stream
• One-click export to Excel/CSV or code snippet generation for Python, R, and Stata

Common Sample Prompts

• “Compare GDP growth and inflation for Vietnam, Thailand, and Indonesia over the past 10 years”
• “Export a table of Vietnam's textile and electronics exports to the US from 2018 to 2023”
• “Top 10 provinces by PCI in 2023 along with time costs and transparency sub-indices”
• “Find renewable energy indicators for ASEAN countries from World Bank and IRENA sources”

Connecting AI Assistants via Model Context Protocol

The Model Context Protocol (MCP) is an open standard that allows Large Language Models (LLMs) and AI development tools to securely connect with EcoData. You can analyze macro indicators, financial statements, and enterprise ratios directly inside the Gemini Spark chat or code editor without switching apps.

Step-by-step Connection Guides

Jev Co-Processor: Inference Optimization & Academic Verification

In modern econometric and financial research, leveraging Large Language Models (LLMs) frequently encounters three major hurdles: context window saturation when exposing excessive tools, steep latency and costs from repetitive calls, and empirical hallucination (claims contradicting estimated regression tables). The Jev Co-Processor is integrated directly into EcoData to resolve these challenges via an intelligent hybrid architecture combining high-speed semantic intuition with deterministic mathematical rules.

Five Breakthrough Pillars of the Jev Co-Processor

4-step Practical Workflow for Researchers

1. 1Step 1: Connect your preferred AI client to EcoData MCP via AntiGravity IDE, Claude Desktop, Cursor, or Gemini Spark as described in Section 13.
2. 2Step 2: Enter a plain natural language prompt (e.g., 'Perform an econometric study on the impact of FDI and trade openness on Vietnam GDP from 2000 to 2024').
3. 3Step 3: Jev Co-Processor triggers automatically: loading 7 macro tools, standardizing LaTeX formulas, extracting clean datasets, and estimating models.
4. 4Step 4: Receive an end-to-end academic paper: complete with LaTeX Markdown Tables 1, 2, 3, publication-ready figures, and downloadable Stata/R/Python replication bundles.

1-click Practical Prompt Examples

Search Economic Indicators

Guide to using the Dashboard to find, filter and view international economic indicators.

1. 1Log in and navigate to the Dashboard (/app)
2. 2Use the left-side filters to narrow scope: select category, data source, country
3. 3Type keywords in the "Search" box to quickly filter by indicator name
4. 4Click on an indicator name to view details: description, chart, historical data
5. 5Check the indicators you need with checkboxes, then click "Export Data"

Using Stock Explorer

Guide to searching Vietnam stock market data.

1. 1Navigate to the Stocks page at /stocks (from menu or direct URL)
2. 2Search for a ticker using the search box, or filter by group (exchange, index) and ICB industry
3. 3Click on a ticker to view its detail page
4. 4Select report type: Balance Sheet, Income Statement, Cash Flow, Financial Ratios
5. 5Choose reporting period: Annual or Quarterly
6. 6For bulk export: select multiple tickers and click "Bulk Export" to download Excel file

Using GSO Explorer

Guide to searching General Statistics Office data.

1. 1Navigate to the GSO page at /data/gso (requires Basic tier or above)
2. 2Select provinces from the left panel (you can select multiple)
3. 3Choose the year range for data viewing
4. 4Select economic categories and indicators from the list
5. 5Switch view mode: Data Table, Pivot Table, or Chart
6. 6Click "Export Data" to download Excel (.xlsx) or CSV (.csv) file

Using Customs Explorer

Guide to searching import/export data.

1. 1Navigate to the Customs page at /data/customs (requires Premium tier)
2. 2Select analysis perspective: Commodity, Country, Transport Mode, or Province
3. 3Set up filters: year, month, keyword search for commodity or country
4. 4View data in paginated table (500 rows/page, click "Load More" for more)
5. 5Click export button to download CSV or JSON file

Standardized Data Export & Downloads

EcoData delivers a versatile export engine supporting both Wide Format (indicator matrix) and standardized Long/Tidy Format, ensuring exported files are immediately ready for research software without tedious pre-processing.

1. 1Select data to export: check individual indicators in the table or click 'Select All'
2. 2Choose data layout: Wide Format (one indicator per column) or Long Format (TIME_PERIOD & OBS_VALUE columns)
3. 3Click 'Export Data' and choose your target format: Excel (.xlsx), CSV (.csv), JSON (.json), or Parquet (.parquet)
4. 4Inspect the interactive Preview modal to verify row counts, column structure, and completeness before downloading
5. 5The file downloads automatically with source and timestamp in the filename (e.g., EcoData_Wide_Macro_2026-09-05.xlsx)

Format Selection: Wide Format vs Long Format

Smart Numerical Formatting & Metadata Inclusion

• Display numbers: Web UI automatically compacts large numbers (K, M, B) for readability, while Excel/CSV exports preserve exact unrounded raw values
• Metadata sheet included: Exported Excel workbooks automatically include a dedicated 'Metadata' tab detailing definitions, units, sources, and official citations
• Parquet format support: Enterprise users can export compressed Apache Parquet columnar files for large-scale datasets, loading up to 10x faster than CSV

Supported Formats by Module

Export Quotas by Membership Tier

Glossary

Definitions of economic and technical terms used in EcoData.

Frequently Asked Questions & Answers

Common Answers Regarding Data Extraction, File Formats, Academic Licensing, and API Connections.