# Fear & Greed — Zapi reference

> Market sentiment on a 0-100 scale for crypto and US equities, with history and the sub-indicators behind the score.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/fear-greed
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Fear & Greed

**Category:** finance · **Slug:** `fear-greed`
**Detail page:** https://zpi.web.id/api/finance/fear-greed

Market sentiment on a 0-100 scale for crypto and US equities, with history and the sub-indicators behind the score.

**Tags:** sentiment, crypto, stocks, index, market-mood

### Crypto sentiment

The crypto Fear & Greed index, with history.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:fear-greed/crypto`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `count` | number | query | no | Days of history. Default 30, max 365 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:fear-greed/crypto?count=30" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:fear-greed/crypto?count=30", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:fear-greed/crypto?count=30",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "2026-08-02",
  "count": 14,
  "items": [
    {
      "date": "2026-08-02",
      "score": 27,
      "rating": "Fear",
      "timestamp": 1785628800
    },
    {
      "date": "2026-08-01",
      "score": 27,
      "rating": "Fear",
      "timestamp": 1785542400
    },
    {
      "date": "2026-07-31",
      "score": 25,
      "rating": "Extreme Fear",
      "timestamp": 1785456000
    },
    {
      "date": "2026-07-30",
      "score": 28,
      "rating": "Fear",
      "timestamp": 1785369600
    },
    {
      "date": "2026-07-29",
      "score": 29,
      "rating": "Fear",
      "timestamp": 1785283200
    },
    {
      "date": "2026-07-28",
      "score": 29,
      "rating": "Fear",
      "timestamp": 1785196800
    },
    {
      "date": "2026-07-27",
      "score": 30,
      "rating": "Fear",
      "timestamp": 1785110400
    },
    {
      "date": "2026-07-26",
      "score": 26,
      "rating": "Fear",
      "timestamp": 1785024000
    }
  ],
  "score": 27,
  "market": "crypto",
  "rating": "Fear",
  "nextUpdateIn": 79557
}
```

---

### Stock sentiment

US equity sentiment plus its seven sub-indicators.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:fear-greed/stocks`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `count` | number | query | no | Days of history. Default 30, max 365 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:fear-greed/stocks?count=30" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:fear-greed/stocks?count=30", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:fear-greed/stocks?count=30",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "asOf": "2026-07-31T23:59:52+00:00",
  "count": 14,
  "items": [
    {
      "date": "2026-07-31",
      "score": 42.46,
      "rating": "fear"
    },
    {
      "date": "2026-07-30",
      "score": 40.71,
      "rating": "fear"
    },
    {
      "date": "2026-07-29",
      "score": 34.66,
      "rating": "fear"
    },
    {
      "date": "2026-07-28",
      "score": 37.89,
      "rating": "fear"
    },
    {
      "date": "2026-07-27",
      "score": 37.63,
      "rating": "fear"
    },
    {
      "date": "2026-07-24",
      "score": 41.34,
      "rating": "fear"
    },
    {
      "date": "2026-07-23",
      "score": 38.91,
      "rating": "fear"
    },
    {
      "date": "2026-07-22",
      "score": 43.31,
      "rating": "fear"
    }
  ],
  "score": 42.46,
  "market": "stocks",
  "rating": "fear",
  "weekAgo": 41.34,
  "yearAgo": 63.71,
  "monthAgo": 29.97,
  "indicators": {
    "junkBondDemand": {
      "score": 75.2,
      "rating": "extreme greed"
    },
    "marketMomentum": {
      "score": 35,
      "rating": "fear"
    },
    "putCallOptions": {
      "score": 34,
      "rating": "fear"
    },
    "safeHavenDemand": {
      "score": 50.4,
      "rating": "neutral"
    },
    "marketVolatility": {
      "score": 50,
      "rating": "neutral"
    },
    "stockPriceBreadth": {
      "score": 22.6,
      "rating": "extreme fear"
    },
    "stockPriceStrength": {
      "score": 29.8,
      "rating": "fear"
    }
  },
  "previousClose": 38.91
}
```

---


_Generated: 2026-08-02T14:27:40.676Z_