# Carbon & Cashmere Sentiment Analyze API

> Carbon & Cashmere Sentiment Analyze API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.01/call, status down (last checked 2026-09-14).

Analyzes the sentiment impact of a news headline or event on specific cryptocurrencies, returning magnitude, impact level, sentiment direction, and sentiment score.

## Facts

- Endpoint: POST https://api.carbon-cashmere.de/v1/sentiment-analyze
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/carbon-cashmere-sentiment-analyze-api-601194af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WrB7k6jKLrct9-O6hsZY3

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 carbon-cashmere-sentiment-analyze-api-601194af -d '<json body>'
```

Example prompt: What's the market impact of this headline for Bitcoin and Ethereum — 'SEC approves first Bitcoin ETF for US markets' — is it high impact and positive, and what's the magnitude? Use the Carbon & Cashmere sentiment analyzer with categories 'etf' and 'regulation'.

## When to prefer this

Use this endpoint when you need to quantify the directional sentiment impact of a specific news headline or event on one or more named cryptocurrencies — especially when you need a structured impact_level and magnitude score rather than raw text sentiment. Prefer this over generic NLP sentiment APIs when the domain is crypto markets and you need trading-signal-grade output including impact classification.

## Known failure modes

- Missing or empty 'coins' array returns validation error
- Empty or null 'title' field returns 400 bad request
- Invalid category strings may return unrecognized category error
- Payment not included or insufficient USDC results in 402 payment required
- Unsupported coin ticker may return unknown asset error
- Network timeout if upstream ML model is slow

## How this service works

Professional crypto market intelligence. Real-time prices, signals, and market scoring.

## Output

Returns a JSON object with: magnitude (0-1 float indicating strength of impact), impact_level (HIGH/MEDIUM/LOW), sentiment_used (positive/negative/neutral string), and sentiment_score (numeric sentiment value). Together these characterize how strongly and in which direction the given news headline is expected to affect the specified cryptocurrencies.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "input": {
   "coins": [
    "BTC"
   ],
   "title": "Bitcoin ETF approval expected next week",
   "categories": [
    "etf",
    "regulation"
   ]
  },
  "result": {
   "magnitude": 0.95,
   "impact_level": "HIGH",
   "sentiment_used": "positive",
   "sentiment_score": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/carbon-cashmere-sentiment-analyze-api-601194af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.carbon-cashmere.de](https://www.zero.xyz/host/api.carbon-cashmere.de/llms.txt)