> ## 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.
# Bull-Bear Market Indicator
> The bull/bear market cycle indicator is a momentum metric. It measures the difference between the P&L Index and its 365-day moving average.
## What it measures
The Bull/Bear Market Cycle Indicator is a momentum metric built on top of the [P\&L Index](/v2/community/bitcoin-pnl-index). It measures the difference between the P\&L Index and its 365-day moving average, isolating the direction and strength of the current market cycle rather than the absolute valuation level.
## How to interpret it
Because it tracks the P\&L Index relative to its own long-term trend, the indicator reads as a cycle-phase signal:
* **Above 0** — the P\&L Index is above its 365-day average, indicating bullish momentum and a bull cycle.
* **Below 0** — the P\&L Index is below its 365-day average, indicating bearish momentum and a bear cycle.
Crosses of the zero line mark transitions between cycle phases, making the indicator useful for confirming regime shifts.
## Key thresholds
* **Bull cycle:** indicator above 0.
* **Bear cycle:** indicator below 0 and below its 365-day moving average.
## OpenAPI
````yaml openapi/v2.json GET /community/bitcoin-bull-bear-indicator
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-bear-indicator:
get:
tags:
- Community-built Indicators
summary: Bull-Bear Market Indicator
description: >-
The bull/bear market cycle indicator is a momentum metric. It measures
the difference between the P&L Index and its 365-day moving average.
operationId: V2getBitcoinBullBearIndicator
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).
example: '2026-06-14 00:00:00'
bull_bear_indicator:
type: number
example: -0.69567171
type:
type: string
example: bear
security:
- AccessToken: []
x-codeSamples:
- lang: Shell
source: >-
curl -X GET
"https://api.cryptoquant.com/v2/community/bitcoin-bull-bear-indicator?window=day"
\
-H "Authorization: Bearer "
- lang: JavaScript
source: >-
fetch("https://api.cryptoquant.com/v2/community/bitcoin-bull-bear-indicator?window=day",
{ headers: { "Authorization": "Bearer "} })
.then(response => response.json())
.then(data => console.log(data))
- lang: NodeJS
source: |-
require('axios')
.get("https://api.cryptoquant.com/v2/community/bitcoin-bull-bear-indicator?window=day", { headers: { Authorization: 'Bearer ' } })
.then(response => console.log(response))
- lang: Ruby
source: >-
require 'net/http'
uri =
URI("https://api.cryptoquant.com/v2/community/bitcoin-bull-bear-indicator?window=day")
req = Net::HTTP::Get.new(uri)
req["Authorization"] = "Bearer "
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 '}
url =
"https://api.cryptoquant.com/v2/community/bitcoin-bull-bear-indicator?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
description: >-
For each API request, include the `Authorization` HTTP header with
`Bearer `.
````