# Stock Market Fear & Greed Index API > Live CNN Fear & Greed Index for the US stock market — no key, nothing stored. The equity-market sentiment gauge: a single 0–100 score (0 = extreme fear, 100 = extreme greed) built from seven market indicators, distinct from the crypto Fear & Greed index in the catalogue. The index endpoint returns the headline score and rating plus the previous close and the readings one week, one month and one year ago, so you can see how sentiment has shifted. The components endpoint breaks the index into its seven underlying indicators — market momentum, stock-price strength, stock-price breadth, put/call options, market volatility (VIX), junk-bond demand and safe-haven demand — each with its own score and fear/greed rating, so you can see what is actually driving sentiment. The history endpoint returns the daily score timeline for the last year. Build market-sentiment dashboards, contrarian-signal bots, risk dashboards and newsletter widgets on top of the most-watched sentiment gauge in equities. Score bands: 0–24 extreme fear, 25–44 fear, 45–55 neutral, 56–75 greed, 76–100 extreme greed. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/stockfeargreed-api/..." ``` ## Pricing - **Free** (Free) — 12,000 calls/Mo, 3 req/s - **Starter** ($8/Mo) — 190,000 calls/Mo, 10 req/s - **Pro** ($23/Mo) — 820,000 calls/Mo, 28 req/s - **Scale** ($52/Mo) — 3,100,000 calls/Mo, 60 req/s ## Endpoints ### Index #### `GET /v1/index` — Headline score, rating and prior readings **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stockfeargreed-api/v1/index" ``` **Response:** ```json { "data": { "index": "CNN Fear & Greed (US stocks)", "score": 29.69, "rating": "fear", "source": "CNN Business", "updated": "2026-06-11T23:59:42+00:00", "week_ago": 53.89, "year_ago": 64.2, "month_ago": 66.63, "previous_close": 27.46 }, "meta": { "timestamp": "2026-06-12T01:42:36.320Z", "request_id": "cc1ada74-f7c5-4758-a5a1-0c4f25552854" }, "status": "ok", "message": "Index retrieved successfully", "success": true } ``` ### Components #### `GET /v1/components` — The seven underlying indicators **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stockfeargreed-api/v1/components" ``` **Response:** ```json { "data": { "count": 9, "index": "CNN Fear & Greed (US stocks)", "source": "CNN Business", "components": [ { "label": "Market Momentum (S&P 500)", "score": 51.2, "rating": "neutral", "indicator": "market_momentum_sp500" }, { "label": "Market Momentum (S&P 125-day)", "score": 51.2, "rating": "neutral", "indicator": "market_momentum_sp125" }, { "label": "Stock Price Strength", "score": 31.6, "rating": "fear", "indicator": "stock_price_strength" }, { "label": "Stock Price Breadth", "score": 19.2, "rating": "extreme fear", "indicator": "stock_price_breadth" }, { "label": "Put/Call Options", "score": 27, "rating": "fear", "indicator": "put_call_options" }, { "label": "Market Volatility (VIX)", "score": 50, "rating": "neutral", "indicator": "market_volatility_vix" }, { "label": "Market Volatility (VIX 50-day)", "score": 50, "rating": "neutral", "indicato …(truncated, see openapi.json for full schema) ``` ### History #### `GET /v1/history` — Daily score timeline **Parameters:** - `limit` (query, optional, string) — Days back (default 30, max 365) Example: `30` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stockfeargreed-api/v1/history?limit=30" ``` **Response:** ```json { "data": { "count": 30, "index": "CNN Fear & Greed (US stocks)", "source": "CNN Business", "history": [ { "date": "2026-05-01T00:00:00.000Z", "score": 71.17, "rating": "greed" }, { "date": "2026-05-04T00:00:00.000Z", "score": 66.89, "rating": "greed" }, { "date": "2026-05-05T00:00:00.000Z", "score": 67.26, "rating": "greed" }, { "date": "2026-05-06T00:00:00.000Z", "score": 68.74, "rating": "greed" }, { "date": "2026-05-07T00:00:00.000Z", "score": 67.29, "rating": "greed" }, { "date": "2026-05-08T00:00:00.000Z", "score": 67.29, "rating": "greed" }, { "date": "2026-05-11T00:00:00.000Z", "score": 66.63, "rating": "greed" }, { "date": "2026-05-12T00:00:00.000Z", "score": 65.69, "rating": "greed" }, { "date": "2026-05-13T00:00:00.000Z", "score": 64.97, "rating": "greed" }, { "date" …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stockfeargreed-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Score bands: 0–24 extreme fear, 25–44 fear, 45–55 neutral, 56–75 greed, 76–100 extreme greed. The index updates through the US trading day.", "source": "CNN Fear & Greed public feed (production.dataviz.cnn.io, live)", "service": "stockfeargreed-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/index": "Headline score, rating and prior readings (close, 1w, 1m, 1y).", "GET /v1/history": "Daily score timeline (limit=30, max 365).", "GET /v1/components": "The seven underlying indicators with their scores and ratings." }, "description": "Live CNN Fear & Greed Index for the US stock market. A single 0–100 sentiment score (0 = extreme fear, 100 = extreme greed) built from seven market indicators. index = headline score and rating plus previous close and the readings one week, one month and one year ago; components = the seven underlying indicators (market momentum, stock-price strength, stock-price breadth, put/call options, market volatility VIX, junk-bond demand, safe-haven demand), each with its own score and rating; history = the daily score timeline for the last year. Live, no key, nothing stored. The equity-market sentiment gauge, distinct from the crypto Fear & Greed index.", "current_score": 29.7, "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-12T01:42:36.581Z", "request_id": "8c …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/stockfeargreed-api OpenAPI spec: https://www.oanor.com/api/stockfeargreed-api/openapi.json