> 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/signal.md).

# Public Signal

The public signal endpoint returns market context and the latest BV-7X signal. The prediction direction is gated behind token verification.

***

## Endpoint

```
GET /api/bv7x/openclaw/signal
```

**Authentication**: None required (public endpoint)

***

## Response

```json
{
  "signal": "GATED",
  "confidence": null,
  "btcPrice": 66027,
  "fearGreed": 45,
  "fearGreedLabel": "Fear",
  "etfFlows7d": -120000000,
  "regime": "BEAR_TREND",
  "modelVersion": "5.6.7",
  "timestamp": "2026-03-28T21:35:00Z",
  "horizon": "7d"
}
```

***

## Response Fields

| Field            | Type           | Description                                                                 |
| ---------------- | -------------- | --------------------------------------------------------------------------- |
| `signal`         | string         | `GATED` for public access. Authenticated users see `BUY`, `SELL`, or `HOLD` |
| `confidence`     | number or null | Confidence score (0.50--0.99). Null when gated                              |
| `btcPrice`       | number         | BTC/USD price at signal time                                                |
| `fearGreed`      | number         | Crypto Fear & Greed index (0--100)                                          |
| `fearGreedLabel` | string         | Human label: Extreme Fear, Fear, Neutral, Greed, Extreme Greed              |
| `etfFlows7d`     | number         | Net BTC ETF inflows over 7 days (USD)                                       |
| `regime`         | string         | Current market regime classification                                        |
| `modelVersion`   | string         | Signal model version                                                        |
| `timestamp`      | string         | ISO 8601 timestamp of signal computation                                    |
| `horizon`        | string         | Prediction horizon (default `7d`)                                           |

***

## The GATED Field

When accessed without authentication, the `signal` field returns `"GATED"` and `confidence` is `null`. This protects the prediction direction, which is the core value of the oracle.

To unlock the full signal (direction + confidence), verify your wallet with 500M+ $BV7X. See [Token Verification](/use-the-signal/read-the-forecast/token-verification.md).

The market context fields (BTC price, Fear & Greed, ETF flows, regime) are always returned regardless of authentication.

***

## Example

```bash
curl https://bv7x.ai/api/bv7x/openclaw/signal
```

***

## Rate Limits

This endpoint is rate-limited to prevent abuse. Typical usage (polling every few minutes) will not hit limits.

***

## Next

* [Oracle API](/use-the-signal/read-the-forecast/oracle.md) -- full signal with authentication
* [Token Verification](/use-the-signal/read-the-forecast/token-verification.md) -- how to unlock the direction