> ## 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.

# Bitcoin Bull Score Index

> The Bull Score Index for Bitcoin. Index values are between 0 (most bearish) and 100 (most bullish).

## What it measures

Composite index (0–100) aggregating 10 binary on-chain and market metrics (network activity, investor profitability, demand, liquidity, momentum) — each scored 1 (bullish) or 0 (bearish)

## How to interpret it

The primary market regime classifier. Determines how all other metrics should be interpreted — especially whether the Trader Realized Price acts as support or resistance.

## Key thresholds

80–100 = "Extra Bullish" (seen at $126K ATH Oct 2025); 60–80 = Bull market; 50 = Neutral; sustained below 40 = Bear market; 20 = Deep bear (Jan 2023 bottom, Mar 2025, Nov 2025); 0 = Maximum bearish (Feb 2026 at $75K)

## How to use it

The regime classifier for all other metrics. Bitcoin only sustains major rallies when score ≥ 60. Trader Realized Price = support when ≥ 60, resistance when ≤ 40. Recovery above 40 with positive apparent demand and recovering ETF flows = bull market re-entry signal.

<Card title="Run this metric in CryptoQuant Analytics" icon="chart-line" href="https://cryptoquant.com/analytics/query/67dada27f3ae1b2f63a97872" />


## OpenAPI

````yaml openapi/v2.json GET /community/bitcoin-bull-score
openapi: 3.0.0
info:
  version: 2.0.0-beta
  title: CryptoQuant Data API v2
  description: >-
    The CryptoQuant Data API v2 serves curated, research-grade indicators built
    on the v1 conventions — the `status`/`result` response envelope, Bearer
    token authentication, and the `window`/`from`/`to` time parameters. Each
    metric ships with an interpretation guide covering what it measures, key
    thresholds, and how to combine it with other metrics.
  termsOfService: https://cryptoquant.com/terms-of-service
  contact:
    name: API Support
    email: contact@cryptoquant.com
servers:
  - url: https://api.cryptoquant.com/v2
    description: Default server
security: []
tags:
  - name: Community-built Indicators
paths:
  /community/bitcoin-bull-score:
    get:
      tags:
        - Community-built Indicators
      summary: Bitcoin Bull Score Index
      description: >-
        The Bull Score Index for Bitcoin. Index values are between 0 (most
        bearish) and 100 (most bullish).
      operationId: V2getBitcoinBullScore
      parameters:
        - name: window
          in: query
          required: false
          description: Time interval for aggregation.
          schema:
            type: string
            default: day
          example: day
        - name: from
          in: query
          required: false
          description: >-
            Starting time, formatted as YYYYMMDDTHHMMSS (UTC). If `window=day`,
            YYYYMMDD is also accepted.
          schema:
            type: string
        - name: to
          in: query
          required: false
          description: >-
            Ending time, formatted as YYYYMMDDTHHMMSS (UTC). If `window=day`,
            YYYYMMDD is also accepted.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Maximum number of data rows to return. Ranges from 1 to 10,000.
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 10000
      responses:
        '200':
          description: market regime
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - result
                properties:
                  status:
                    $ref: '#/components/schemas/Status'
                  result:
                    type: object
                    properties:
                      window:
                        type: string
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            datetime:
                              type: string
                              description: >-
                                The datetime, formatted as YYYY-MM-DD HH:MM:SS
                                (UTC).
                            bull_score_pct:
                              type: number
                              example: 62.5
      security:
        - AccessToken: []
      x-codeSamples:
        - lang: Shell
          source: >-
            curl -X GET
            "https://api.cryptoquant.com/v2/community/bitcoin-bull-score?window=day"
            \

            -H "Authorization: Bearer <YOUR_API_KEY>"
        - lang: JavaScript
          source: >-
            fetch("https://api.cryptoquant.com/v2/community/bitcoin-bull-score?window=day",
            { headers: { "Authorization": "Bearer <YOUR_API_KEY>"} })
              .then(response => response.json())
              .then(data => console.log(data))
        - lang: NodeJS
          source: |-
            require('axios')
              .get("https://api.cryptoquant.com/v2/community/bitcoin-bull-score?window=day", { headers: { Authorization: 'Bearer <YOUR_API_KEY>' } })
              .then(response => console.log(response))
        - lang: Ruby
          source: >-
            require 'net/http'

            uri =
            URI("https://api.cryptoquant.com/v2/community/bitcoin-bull-score?window=day")

            req = Net::HTTP::Get.new(uri)

            req["Authorization"] = "Bearer <YOUR_API_KEY>"

            res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) {
            |http| http.request(req) }

            puts res.body
        - lang: Python
          source: >-
            import requests

            headers = {'Authorization': 'Bearer <YOUR_API_KEY>'}

            url =
            "https://api.cryptoquant.com/v2/community/bitcoin-bull-score?window=day"

            print(requests.get(url, headers=headers).json())
components:
  schemas:
    Status:
      type: object
      description: >-
        Returned with every response; indicates whether the request was
        successful.
      example:
        code: 200
        message: success
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
          description: HTTP status code.
          example: 200
        message:
          type: string
          description: Text description of the error or success.
          example: success
  securitySchemes:
    AccessToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      x-default: Bearer <YOUR_API_KEY>
      description: >-
        For each API request, include the `Authorization` HTTP header with
        `Bearer <YOUR_API_KEY>`.

````