# Vedetta Crypto Sentiment API (x402)

> Vedetta Crypto Sentiment API (x402) is a paid API for AI agents from vedetta.dethboy.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns crowd sentiment score, stance, narrative, and divergence flag for a given crypto asset, paid per-call in USDC via x402.

## Facts

- Endpoint: POST https://vedetta.dethboy.com/v1/sentiment
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vedetta-crypto-sentiment-api-x402-55b7a204
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5rm9zhT7Y2biRnBnYDhEz

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 vedetta-crypto-sentiment-api-x402-55b7a204 -d '<json body>'
```

Example prompt: What's the current crowd sentiment on BTC — is the market bullish or bearish, and is there any divergence flagged between sentiment and price right now?

## When to prefer this

Choose this endpoint when you need a fast, single-asset crowd sentiment snapshot with a structured verdict (stance + divergence flag) and don't want to maintain an API key or subscription. Ideal for AI agents that need to pay per-call in USDC on Base via x402. Prefer over manual social scraping or subscription sentiment APIs when cost-per-call economics and crypto-native payment rails matter. Best for real-time trading decisions, newsletter generation, or agent pipelines that need a quick bullish/bearish read with a narrative.

## Known failure modes

- HTTP 402 if payment not provided or insufficient USDC — agent must attach x402 payment header
- Unknown or unsupported ticker symbol may return null stance and narrative with stale=true
- Stale signal if underlying data hasn't refreshed recently (signal_age_minutes will be high, stale=true)
- Network timeout or upstream data provider outage resulting in 5xx error
- Malformed asset query param (missing or empty) triggers 400 bad request

## How this service works

Cheapest entry point: the latest cached analyst signal for one asset — sentiment %, stance, divergence flag, narrative — with an age timestamp (?asset=BTC). Cached-only, no freshness guarantee: for a guaranteed-fresh read use /v1/consensus. Descriptive research, not financial advice.

## Output

A JSON object containing: asset ticker, sentiment_pct (0–100 crowd sentiment), stance string (e.g. 'bullish'), narrative text summary, social_score and prediction_odds_pct under receipts, a divergence_flagged boolean, signal_age_minutes, and a stale flag indicating data freshness.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vedetta-crypto-sentiment-api-x402-55b7a204/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vedetta.dethboy.com](https://www.zero.xyz/host/vedetta.dethboy.com/llms.txt)