> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrovisonomics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Sources

> Understand where MACROVISONOMICS data comes from — 16+ authoritative global sources

# Data Sources

MACROVISONOMICS provides access to economic data from 16+ trusted global institutions, searched in parallel across 24+ vector namespaces with intelligent cross-source ranking.

## Structured Data Sources

### World Bank

The primary data source for global development indicators.

<Card title="World Bank Open Data" icon="building-columns">
  **Coverage**: 189 countries and territories

  **Indicators**: 1,500+ across economy, health, education, trade, environment

  **Time Range**: 1960 - Present

  **Update Frequency**: Annual (with some quarterly indicators)

  **Categories**: Economic, Social, Environmental, Governance
</Card>

### FRED (Federal Reserve Economic Data)

US macroeconomic data from the Federal Reserve Bank of St. Louis.

<Card title="Federal Reserve Bank of St. Louis" icon="landmark">
  **Coverage**: United States

  **Indicators**: 800,000+ series including GDP, CPI, unemployment, interest rates, money supply, housing

  **Update Frequency**: Varies (daily, weekly, monthly, quarterly, annual)

  **Usage**: Primary US data source and context for AI-generated insights
</Card>

### IMF (International Monetary Fund)

Global financial and fiscal data from the IMF.

<Card title="International Monetary Fund" icon="landmark">
  **Coverage**: 190 countries

  **Indicators**: 32,000+ covering fiscal policy, balance of payments, international reserves, exchange rates, government debt

  **Update Frequency**: Quarterly and annual

  **Expertise**: Finance, monetary policy, fiscal policy, reserves, exchange rates
</Card>

### OECD

Economic and social data from the Organisation for Economic Co-operation and Development.

<Card title="OECD Statistics" icon="building-2">
  **Coverage**: 38 member countries plus partner nations

  **Indicators**: 15,000+ on economic performance, trade, employment, CPI, migration, energy, environment

  **Update Frequency**: Varies by dataset

  **Expertise**: Advanced economy statistics, GDP, trade, CPI
</Card>

### Eurostat

Statistical Office of the European Union.

<Card title="Eurostat" icon="euro">
  **Coverage**: 37 EU/EEA member states and candidate countries

  **Indicators**: 10,000+ covering regional economics, demographics, social statistics

  **Update Frequency**: Monthly, quarterly, and annual

  **Expertise**: European Union economic and demographic data
</Card>

### ECB (European Central Bank)

Monetary and financial statistics for the euro area.

<Card title="European Central Bank" icon="euro">
  **Coverage**: 20 eurozone countries

  **Indicators**: 5,000+ including interest rates, exchange rates, money supply, balance sheet data

  **Update Frequency**: Daily to annual depending on indicator

  **Expertise**: Eurozone monetary policy, interest rates, exchange rates
</Card>

### ILO (International Labour Organization)

Global labor market data.

<Card title="International Labour Organization" icon="briefcase">
  **Coverage**: 180 countries

  **Indicators**: 12,000+ on employment, unemployment, wages, working conditions, labor force participation, social protection

  **Update Frequency**: Annual with some quarterly series

  **Expertise**: Employment, unemployment, wages, labor force statistics
</Card>

### UN Data

Aggregated statistics from United Nations agencies.

<Card title="United Nations Statistics Division" icon="users">
  **Coverage**: 200 countries

  **Indicators**: 20,000+ covering population, demographics, energy, environment, migration, development

  **Update Frequency**: Annual

  **Expertise**: Population, demographics, migration, environment
</Card>

### WHO (World Health Organization)

Global Health Observatory data.

<Card title="World Health Organization" icon="heart">
  **Coverage**: 194 countries

  **Indicators**: 6,000+ on mortality, disease prevalence, health expenditure, vaccination rates, health system capacity

  **Update Frequency**: Annual

  **Expertise**: Health, mortality, disease, vaccination, health expenditure
</Card>

### UNESCO

Education, science, and culture statistics.

<Card title="UNESCO Institute for Statistics" icon="graduation-cap">
  **Coverage**: 160 countries

  **Indicators**: 4,000+ on education access, literacy, school enrollment, teacher ratios, science and technology

  **Update Frequency**: Annual

  **Expertise**: Education, literacy, enrollment, teacher quality
</Card>

### FAO (Food and Agriculture Organization)

Global food and agriculture data.

<Card title="Food and Agriculture Organization" icon="wheat">
  **Coverage**: 195 countries

  **Indicators**: 15,000+ on food production, agriculture, livestock, crop yields, food security, nutrition, land use

  **Update Frequency**: Annual

  **Expertise**: Agriculture, food, crops, livestock, nutrition, food security
</Card>

### BIS (Bank for International Settlements)

International banking and financial statistics.

<Card title="Bank for International Settlements" icon="landmark">
  **Coverage**: 60 countries

  **Indicators**: 8,000+ on credit aggregates, property prices, debt securities, banking statistics, exchange rates

  **Update Frequency**: Quarterly

  **Expertise**: Credit, property prices, housing, banking, financial flows
</Card>

### WTO (World Trade Organization)

International trade data.

<Card title="World Trade Organization" icon="globe">
  **Coverage**: 164 member countries

  **Indicators**: 5,000+ on trade flows, tariff profiles, merchandise exports/imports, commercial services, trade policy

  **Update Frequency**: Annual

  **Expertise**: Trade, tariffs, exports, imports
</Card>

### DBnomics

Open database aggregator unifying data from 80+ providers.

<Card title="DBnomics" icon="database">
  **Coverage**: 150 countries from 80+ providers

  **Indicators**: 50,000+ from central banks, national statistics offices, and international organizations

  **Update Frequency**: Varies by provider

  **Usage**: Supplementary access to datasets from providers not directly integrated
</Card>

### Statistics Canada

Canada's national statistical office.

<Card title="Statistics Canada" icon="bar-chart-2">
  **Coverage**: Canada (all provinces and territories)

  **Indicators**: 3,000+ covering labor force, CPI, GDP, demographics, trade, provincial economic data

  **Update Frequency**: Monthly to annual

  **Expertise**: Canadian economic, labor, and demographic statistics
</Card>

### Governance (WGI)

Worldwide Governance Indicators.

<Card title="Worldwide Governance Indicators" icon="scale">
  **Coverage**: 200 countries

  **Indicators**: 500+ measuring voice and accountability, political stability, government effectiveness, regulatory quality, rule of law, corruption control

  **Update Frequency**: Annual

  **Expertise**: Governance, corruption, democracy, rule of law, transparency
</Card>

## Research Sources for AI Insights

When generating insights, the platform draws from additional research sources in parallel to provide contextual analysis alongside the economic data:

| Type                         | Purpose                                                                                                                                |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **News & Policy**            | Real-time news articles and policy developments for current context                                                                    |
| **Deep Web Search**          | Domain-filtered search for specialized reports and articles                                                                            |
| **Explanatory Sources**      | Grounded causal explanations with inline citations                                                                                     |
| **Structured Economic Data** | US macroeconomic context across key indicators                                                                                         |
| **Academic Research**        | Scholarly papers and studies for rigorous, cited context                                                                               |
| **Primary Source Documents** | Direct documents from central banks, government statistics offices, IMF, World Bank, and OECD (20+ countries, 14 indicator categories) |

All sources are queried in parallel, and the combined research context is used to produce insights with inline citations. The system continues to function gracefully when individual sources are unavailable.

## Cross-Source Search

When you search for an indicator, MACROVISONOMICS searches all data sources simultaneously using intelligent ranking to find the best matches across all sources:

* **Semantic search**: Understands meaning, not just keywords, so you can use natural language
* **Topic-aware expertise boosting**: Domain-relevant sources are prioritized automatically (e.g., labor statistics sources for employment queries, health databases for health queries, agricultural data for food and farming queries)
* **Cross-source ranking**: Results from all databases are ranked together to surface the most relevant indicators regardless of source
* **Source diversity**: Results span multiple relevant databases so you get comprehensive coverage

## Data Quality

### Verification

All data displayed in MACROVISONOMICS is:

* **Sourced directly** from official data providers via their APIs
* **Time-stamped** with fetch date
* **Attributed** to the original source with source-specific badges
* **URL-linked** to the original data source where possible

### Source Attribution

Every chart displays:

* **Data Source badge**: World Bank, FRED, IMF, OECD, or other source
* **Indicator ID**: Original source identifier
* **Last Updated**: When data was last refreshed
* **Direct link**: URL to the data on the source website

### Data Freshness

* Data is refreshed regularly from source APIs
* Stale-while-revalidate caching returns fast results while refreshing in the background
* Historical data remains consistent with official records

### Missing Data

Some data points may be unavailable because:

* The country didn't report data for that year
* Data collection methods changed
* Certain indicators aren't tracked by all sources or in all countries
* Some source APIs may be temporarily unavailable

<Tip>
  Gaps in the data are displayed as breaks in line charts or empty cells in tables. This accurately represents the actual data availability.
</Tip>

## Understanding Indicators

### Indicator Codes

Each indicator has a source-specific code:

| Source     | Example Code            | Indicator                            |
| ---------- | ----------------------- | ------------------------------------ |
| World Bank | NY.GDP.MKTP.CD          | GDP (current US\$)                   |
| World Bank | SL.UEM.TOTL.ZS          | Unemployment (% of labor force)      |
| FRED       | GDPC1                   | Real GDP (chained 2017 dollars)      |
| FRED       | UNRATE                  | Civilian unemployment rate           |
| OECD       | PRICES                  | Consumer Price Index                 |
| IMF        | BCA\_BP6\_USD           | Balance of payments, current account |
| ILO        | UNE\_DEAP\_SEX\_AGE\_RT | Unemployment rate by sex and age     |
| WHO        | WHOSIS\_000001          | Life expectancy at birth             |

### Units

Common units across indicators:

| Unit                   | Meaning                    |
| ---------------------- | -------------------------- |
| **Current US\$**       | Dollar value at the time   |
| **Constant 2015 US\$** | Inflation-adjusted dollars |
| **%**                  | Percentage                 |
| **Per 1,000**          | Rate per thousand people   |
| **Per capita**         | Per person                 |
| **Index**              | Relative to a base year    |

## Citation & Attribution

When using MACROVISONOMICS data in research or publications:

### Suggested Citation Format

```
Data source: [Source Name] via MACROVISONOMICS
Indicator: [Indicator Name] ([Indicator Code])
Countries: [List of countries]
Time period: [Start year] - [End year]
Accessed: [Date]
```

### Terms of Use

Data from each source is subject to its own licensing terms:

* **World Bank**: Creative Commons Attribution 4.0 (CC BY 4.0)
* **FRED**: Public domain with attribution requested
* **IMF**: Terms of Use apply; attribution required
* **OECD**: Terms and Conditions; citation required
* **Other sources**: Refer to each source's data usage policy

## Data Updates

### Update Schedule

* Most indicators are updated annually
* FRED indicators may update daily, weekly, or monthly
* ECB and financial indicators may update daily
* Data for the current year may be preliminary

### Historical Revisions

Official data sources occasionally revise historical figures. When this happens:

* The latest official values are displayed
* Previous values are updated to match source records
* Charts automatically reflect the most current data