A professional-grade real-time metal market analyst tool powered by Gemini 3 Flash with integrated Google Search Grounding. Track precious, industrial, battery, tech, and energy metals with high-precision AI analysis.
MetalQuest transforms raw market data into actionable intelligence. By leveraging the latest generative AI, it scans global exchanges (LME, COMEX, NYMEX) to provide spot prices, technical trends, and macroeconomic impact summaries.
- Real-Time Tickers: Live spot prices for Gold, Copper, Lithium, and Uranium.
- AI Analyst Chat: Interactive query interface for technical analysis and market "vibes".
- Google Search Grounding: Every report is backed by live web search results for 2026 data accuracy.
- Multi-Category Tracking: Organized views for Precious, Base, Battery, Ferrous, and Specialty metals.
- Security-First: Robust error handling, environment variable protection, and input sanitization.
- Framework: React 19 (ES6 Modules)
- AI Engine: Google Gemini API (
@google/genai) - Styling: Tailwind CSS
- Icons: Lucide React
- Type Safety: TypeScript
This project implements strict security patterns:
- API Isolation: The
process.env.API_KEYis never exposed to the client-side bundle in cleartext beyond necessary execution. - Input Sanitization: Chat inputs are trimmed and validated before being processed by the LLM.
- Response Validation: Fallback logic handles partial or failed AI generations to prevent UI crashes.
- Fail-Safe Initialisation: The
GoogleGenAIclient verifies the presence of credentials before every request.
-
Clone the repository:
git clone https://github.com/shards-inc/metalquest.git cd metalquest -
Set up environment: Ensure your
API_KEYis available in your environment. -
Execution: This project is designed to run in modern ES module environments. Simply serve the
index.html.
The logic is decoupled into services to facilitate unit testing. See tests/market.test.ts for the conceptual test suite covering:
- API response parsing.
- Sanity check triggers.
- Category mapping.
MIT License - Copyright (c) 2026 Shards Inc.