# Market Signal — Full Documentation for AI Assistants

> Free financial dashboard at https://themarketsignal.net/ aggregating 40+ institutional-grade market indicators.

## Overview

Market Signal is a single-page web application that provides retail investors with institutional-quality market analysis. It aggregates data from multiple financial APIs and presents composite scores that simplify complex market dynamics into actionable readings.

## Dashboard Tabs

### Home Tab
The main dashboard showing:
- Live ticker bar with real-time prices for SPX, NDX, DJI, FTSE 100, Nikkei 225, BTC, ETH, Gold, Oil, US 10Y
- Interactive candlestick charts for each asset
- AI Market Brief: GPT-powered analysis of current market headlines identifying key themes
- Four composite score cards (Sentiment, Valuation, Economic Health, Correction Risk) plus individual liquidity/policy indicators

### Sentiment Tab
Detailed breakdown of sentiment indicators:
- CNN Fear & Greed Index (0-100 scale)
- Crypto Fear & Greed Index
- AAII Investor Sentiment Survey (bullish/bearish/neutral percentages)
- Equity Put/Call Ratio (CBOE)
- Total Put/Call Ratio
- VIX Volatility Index with term structure analysis
- Market Breadth (% of S&P 500 stocks above 200-day moving average)
- Consumer Discretionary vs Staples ratio (risk appetite proxy)

### Valuation Tab
Detailed breakdown of valuation metrics:
- Buffett Indicator (Total Market Cap / GDP)
- Shiller CAPE Ratio (Cyclically Adjusted P/E)
- Forward P/E Ratio (S&P 500)
- Equity Risk Premium (earnings yield minus risk-free rate)
- Tobin's Q Ratio (market value vs replacement cost)
- S&P 500 Price-to-Book Ratio
- Each metric includes historical percentile and plain-English interpretation

### Economy Tab
Economic health indicators:
- Real GDP Growth Rate (quarterly, annualized)
- Nonfarm Payroll Job Growth (monthly)
- ISM Manufacturing PMI
- ISM Services PMI
- CPI Inflation Rate (year-over-year)
- Federal Funds Rate and 10-Year Treasury Yield
- Yield Curve Spread (10Y minus 2Y)
- Initial Jobless Claims (weekly)
- University of Michigan Consumer Sentiment
- Investment Grade Credit Spreads (ICE BofA)

### Risk Tab
Correction risk assessment:
- Hindenburg Omen detection (breadth divergence signal)
- VIX level and term structure (contango vs backwardation)
- Market breadth deterioration trends
- Yield curve inversion status
- Composite correction probability score

### Liquidity Tab
Individual monetary policy and liquidity indicators (not a composite score):
- Federal Reserve Balance Sheet (total assets)
- Treasury General Account (TGA) balance
- M2 Money Supply growth
- US Dollar Index (DXY)
- Net Liquidity calculation (Fed Balance Sheet minus TGA minus Reverse Repo)

### Markets Tab
- Stock Screener: Screens S&P 500 stocks with momentum scoring based on RSI, moving average crossovers, volume trends, and relative performance
- Sortable/filterable table with buy/sell signals
- Sector-level analysis

## Composite Score Methodology

The dashboard has four composite scores (Sentiment, Valuation, Economic Health, Correction Risk). Each combines multiple indicators using weighted averages:
- Individual indicators are normalized to a 0-100 scale
- Weights reflect each indicator's historical predictive value
- Scores are categorized: Strong Buy / Bullish / Neutral / Bearish / Strong Sell
- Historical context shows where current readings sit vs past ranges
- Liquidity/policy indicators are presented individually, not as a composite

## Technical Details

- Built with React, Express.js, PostgreSQL
- Real-time data refreshed every 1-5 minutes depending on indicator
- Daily data (GDP, CAPE, etc.) cached for 24 hours
- All data sourced from public APIs (no proprietary data)
- Free to use, no login required for core dashboard

## URL

https://themarketsignal.net/