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

# Introduction

> Explore, visualize, and share economic data from 217+ countries and territories with AI-powered insights, 21 chart types, and 500,000+ indicators from 16+ sources

# Welcome to MACROVISONOMICS

MACROVISONOMICS is an economic data intelligence platform that helps you explore, visualize, and share economic data from around the world. Whether you're a financial analyst, policy researcher, student, or simply curious about global economic trends, MACROVISONOMICS turns complex data into clear, shareable insights.

## What You Can Do

<CardGroup cols={2}>
  <Card title="Search Economic Data" icon="magnifying-glass" href="/features/smart-search">
    Find economic indicators using natural language search. Just ask what you want to know.
  </Card>

  <Card title="Create Visualizations" icon="chart-line" href="/features/chart-types">
    Build beautiful charts with 21 visualization types including line, bar, bubble, choropleth maps, and more.
  </Card>

  <Card title="Compare Countries" icon="globe" href="/guides/country-groups">
    Compare economic metrics across countries, regions, income groups, and economic blocs like G7, BRICS, and EU.
  </Card>

  <Card title="Get AI Insights" icon="lightbulb" href="/features/insights">
    Receive automatic analysis explaining trends, patterns, and key findings in your data.
  </Card>

  <Card title="Save & Organize" icon="folder" href="/features/my-space">
    Build a library of saved charts and watchlists. Organize with bookmark collections and access your visualizations anytime.
  </Card>

  <Card title="Share & Publish" icon="share" href="/features/publishing">
    Share charts with colleagues or publish to the community gallery for the world to see.
  </Card>

  <Card title="Blog & Research" icon="newspaper" href="https://macrovisonomics.com/blog">
    Read data-driven articles on global economic trends, methodology explainers, and platform updates.
  </Card>

  <Card title="Developer API" icon="code" href="/features/developer-api">
    Access data programmatically via REST API, MCP Server for AI agents, and OpenAPI specification.
  </Card>

  <Card title="Sovereign Debt Monitor" icon="landmark" href="/features/sovereign-debt">
    Yield curves, credit ratings, debt/GDP ratios, and government deficit analysis — integrated into country profiles at `/countries`.
  </Card>

  <Card title="Macro Screener" icon="filter" href="/features/screener">
    Filter and rank countries by economic conditions using a multi-condition builder with AI analysis — integrated into country profiles at `/countries`.
  </Card>

  <Card title="Trade & Supply Chain" icon="shopping-cart" href="/features/trade-analysis">
    Analyze trade openness, balance trends, and external dependencies in every country profile.
  </Card>

  <Card title="Global Market Monitor" icon="globe" href="/features/market-monitor">
    Cross-asset monitor: equities, currencies, commodities, bonds, and VIX volatility in one view.
  </Card>
</CardGroup>

## Platform Overview

### Intelligent Search

Search for any economic indicator using everyday language. No need to know database codes or technical terms. Choose between **Neural** (AI-powered semantic matching), **Keyword** (exact text matching), or **Research** (deep multi-step analysis) modes.

**Example searches:**

* "GDP growth in G7 countries"
* "Compare unemployment between US and Europe"
* "CO2 emissions per capita in BRICS nations since 2010"
* "How has life expectancy changed in developing countries"

The system understands your intent and finds the right data automatically.

### Rich Visualizations

Choose from 21 chart types to best represent your data:

| Category         | Chart Types                                     |
| ---------------- | ----------------------------------------------- |
| **Time-Series**  | Line, Area, Bar, Stream, Bump                   |
| **Geographic**   | World Map (Choropleth)                          |
| **Comparison**   | Bubble, Radar, Parallel Coordinates, Dumbbell   |
| **Distribution** | Treemap, Pie, Heatmap, Box Plot                 |
| **Specialty**    | Sankey, Waterfall, Candlestick, Small Multiples |

### Country Groups & Blocs

Easily analyze data for predefined groups:

* **Economic Blocs**: G7, G20, BRICS, EU, OECD, ASEAN
* **Regions**: East Asia & Pacific, Europe, Latin America, Middle East, Sub-Saharan Africa, South Asia
* **Income Levels**: High Income, Upper Middle, Lower Middle, Low Income

### AI-Powered Insights & Agent Orchestration

Every chart comes with automatic analysis that gathers context from multiple sources in parallel — including recent news, academic research, and primary documents from central banks and statistical offices — before generating insights with inline citations:

* Executive summary with key findings and patterns
* Top and bottom performers
* Trend direction and volatility
* Economic implications with research-backed citations
* **Agent orchestration**: complex queries automatically trigger multi-agent pipelines, where an LLM plans and sequences specialized agents for comprehensive analysis
* **Agent Processing Steps**: a visual indicator shows real-time progress during AI search (Understanding query → Searching indicators → Fetching data → Preparing visualization → Analyzing results)
* **Markets insights**: the Markets and Market Radar pages include AI-powered analysis covering market signals, technical indicators, ETF performance, and macro context

### Community Gallery

Discover insights from other users:

* Browse trending and featured charts
* Get inspired by creative analyses
* Share your work with the community
* Engage through likes and comments

## Data Sources

MACROVISONOMICS integrates 16+ active data sources:

* **World Bank**: 1,500+ indicators across 189 countries
* **FRED**: 800,000+ US macroeconomic series (GDP, CPI, unemployment, interest rates)
* **IMF**: Fiscal policy, balance of payments, reserves for 190 countries
* **OECD**: Economic performance across 38 member nations
* **Eurostat & ECB**: EU/eurozone economic and financial data
* **ILO**: Global labor market and employment statistics
* **WHO**: Global health data for 194 countries
* **FAO**: Food and agriculture data for 195 countries
* **WTO**: International trade data for 164 member countries
* **UNESCO**: Education, science, and culture statistics for 160 countries
* **BIS**: Banking and financial statistics
* **Statistics Canada**: Canadian economic, labor, and demographic data
* **DBnomics**: Aggregated data from 80+ providers
* **Governance (WGI)**: Governance indicators for 200 countries
* **UN Data**: Population, demographics, energy, and environment
* **217+** countries and territories
* **60+ years** of historical data with regular updates
* **Research sources**: News, deep web, explanatory sources, academic papers, and primary source documents from central banks and statistical offices

## Who Uses MACROVISONOMICS

<CardGroup cols={3}>
  <Card title="Analysts" icon="chart-bar">
    Track economic trends and create reports for stakeholders.
  </Card>

  <Card title="Researchers" icon="flask">
    Explore data patterns and support academic work.
  </Card>

  <Card title="Students" icon="graduation-cap">
    Learn about global economics with interactive visualizations.
  </Card>

  <Card title="Journalists" icon="newspaper">
    Create data-driven stories with shareable charts.
  </Card>

  <Card title="Investors" icon="coins">
    Understand macro trends affecting markets.
  </Card>

  <Card title="Educators" icon="chalkboard-user">
    Teach economic concepts with real data.
  </Card>
</CardGroup>

## Getting Started

<Steps>
  <Step title="Search for Data">
    Go to the [Dashboard](https://macrovisonomics.com/dashboard) and type what you're looking for.
  </Step>

  <Step title="Select Countries">
    Choose individual countries or groups like G7, BRICS, or entire regions.
  </Step>

  <Step title="Pick Your Chart">
    Select from 21 chart types to visualize your data.
  </Step>

  <Step title="Review Insights">
    Read the AI-generated analysis explaining your data.
  </Step>

  <Step title="Customize & Save">
    Adjust colors, date ranges, and settings. Save your chart to My Space or add indicators to a watchlist.
  </Step>

  <Step title="Share">
    Publish to the community or share a private link with colleagues.
  </Step>
</Steps>

### Developer Platform

Build on top of MACROVISONOMICS with our full-featured API and integration tools:

* **REST API**: 7 endpoints for search, data retrieval, insights, and forecasting with API key authentication
* **MCP Server**: Model Context Protocol server for AI agent integration (Claude, GPT, etc.)
* **OpenAPI Spec**: Interactive Swagger documentation at [/api-docs](https://macrovisonomics.com/api-docs) for client generation and GPT Actions
* **Rate Limiting**: Per-key rate limits with usage tracking across Free, Pro, Gold, and Enterprise tiers

## Quick Links

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/quickstart">
    Create your first chart in 5 minutes
  </Card>

  <Card title="Chart Examples" icon="images" href="/examples">
    See real charts from the community
  </Card>

  <Card title="Smart Search" icon="magnifying-glass" href="/features/smart-search">
    Learn search tips and techniques
  </Card>

  <Card title="Chart Types" icon="chart-pie" href="/features/chart-types">
    Explore all 21 visualization options
  </Card>

  <Card title="Developer API" icon="code" href="/features/developer-api">
    Build integrations with the REST API and MCP Server
  </Card>

  <Card title="API Docs" icon="plug" href="https://macrovisonomics.com/api-docs">
    Interactive API documentation (Swagger)
  </Card>
</CardGroup>

Ready to get started? Head to the [Quickstart Guide](/quickstart) to create your first visualization.