Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

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.

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /