> For the complete documentation index, see [llms.txt](https://docs.synthdata.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.synthdata.co/endpoints-overview-1/predictions-historical.md).

# Predictions Historical

```
GET /v2/prediction/historical
```

## Parameters

| Parameter        | Type        | Required | Description                                                   |
| ---------------- | ----------- | -------- | ------------------------------------------------------------- |
| `miner`          | array\[int] | Yes      | Miner UIDs to fetch (use repeated params: `miner=2&miner=82`) |
| `asset`          | string      | Yes      | `BTC`, `ETH`, `SOL`, `XAU`, `SPYX`, `NVDAX`                   |
| `start_time`     | string      | Yes      | ISO 8601 datetime (e.g., `2025-01-15T00:00:00Z`)              |
| `time_increment` | integer     | Yes      | `300` (5min intervals)                                        |
| `time_length`    | integer     | Yes      | `86400` (24h forecast)                                        |

## Request Example

```bash
curl "https://api.synthdata.co/v2/prediction/historical?miner=2&asset=BTC&start_time=2025-01-15T00:00:00Z&time_increment=300&time_length=86400" \
  -H "Authorization: Apikey YOUR_API_KEY"
```

## Response (example)

{% code title="response.json" %}

```json
[
  {
    "miner_uid": 2,
    "start_time": 1736899200,
    "predictions": [
      [97234.56, 97456.78, 97389.12, ..., 98123.45],
      [97234.56, 97567.89, 97612.34, ..., 96789.01],
      ...
    ]
  }
]
```

{% endcode %}

| Field         | Description                      |
| ------------- | -------------------------------- |
| `miner_uid`   | Miner identifier                 |
| `start_time`  | Unix timestamp of the prediction |
| `predictions` | Array of 1,000 price paths       |

## Use Cases

* Backtesting trading strategies
* Analyzing miner prediction accuracy
* Historical volatility analysis