Skip to content

MaxFritzhand/foreignaidquerying

Repository files navigation

Foreign Aid Explorer & Investment Catalyst

A sophisticated Next.js application designed to visualize global Foreign Aid flows and derive actionable investment insights from geopolitical financial patterns.

🚀 Key Features

  • Sankey Flow Visualization: Interactive mapping of aid from Donor nations to Recipient nations using high-fidelity OECD/World Bank data.
  • Investment Catalyst: An AI-driven engine that analyzes aid patterns (e.g., shifts in semiconductor investment or regional infrastructure support) to identify market opportunities.
  • Live Market Integration: Combines aid data with real-world market tickers (ETFs like GDX, EZA, ICVT, LIT, TAN) to provide context on how geopolitical spending correlates with market trends.
  • Deep Metrics: Granular transaction analysis, including total volume, year-over-year trends, and sector-specific breakdowns.
  • Modern UI/UX: Built with a sleek, dark-themed aesthetic using Shadcn UI and Nivo charts for professional-grade data visualization.

🛠 Tech Stack

  • Framework: Next.js 14+ (App Router)
  • Styling: Tailwind CSS
  • Components: Shadcn UI / Lucide React
  • Data Visualization: @nivo/sankey / @nivo/line
  • Logic: Custom investment analysis algorithms for trend detection.

📊 Data & Financial Insights

The application integrates real proxy data based on OECD CRS (Creditor Reporting System) and World Bank 2022-2024 statistics. It specifically tracks:

  • Infrastructure & Energy: Correlation between utility aid and energy sector ETFs (e.g., TAN, LIT).
  • Emerging Markets: Aid-driven catalysts for regional funds (e.g., EZA).
  • Market Resilience: Real-time price tracking for related financial instruments via the integrated market data API.

🚦 Getting Started

  1. Clone & Install:

    git clone https://github.com/maxfritzhand/foreignaidquerying.git
    cd foreignaidquerying
    pnpm install
  2. Run Development Server:

    pnpm dev
  3. Open http://localhost:3000 to explore the platform.

📝 Scripts

  • fetch_real_data.py: Fetches and processes high-fidelity aid data from OECD/World Bank sources.
  • fetch_market_data.py: Updates local market pricing for the Investment Catalyst engine.
  • generate_mock_data.py: Utility for generating development datasets.