> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cryptoquant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyst Consensus Index

> Daily net bullish-vs-bearish balance of tracked crypto analysts, served through the Alpha Indicator API for CryptoQuant Premium plan users.

The Analyst Consensus Index is the daily net sentiment of tracked crypto analysts — one vote per
analyst (their latest post), aggregated to a single reading from **−100 (all bearish)** to
**+100 (all bullish)**. It is the sentiment row on the
[alpha.cryptoquant.com](https://alpha.cryptoquant.com) Bitcoin heatmap.

The series is available to **CryptoQuant Premium plan** users through the Alpha Indicator API,
with the same API key used for the core Data API.

## Base endpoint

```text theme={null}
https://alpha.cryptoquant.com/api/consensus
```

## Assets

| Asset    | `{asset}` | Accepted aliases |
| -------- | --------- | ---------------- |
| Bitcoin  | `BTC`     | `bitcoin`        |
| Ethereum | `ETH`     | `ethereum`       |
| Solana   | `SOL`     | `solana`         |

## Endpoints

### Catalog (public)

Asset list, metric metadata, field definitions, and query parameters — no values, no key needed.

```bash theme={null}
curl -X GET "https://alpha.cryptoquant.com/api/consensus"
```

### Daily series (Premium)

```bash theme={null}
curl -X GET "https://alpha.cryptoquant.com/api/consensus/BTC?limit=30&order=desc" \
-H "Authorization: Bearer <YOUR_API_KEY>"
```

## Query parameters

| Parameter | Type            | Description                                                     |
| --------- | --------------- | --------------------------------------------------------------- |
| `from`    | `YYYY-MM-DD`    | Return points on or after this UTC day                          |
| `to`      | `YYYY-MM-DD`    | Return points on or before this UTC day                         |
| `limit`   | integer         | Maximum number of rows, clamped to `1..10000` (default `10000`) |
| `order`   | `asc` or `desc` | Sort order. Defaults to `asc`                                   |

<Note>
  The index is end-of-day. The current UTC day is still accumulating votes and is excluded — the
  latest point is the previous UTC day. History starts 2021-06-01.
</Note>

## Response shape

```json theme={null}
{
  "status": { "code": 200, "message": "success" },
  "result": {
    "asset": {
      "id": "BTC",
      "name": "Bitcoin",
      "slug": "bitcoin",
      "aliases": ["BTC", "bitcoin"],
      "assetClass": "crypto"
    },
    "metric": {
      "id": "analyst-consensus-index",
      "name": "Analyst Consensus Index",
      "meaning": "Crypto analysts' bullish vs. bearish balance",
      "category": "sentiment",
      "direction": "sell_high",
      "source": "unbias",
      "frequency": "daily",
      "range": { "min": -100, "max": 100 },
      "experimental": true
    },
    "data": [
      {
        "datetime": "2026-09-09",
        "value": 32.89,
        "value_30d_ma": 35.72,
        "bullish_analysts": 80,
        "bearish_analysts": 32,
        "total_analysts": 112
      }
    ]
  }
}
```

## Fields

| Field              | Meaning                                                                         |
| ------------------ | ------------------------------------------------------------------------------- |
| `datetime`         | UTC day (`YYYY-MM-DD`)                                                          |
| `value`            | Analyst Consensus Index: `(bullish − bearish) ÷ total × 100`, from −100 to +100 |
| `value_30d_ma`     | 30-day moving average of `value` (`null` while the window is filling)           |
| `bullish_analysts` | Analysts counted bullish that day                                               |
| `bearish_analysts` | Analysts counted bearish that day                                               |
| `total_analysts`   | Analysts with a directional view that day (bullish + bearish)                   |

`metric.source: "unbias"` records provenance — the index is produced by the unbias.fyi
analyst-tracking pipeline. Access is through your CryptoQuant API key; no separate key or billing.

## How to read it

Read contrarian: crowded bullishness (high positive readings) marks top risk, while capitulation
in sentiment (deeply negative readings) has marked opportunity. On the heatmap the row is colored
`sell_high` — high = red, low = green.

## Errors

Requests without a key return `401 authentication required`; keys below the Premium plan return
`403 premium_plan_required`; an unsupported `{asset}` returns `404 unknown asset`. See
[Errors](/indicator-api/errors) for the envelopes.