# Crypto Sentiment API – GET /sentiment/{symbol}

> Crypto Sentiment API – GET /sentiment/{symbol} is a paid API for AI agents from crypto-sentiment-x402.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns real-time news sentiment for a single crypto coin, scored from headlines across 9 outlets, with per-headline scores, weights, effects, and an overall bullish/bearish label.

## Facts

- Endpoint: GET https://crypto-sentiment-x402.onrender.com/sentiment/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-sentiment-api-get-sentiment-symbol-88f16201
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ptGMpwn3QaL-tAudcsHzv

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 crypto-sentiment-api-get-sentiment-symbol-88f16201
```

Example prompt: What's the current news sentiment for Bitcoin — is it bullish or bearish right now, and what are the main headlines driving it?

## When to prefer this

Choose this endpoint when you need a real-time, headline-backed sentiment reading for a specific crypto asset scored across multiple reputable news outlets. It is ideal for pre-trade checks, dashboard widgets, or alerting workflows where you need both a quantitative signal and the underlying evidence (headlines with scores and weights). Prefer it over generic social sentiment tools when editorial crypto news coverage is more relevant than social media chatter, and when you need per-source credibility weighting built in.

## Known failure modes

- Unsupported coin symbol returns an error and no charge is applied
- Coin with insufficient recent news returns an error and no charge
- Invalid or malformed ticker symbol returns a 4xx error
- Service unavailable on Render cold start — brief latency spike or 503 on first request
- Request charged only on successful response; failures are free

## How this service works

Crypto news sentiment for 24 coins, scored from headlines at 9 crypto news outlets plus the Fear & Greed Index, with the headlines behind each score. Paid per call over x402 in USDC on Base: $0.01 for GET /sentiment/{symbol} and $0.05 for GET /history/{symbol}. Requests for an unsupported coin, a coin with too little recent news, or a history range with no readings are refused and not charged.

## Output

A JSON object containing the coin name and symbol, an array of top driver headlines (each with title, source, publication time, sentiment score, source weight, and effect on overall score), a plain-English drivers summary, and an overall_sentiment object with a bullish/bearish/neutral label, 72-hour window average compound score, effective sample size, unweighted compound score, and age of newest headline.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Bitcoin",
  "symbol": "BTC",
  "drivers": [
   {
    "link": "https://example.com/news/bitcoin-etf-inflows",
    "score": 0.6249,
    "title": "Bitcoin ETFs log fifth straight day of inflows",
    "effect": 0.0263,
    "source": "CoinDesk",
    "weight": 0.9288,
    "published": "2026-10-03T14:05:00Z"
   },
   {
    "link": "https://example.com/news/exchange-hack",
    "score": -0.5719,
    "title": "Exchange hack drains $40M as bitcoin dips",
    "effect": -0.0222,
    "source": "The Block",
    "weight": 0.8572,
    "published": "2026-10-03T12:40:00Z"
   },
   {
    "link": "https://example.com/news/record-hashrate",
    "score": 0.4404,
    "title": "Bitcoin miners report record hashrate",
    "effect": 0.0161,
    "source": "Decrypt",
    "weight": 0.8087,
    "published": "2026-10-03T11:15:00Z"
   }
  ],
  "drivers_summary": "2 of the top 3 headlines are positive, 1 is negative.",
  "overall_sentiment": {
   "label": "bullish",
   "window": "72h-hl24",
   "sample_size": 38,
   "average_compound": 0.21,
   "effective_sample_size": 29.4,
   "unweighted_compound_72h": 0.17,
   "newest_headline_age_hours": 1.6
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-sentiment-api-get-sentiment-symbol-88f16201/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto-sentiment-x402.onrender.com](https://www.zero.xyz/host/crypto-sentiment-x402.onrender.com/llms.txt)