---
title: "Fear & Greed Index History"
method: GET
path: "/gateway/v1/market/fear-greed"
tags: ["Market"]
---

# Fear & Greed Index History

`GET /gateway/v1/market/fear-greed`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/market/fear-greed`
- Auth: HTTP bearer

Returns Bitcoin Fear & Greed Index history.

**Included fields:** index value (0-100), classification label, BTC price at each data point.

Sorted newest-first. Use `from`/`to` to filter by date range.

## Query parameters

- `from` string: Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD)
- `to` string: End of time range. Accepts Unix seconds or date string (YYYY-MM-DD)

## Response `200`

OK

- SimpleListResponseMarketFearGreedHistoryItem
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` MarketFearGreedHistoryItem[], nullable, required
    - `classification` string, required: Human-readable classification (Extreme Fear, Fear, Neutral, Greed, Extreme Greed)
    - `price` number, double, required: BTC price in USD at this point in time
    - `timestamp` integer, required: Unix timestamp in seconds for this data point
    - `value` integer, required: Fear and Greed Index score from 0 (extreme fear) to 100 (extreme greed)
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)