Public API

Free JSON endpoints for the Fear & Greed Index. Use in dashboards, trading tools, research, or any project. No API key required.

FREE CORS ENABLED 15-MIN CACHE NO AUTH

Fair use: Data is cached server-side for 15 minutes. Polling faster returns the same response. For most use cases, fetching once per page load or every 15 minutes is sufficient. Excessive automated requests from a single IP may be throttled.

Base URL

https://feargreedchart.com/api/

Endpoints

GET /?action=all

Returns everything in a single call: current score with all 5 component breakdowns, market data for major indices and sector ETFs, full score history, and backtest results.

score.scoreintComposite score (0–100)

score.componentsarray5 components with name,val, wt, desc, raw

marketobjectPrice, change, pct, closes for each symbol

recentarrayFull score history [{date, score}, ...]

sectorsobjectPer-sector sentiment scores (XLK, XLF, etc.)

backtestobjectForward returns by sentiment zone

tsintServer timestamp (ms)

GET /?action=history

Full score history as a JSON array. Each entry has a date (YYYY-MM-DD) and score (0–100). Includes seed estimates back to 2016 and daily computed scores from 2025 onward.

[].datestringDate in YYYY-MM-DD format

[].scoreintFear & Greed score (0–100)

GET /?action=history&format=csv

Same data as above, returned as a downloadable CSV file with date,score columns. Useful for Excel, Google Sheets, or data analysis workflows.

↓ DownloadCSV

GET /?action=market

Raw market data for all tracked symbols. Includes current price, daily change, percentage change, and an array of recent closing prices. Covers VIX, SPY, QQQ, DIA, IWM, and 11 sector ETFs.

{SYM}.pricefloatCurrent/last price

{SYM}.chgfloatDaily price change

{SYM}.pctfloatDaily percentage change

{SYM}.closesarrayRecent daily closing prices

GET /?action=backtest

Pre-computed S&P 500 forward returns after entries into each sentiment zone. Shows average return, win rate, best, and worst for 1-month, 3-month, and 6-month periods. Recomputed daily by cron.

GET /?action=news

Market headlines aggregated from Yahoo Finance, MarketWatch, and Reuters RSS feeds. Cached for 15 minutes. Returns up to 7 deduplicated articles sorted newest first.

[].titlestringHeadline text

[].linkstringURL to full article

[].publisherstringSource name

[].timeintUnix timestamp

GET /?action=crypto

Crypto Fear & Greed Index from alternative.me, BTC/ETH prices from Yahoo Finance, and stock F&G for comparison. 10-minute cache. Includes 365-day crypto sentiment history.

crypto_fng.scoreintCrypto Fear & Greed score(0-100)

crypto_fng.labelstringClassification: Extreme Fear, Fear, Neutral, Greed, Extreme Greed

prices.BTCUSD.pricefloatCurrent BTC price inUSD

prices.ETHUSD.pricefloatCurrent ETH price inUSD

stock_fng.scoreintStock market F&G score forcomparison

crypto_history[]array365-day crypto F&G history (date + score)

GET /?action=insider

Insider sentiment score computed from SEC Form 4 filings via SEC EDGAR. Rolling 30-day window of open-market purchases vs sales. 30-minute cache.

score.scoreintInsider sentiment score (0-100)

score.labelstringHeavy Selling, Sell Pressure, Neutral, Accumulation, Strong Conviction

score.components[]array4-component breakdown: Buy/Sell Ratio, C-Suite Conviction, Buy Momentum, Sell Pressure

score.statsobjectSummary: total_buys, total_sells, total_buy_val, total_sell_val, csuite_buys

top_buys[]arrayRecent notable insider purchases (symbol, name, title, shares, value, date)

top_sells[]arrayRecent notable insider sales

GET /?action=liquidity

US net liquidity index from FRED data. Net Liquidity = Fed Balance Sheet (WALCL) − Treasury General Account (WTREGEN) − Reverse Repo (RRPONTSYD). 6-hour cache.

scoreintLiquidity score (0-100, percentile within 2-year range)

labelstringVery Tight, Tight, Neutral, Loose, Very Loose

net_liquidityfloatCurrent net liquidity in trillions USD

trendfloat4-week change in trillions

trend_labelstringExpanding, Contracting, or Stable

components[]arrayFed Balance Sheet, TGA, RRP, M2 — each with value, date, series ID

history[]array~2 years of weekly net liquidity (date + net in trillions)

GET /?action=regime

Market regime analysis combining F&G score, insider sentiment, VIX, and US liquidity into a single regime assessment. 10-minute cache. Returns the current regime, all matching regimes, signal dashboard, and historical pattern matches.

regime.namestringCurrent regime: Capitulation Phase, Liquidity Squeeze, Euphoria Zone, Complacency with Headwinds, Fear with Macro Support, Recovery Phase, Risk-On Environment, Consolidation Phase, Neutral with Undercurrents

regime.severitystringRegime outlook: positive, negative, caution, neutral, moderate, watch

currentobjectSignal dashboard: fg_score, fg_zone, velocity, vel_dir, vix, vix_level, insider_score, insider_label, liq_score, liq_trend, liq_label

all_regimes[]arrayAll matching regimes (multiple can be active simultaneously)

history.episodesintCount of past episodes inthe same F&G zone

history.avg_fwd_5dfloatAverage 5-day forwardF&G score change from similar episodes

history.avg_fwd_22dfloatAverage 22-day forward F&G score change

history.avg_spy_1mfloatAverage 1-month SPY price return (%) from similar past episodes

history.avg_spy_3mfloatAverage 3-month SPY price return (%) from similar past episodes

history.win_rate_1mintPercentage of episodeswith positive 1-month SPY return

history.win_rate_3mintPercentage of episodeswith positive 3-month SPY return

Regional Indexes

Country-specific Fear & Greed APIs run on dedicated subdomains. Each has its own component set and data shape — see the linked docs for the full schema.

GET 🇰🇷https://kospi.feargreedchart.com/api/?action=kospi

Korean market Fear & Greed Index. Equal-weight 4-component model: Market Momentum (KOSPI vs 125d MA), Volatility (downside deviation), Safe-Haven Demand (USD/KRW), Foreign Flow (KRX Trading by Investor Type from Naver Finance). Refreshes daily after Seoul close.

Endpoints3?action=kospi, ?action=kospi-history, ?action=kospi-history.csv

Cache5minLive score; 1hr for history (JSON & CSV)

RefreshdailyAfter Seoul market close (15:30 KST)

Full KOSPI API docs →

GET 🇯🇵https://nikkei.feargreedchart.com/api/?action=nikkei

Japanese market Fear & Greed Index. Equal-weight 4-component model: Momentum (Nikkei 225 vs 125d MA), Volatility (downside deviation), Currency (USD/JPY 20d change), Foreign Flow (JPX TSE Prime weekly investor data). Refreshes daily after Tokyo close.

Endpoints5?action=nikkei, ?action=nikkei-rates, ?action=nikkei-history, ?action=nikkei-flow, ?action=health

Cache5minLive score; 1hr for history & rates

RefreshdailyAfter Tokyo close (16:45 JST); foreign flow refreshes Thursdays after JPX publishes

Full Nikkei API docs →

GET 🇮🇳https://nifty.feargreedchart.com/api/?action=nifty

Indian market Fear & Greed Index. Equal-weight 4-component model: Momentum (NIFTY 50 vs 125d MA), Volatility (downside deviation), Currency (USD/INR 20d change), and Foreign Flow (NSE FII cash net buying). Reverts to equal-weight on the first three while the FII history accumulates the 100 days needed for percentile ranking. Refreshes daily after NSE close.

Endpoints3?action=nifty, ?action=nifty-history, ?action=nifty-history.csv

Cache5minLive score; 1hr for history

RefreshdailyAfter NSE close (15:30 IST / 10:00 UTC), Mon–Fri

Full NIFTY API docs →

Quick Start

JAVASCRIPT

// Get today's score
fetch('https://feargreedchart.com/api/?action=all')
  .then(r => r.json())
  .then(data => {
    const score = data.score.score;
    const label = score <= 20 ? 'Extreme Fear'
               : score <= 40 ? 'Fear'
               : score <= 60 ? 'Neutral'
               : score <= 80 ? 'Greed'
               : 'Extreme Greed';
    console.log(`Fear & Greed: ${score} — ${label}`);
  });

PYTHON

import requests

r = requests.get("https://feargreedchart.com/api/?action=all")
data = r.json()

score = data["score"]["score"]
for c in data["score"]["components"]:
    print(f"{c['name']:12s} {c['val']:3d}  ({c['wt']}%)  {c['raw']}")
print(f"\nComposite: {score}")

Attribution appreciated: If you use this API in a public project, a link back to feargreedchart.com is appreciated but not required. Data is provided as-is with no uptime guarantee. Not financial advice.