> For the complete documentation index, see [llms.txt](https://docs.bv7x.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bv7x.ai/use-the-signal/read-the-forecast/regime.md).

# Market Regime

Returns the current market regime classification. Requires Basic tier authentication.

***

## Endpoint

```
GET /api/bv7x/regime
Authorization: Bearer <token>
```

**Authentication**: Basic tier (500M+ $BV7X)

***

## Response

```json
{
  "regime": "BEAR_TREND",
  "description": "Sustained downtrend with price below long-term averages",
  "riskLevel": "High",
  "timestamp": "2026-03-28T21:35:00Z",
  "factors": {
    "trendPosition": "below_ma",
    "momentum": "negative",
    "sentiment": "fear",
    "volatility": "elevated"
  }
}
```

***

## Fields

| Field         | Type   | Description                                                 |
| ------------- | ------ | ----------------------------------------------------------- |
| `regime`      | string | One of 7 regime types (see below)                           |
| `description` | string | Human-readable description                                  |
| `riskLevel`   | string | Risk classification for the current regime                  |
| `timestamp`   | string | When the regime was last evaluated                          |
| `factors`     | object | High-level factor states contributing to the classification |

***

## Regime Values

| Regime          | Risk Level |
| --------------- | ---------- |
| `CRISIS`        | Extreme    |
| `BEAR_TREND`    | High       |
| `BEAR_RECOVERY` | Elevated   |
| `CHOP`          | Moderate   |
| `BULL_TREND`    | Low        |
| `EUPHORIA`      | Elevated   |
| `DEFAULT`       | Moderate   |

See [Market Regimes](/use-the-signal/performance/regimes.md) for detailed descriptions of each regime.

***

## Error Responses

| Status | Reason                          |
| ------ | ------------------------------- |
| 401    | Missing or expired bearer token |
| 403    | Token balance below 500M $BV7X  |

***

## Example

```bash
curl https://bv7x.ai/api/bv7x/regime \
  -H "Authorization: Bearer eyJhbGci..."
```

***

## Next

* [Market Regimes](/use-the-signal/performance/regimes.md) -- how regimes affect signal thresholds
* [Oracle API](/use-the-signal/read-the-forecast/oracle.md) -- full signal response