# Forest Crypto Fear & Greed Index

> Forest Crypto Fear & Greed Index is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Returns the current and historical Crypto Fear & Greed Index score from Alternative.me, scoped to a requested number of days

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/crypto/fear-greed?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-crypto-fear-greed-index-88365137
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PbPeaKY9nOuh-Z9Oyo2Kn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-crypto-fear-greed-index-88365137 -d '<json body>'
```

Example prompt: What's the current crypto fear and greed index, and show me how it's trended over the last 14 days?

## When to prefer this

Use this endpoint when you need a real-time or recent-historical sentiment signal specifically tied to the Alternative.me Crypto Fear & Greed Index for Bitcoin/crypto markets. Prefer it over raw price feeds when you want a normalized 0–100 sentiment score with classification labels and a trading signal flag. It is especially useful for agents automating daily market mood reports, enriching trade decision logic, or populating dashboards with sentiment context. It is a paid micro-transaction endpoint ($0.001 USDC) that returns structured, cached data — appropriate for high-frequency polling only if cache_age_ms is monitored.

## Known failure modes

- days parameter out of range (must be 1–30) — likely 400 Bad Request
- Unsigned or unpaid request returns HTTP 402 with x402 PAYMENT-REQUIRED challenge
- Upstream Alternative.me data unavailable — possible 503 or degraded response
- Stale cache served when upstream is slow — cache_age_ms will be elevated
- Invalid JSON body or missing Content-Type — likely 400 parse error

## How this service works

Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.

## Output

A JSON object containing the current fear/greed score (0–100), its classification (e.g. 'Extreme Fear', 'Greed'), the observation timestamp, and an array of historical daily entries for the requested number of days. Also includes a trading_signal boolean, asset scope (bitcoin), cache metadata (hit/miss, age in ms), provider attribution (Alternative.me), and request/response diagnostics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "maximum": 30,
   "minimum": 1,
   "description": "Public days value used to scope this lookup."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "index": "bitcoin_crypto_fear_greed",
   "source": "Alternative.me Crypto Fear & Greed Index",
   "current": {
    "score": 0,
    "observed_at": "example",
    "classification": "example"
   },
   "history": [
    {
     "score": 0,
     "observed_at": "example",
     "classification": "example"
    }
   ],
   "source_url": "https://alternative.me/crypto/fear-and-greed-index/",
   "asset_scope": "bitcoin",
   "attribution": "Data from Alternative.me",
   "source_kind": "daily_sentiment_index",
   "cache_age_ms": 0,
   "returned_days": 1,
   "requested_days": 1,
   "trading_signal": false
  },
  "meta": {
   "cache": "miss",
   "provider": "alternative-me-fear-greed",
   "checked_at": "2026-01-01T00:00:00.000Z",
   "duration_ms": 0
  },
  "version": "1",
  "capability": "crypto.fear-greed"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-crypto-fear-greed-index-88365137/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)
