# three.ws Market Mood Index

> three.ws Market Mood Index is a paid API for AI agents from three.ws, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Returns a real-time crypto market sentiment score combining fear/greed index, news sentiment, and volatility data into a single mood reading with labeled drivers.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-mood?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-market-mood-index-52d883ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZDSn6hV82LTvHP7SxPkNq

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 three-ws-market-mood-index-52d883ba
```

Example prompt: What's the current crypto market mood right now — is it fear or greed, and what are the main bullish and bearish news drivers behind it?

## When to prefer this

Choose this endpoint when you need a single composite crypto market sentiment reading that combines fear/greed index, news sentiment scoring, and volatility into one unified mood score with labeled drivers. Prefer this over raw fear/greed APIs when you also want bullish/bearish news headlines and a divergence signal between components in one call. Best for agents building market briefings, pre-trade context checks, or sentiment-aware portfolio logic.

## Known failure modes

- Payment not provided or insufficient — endpoint requires $0.002 USDC per call via x402 protocol
- External data source unavailable — upstream fear/greed or news data may be stale or missing
- Rate limiting — excessive polling may result in request throttling
- Malformed response if underlying IBM watsonx scoring pipeline is temporarily unavailable

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a numeric mood score (0-100), a label (e.g. 'Greed' or 'Fear'), a timestamp, bullish and bearish headline drivers with links and sources, a breakdown of news sentiment (positive/neutral/negative article counts and scores), the fear/greed index value and 24h change, BTC and ETH volatility values with 24h changes, and a divergence field indicating whether components are aligned or divergent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-11T10:00:00Z",
  "mood": 62,
  "label": "Greed",
  "drivers": {
   "bearish": [
    {
     "link": "https://example.com/b",
     "title": "Example bearish headline",
     "source": "Example Source"
    }
   ],
   "bullish": [
    {
     "link": "https://example.com/a",
     "title": "Example bullish headline",
     "source": "Example Source"
    }
   ]
  },
  "components": {
   "news": {
    "label": "positive",
    "score": 0.18,
    "neutral": 57,
    "negative": 22,
    "positive": 41,
    "articles_scored": 120
   },
   "fear_greed": {
    "label": "Greed",
    "value": 66,
    "change_24h": 3
   },
   "volatility": {
    "btc": {
     "value": 36.2,
     "change_24h": -0.4
    },
    "eth": {
     "value": 58.9,
     "change_24h": 1.1
    },
    "index": "DVOL"
   }
  },
  "divergence": "aligned"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-market-mood-index-52d883ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)