# Carbon & Cashmere Token Risk Score API

> Carbon & Cashmere Token Risk Score API is a paid API for AI agents from api.carbon-cashmere.de, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-08).

Returns an AI-generated risk score, risk tier, and rationale for a given on-chain token address, including authority status and holder concentration metrics.

## Facts

- Endpoint: GET https://api.carbon-cashmere.de/v1/ai/risk-score/%7Baddress%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/carbon-cashmere-token-risk-score-api-c4e42d87
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4sIk7NNnnXlUFPlhFcKXu

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-token-risk-score-api-c4e42d87
```

Example prompt: Can you pull the Carbon & Cashmere risk score for the Solana token at address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — I want to know the risk tier, score, and whether the mint and freeze authorities are still active?

## When to prefer this

Use this endpoint when you need a quick, AI-backed holistic risk classification (not just raw on-chain data) for a specific token address, especially on Solana. It is ideal when you need holder concentration data, authority status, and a human-readable rationale bundled into one call, rather than piecing together multiple raw data sources yourself.

## Known failure modes

- Invalid or malformed token address returns a 4xx error
- Address not found on supported chains returns a not-found error
- Network timeout or upstream data unavailability returns a 5xx error
- Payment not included or insufficient USDC returns a 402 Payment Required error
- Unsupported blockchain address format returns a validation error

## How this service works

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

## Output

Returns a JSON object with: risk_score (0–100 integer), risk_tier (e.g. 'low'), a plain-English AI rationale, chain, token_type, supply, decimals, mint_authority_active (bool), freeze_authority_active (bool), top1_holder_pct, and top10_holders_pct for the queried address.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "solana",
  "model": "claude-haiku-4-5",
  "supply": 6843219712.34,
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "decimals": 6,
  "rationale": "Mint and freeze authorities both renounced. Holder concentration is healthy (top-1 4.2%, top-10 18.5%). Behaves like a well-distributed stablecoin.",
  "risk_tier": "low",
  "risk_score": 12,
  "token_type": "spl-mint",
  "top1_holder_pct": 4.2,
  "top10_holders_pct": 18.5,
  "mint_authority_active": false,
  "freeze_authority_active": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/carbon-cashmere-token-risk-score-api-c4e42d87/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)
