# SYNTHORA Crowd Sentiment Oracle

> SYNTHORA Crowd Sentiment Oracle is a paid API for AI agents from api.hergertsynthora.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time crowd sentiment (very_bullish to very_bearish), tone score, trend, trading signal, and top headlines for any topic or asset using GDELT global-news analysis

## Facts

- Endpoint: POST https://api.hergertsynthora.com/v1/sentiment
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-crowd-sentiment-oracle-337f1c67
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S8YTK8L8UyYOOeTYkATVW

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 synthora-crowd-sentiment-oracle-337f1c67 -d '<json body>'
```

Example prompt: What's the current crowd sentiment on bitcoin based on global news over the last 6 hours — is it bullish or bearish, and what's the trading signal?

## When to prefer this

Choose this endpoint when you need a fast, verifiable, news-driven sentiment signal for any asset or topic — especially for trading or market-intelligence workflows where you want a structured bullish/bearish classification with a cryptographically signed result. Prefer it over social-media sentiment tools when you need global news tone rather than Twitter/Reddit chatter, or when auditability via Ed25519 signatures matters.

## Known failure modes

- Unsupported or too-generic query term yields low-confidence or neutral results
- Timespan too short (1h) may return sparse data and unreliable signal
- Payment not included or insufficient USDC triggers 402 error
- GDELT data lag may affect freshness at the very short end of the timespan range
- Invalid timespan enum value returns validation error

## How this service works

Real-time crowd sentiment oracle for any topic or asset: GDELT global-news tone timeline -> sentiment (very_bullish..very_bearish), tone score, trend and trading signal, with top headlines. POST {"query":"bitcoin","timespan":"6h"}. Deterministic, Ed25519-signed. SYNTHORA.

## Output

Returns a sentiment classification label (e.g. very_bullish, bearish), a numeric tone score, a trend direction indicator, a trading signal, and a list of top news headlines that contributed to the analysis — all cryptographically signed with Ed25519 for verifiability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Topic or asset, e.g. bitcoin"
  },
  "timespan": {
   "enum": [
    "1h",
    "6h",
    "12h",
    "24h",
    "48h",
    "72h"
   ],
   "type": "string",
   "default": "6h"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-crowd-sentiment-oracle-337f1c67/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hergertsynthora.com](https://www.zero.xyz/host/api.hergertsynthora.com/llms.txt)