GET
/api/v1/fear-greed$0.02US stock Fear & Greed index now: score, rating, 5 components, backtest
The current US stock-market Fear & Greed index (0–100, CNN-style) with its sentiment rating and all five weighted components — volatility, momentum, put/call, safe-haven demand, junk-bond demand — each with value, weight, and reading. Includes the last 30 days of scores and a backtest of S&P 500 forward returns by sentiment zone. A one-call read of market mood.
Example request
GET /api/v1/fear-greed
Response type (TypeScript)
interface FearGreedResponse {
source: string;
as_of: string;
index: string;
score: number;
rating: string;
components: Array<{
name: string;
value: number;
weight: number;
description: string;
detail: string;
}>;
recent: Array<{
date: string;
score: number;
}>;
backtest: Array<{
zone: string;
label: string;
entries: number;
periods: Array<{
period: string;
avg_return_percent: number;
win_rate_percent: number;
best_percent: number;
worst_percent: number;
samples: number;
}>;
}>;
}Example response (click to expand)
{
"source": "x402stock",
"as_of": "2026-06-05T01:01:02.000Z",
"index": "us_stock",
"score": 69,
"rating": "Greed",
"components": [
{
"name": "VOLATILITY",
"value": 63,
"weight": 25,
"description": "VIX vs 20-day average",
"detail": "VIX 15.4 / MA20 16.9"
},
{
"name": "MOMENTUM",
"value": 77,
"weight": 25,
"description": "S&P 500 vs 125-day MA",
"detail": "SPY 757 / MA125 695"
},
{
"name": "PUT/CALL",
"value": 88,
"weight": 20,
"description": "Options sentiment (5-day avg)",
"detail": "VIX/VIX3M 0.8"
},
{
"name": "SAFE HAVEN",
"value": 61,
"weight": 15,
"description": "Stocks vs bonds 20-day",
"detail": "SPY-TLT +3.7%"
},
{
"name": "JUNK BONDS",
"value": 49,
"weight": 15,
"description": "High yield vs investment grade",
"detail": "HYG-LQD -0.1%"
}
],
"recent": [
{
"date": "2026-04-23",
"score": 65
},
{
"date": "2026-04-24",
"score": 67
},
{
"date": "2026-04-27",
"score": 67
},
{
"date": "2026-04-28",
"score": 70
},
{
"date": "2026-04-29",
"score": 66
},
{
"date": "2026-04-30",
"score": 63
},
{
"date": "2026-05-01",
"score": 70
},
{
"date": "2026-05-04",
"score": 61
},
{
"date": "2026-05-05",
"score": 64
},
{
"date": "2026-05-06",
"score": 67
},
{
"date": "2026-05-07",
"score": 66
},
{
"date": "2026-05-08",
"score": 67
},
{
"date": "2026-05-11",
"score": 59
},
{
"date": "2026-05-12",
"score": 63
},
{
"date": "2026-05-13",
"score": 64
},
{
"date": "2026-05-14",
"score": 65
},
{
"date": "2026-05-15",
"score": 63
},
{
"date": "2026-05-18",
"score": 61
},
{
"date": "2026-05-19",
"score": 65
},
{
"date": "2026-05-20",
"score": 63
},
{
"date": "2026-05-21",
"score": 66
},
{
"date": "2026-05-22",
"score": 66
},
{
"date": "2026-05-26",
"score": 67
},
{
"date": "2026-05-27",
"score": 65
},
{
"date": "2026-05-28",
"score": 67
},
{
"date": "2026-05-29",
"score": 69
},
{
"date": "2026-06-01",
"score": 62
},
{
"date": "2026-06-02",
"score": 67
},
{
"date": "2026-06-03",
"score": 69
},
{
"date": "2026-06-04",
"score": 67
}
],
"backtest": [
{
"zone": "extreme_fear",
"label": "Extreme Fear (0–20)",
"entries": 31,
"periods": [
{
"period": "1 Month",
"avg_return_percent": 4.37,
"win_rate_percent": 83,
"best_percent": 23.07,
"worst_percent": -11.68,
"samples": 30
},
{
"period": "3 Months",
"avg_return_percent": 9.26,
"win_rate_percent": 90,
"best_percent": 34.9,
"worst_percent": -5.37,
"samples": 30
},
{
"period": "6 Months",
"avg_return_percent": 13.35,
"win_rate_percent": 90,
"best_percent": 42.91,
"worst_percent": -6.84,
"samples": 30
}
]
},
{
"zone": "fear",
"label": "Fear (21–40)",
"entries": 114,
"periods": [
{
"period": "1 Month",
"avg_return_percent": 1.91,
"win_rate_percent": 70,
"best_percent": 17.08,
"worst_percent": -33.14,
"samples": 114
},
{
"period": "3 Months",
"avg_return_percent": 4.77,
"win_rate_percent": 74,
"best_percent": 29.63,
"worst_percent": -12.27,
"samples": 110
},
{
"period": "6 Months",
"avg_return_percent": 8.61,
"win_rate_percent": 80,
"best_percent": 37.48,
"worst_percent": -17.56,
"samples": 106
}
]
},
{
"zone": "neutral",
"label": "Neutral (41–60)",
"entries": 256,
"periods": [
{
"period": "1 Month",
"avg_return_percent": 1.33,
"win_rate_percent": 72,
"best_percent": 11.35,
"worst_percent": -10.21,
"samples": 254
},
{
"period": "3 Months",
"avg_return_percent": 3.3,
"win_rate_percent": 74,
"best_percent": 18.21,
"worst_percent": -23.02,
"samples": 250
},
{
"period": "6 Months",
"avg_return_percent": 6.7,
"win_rate_percent": 79,
"best_percent": 26.46,
"worst_percent": -25.25,
"samples": 243
}
]
},
{
"zone": "greed",
"label": "Greed (61–80)",
"entries": 154,
"periods": [
{
"period": "1 Month",
"avg_return_percent": 1.04,
"win_rate_percent": 70,
"best_percent": 9.06,
"worst_percent": -10.18,
"samples": 153
},
{
"period": "3 Months",
"avg_return_percent": 2.84,
"win_rate_percent": 75,
"best_percent": 14.72,
"worst_percent": -24.9,
"samples": 152
},
{
"period": "6 Months",
"avg_return_percent": 6.5,
"win_rate_percent": 79,
"best_percent": 22.6,
"worst_percent": -20.91,
"samples": 150
}
]
},
{
"zone": "extreme_greed",
"label": "Extreme Greed (81–100)",
"entries": 7,
"periods": [
{
"period": "1 Mon
… (truncated — call the endpoint for the full response)