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

# Scorecard

The scorecard endpoint returns the full prediction history with outcomes. Fully public, no authentication required.

***

## Endpoint

```
GET /api/bv7x/scorecard
```

**Authentication**: None (public)

***

## Response

```json
{
  "predictions": [
    {
      "date": "2026-03-21",
      "signal": "BUY",
      "direction": "UP",
      "confidence": 0.62,
      "outcome": "WIN",
      "btcAtSignal": 64500,
      "btcAtResolution": 67200,
      "resolvedAt": "2026-03-28"
    },
    {
      "date": "2026-03-20",
      "signal": "SELL",
      "direction": "DOWN",
      "confidence": 0.58,
      "outcome": "LOSS",
      "btcAtSignal": 65100,
      "btcAtResolution": 65800,
      "resolvedAt": "2026-03-27"
    }
  ],
  "stats": {
    "total": 142,
    "wins": 96,
    "losses": 46,
    "accuracy": 0.676,
    "currentStreak": 3,
    "longestStreak": 8
  }
}
```

***

## Fields

### Prediction Entry

| Field             | Type   | Description                               |
| ----------------- | ------ | ----------------------------------------- |
| `date`            | string | Date the prediction was made (YYYY-MM-DD) |
| `signal`          | string | `BUY`, `SELL`, or `HOLD`                  |
| `direction`       | string | `UP` or `DOWN`                            |
| `confidence`      | number | Model confidence at prediction time       |
| `outcome`         | string | `WIN`, `LOSS`, or `PENDING`               |
| `btcAtSignal`     | number | BTC/USD when prediction was made          |
| `btcAtResolution` | number | BTC/USD at resolution (null if pending)   |
| `resolvedAt`      | string | Resolution date (null if pending)         |

### Stats Summary

| Field           | Type   | Description                 |
| --------------- | ------ | --------------------------- |
| `total`         | number | Total predictions made      |
| `wins`          | number | Correct predictions         |
| `losses`        | number | Incorrect predictions       |
| `accuracy`      | number | Win rate (0.0--1.0)         |
| `currentStreak` | number | Current consecutive wins    |
| `longestStreak` | number | Best consecutive win streak |

***

## Notes

* Predictions with `outcome: "PENDING"` have not yet reached their 7-day resolution window
* HOLD signals are not scored (no directional prediction to verify)
* The scorecard includes the same data shown on the [Performance page](https://bv7x.ai/performance)

***

## Example

```bash
curl https://bv7x.ai/api/bv7x/scorecard
```

***

## Next

* [Track Record](/use-the-signal/performance/track-record.md) -- accuracy analysis
* [On-Chain Oracle](/use-the-signal/read-the-forecast/on-chain.md) -- verify predictions on-chain