# CryptoFeed402 BTC Sentiment

> CryptoFeed402 BTC Sentiment is a paid API for AI agents from cryptofeed402.site, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-21).

Returns LLM-scored news-headline sentiment (bullish/bearish/neutral) for Bitcoin, derived from recent headlines analyzed by a local language model.

## Facts

- Endpoint: GET https://cryptofeed402.site/sentiment/BTC?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptofeed402-btc-sentiment-19c37f51
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UcxO0J4V4R7DhxaPiffht

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 cryptofeed402-btc-sentiment-19c37f51
```

Example prompt: What's the current news-headline sentiment for Bitcoin right now — is it bullish, bearish, or neutral, and how strong is the signal?

## When to prefer this

Choose this endpoint when you need a fast, cheap, LLM-derived sentiment signal specifically for Bitcoin based on recent news headlines, and you are operating in an AI-agent context that supports x402 micropayments on Base. It is ideal for trading bots, market monitors, or briefing agents that need a structured bullish/bearish/neutral label with supporting headline evidence at sub-cent cost per call. Prefer alternatives if you need real-time price data, on-chain metrics, or sentiment derived from social media rather than news headlines.

## Known failure modes

- 402 Payment Required — call returned without valid x402 USDC payment on Base mainnet
- Invalid symbol in path — unsupported ticker may return 404 or error
- Stale data — age_seconds may be high if headline ingestion is delayed
- Empty headline window — low n_headlines if no recent news available for the symbol
- Network timeout — service may be slow during high load

## How this service works

AI-to-AI crypto data. Paid routes use x402 (USDC on Base mainnet eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); unpaid calls return 402 with payment requirements. Not financial advice.

## Output

Returns a JSON object with: a sentiment label (bullish/bearish/neutral), a numeric score, headline counts broken down by positive/negative/neutral/total, the LLM model used, the method description, top headlines with their individual stances and URLs, data age in seconds, generation timestamp, and a disclaimer. The window covers the last 360 minutes of headlines.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "label": "bullish",
  "model": "qwen2.5:14b",
  "score": 0.25,
  "counts": {
   "neg": 5,
   "neu": 8,
   "pos": 11,
   "n_headlines": 24
  },
  "method": "Each headline labeled pos/neg/neu by a local LLM; score is computed arithmetically from the labels.",
  "symbol": "BTC",
  "disclaimer": "News-headline sentiment, not a price prediction. Automated data for AI agents. Not financial advice.",
  "age_seconds": 410,
  "generated_at": "2026-10-20T00:30:00.000Z",
  "top_headlines": [
   {
    "url": "https://example.com/story",
    "title": "Example headline about Bitcoin ETF inflows",
    "source": "example-news",
    "stance": "pos"
   }
  ],
  "window_minutes": 360
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptofeed402-btc-sentiment-19c37f51/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cryptofeed402.site](https://www.zero.xyz/host/cryptofeed402.site/llms.txt)