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

# Predictions

## Meta-model Historical

The endpoint `GET /v2/prediction/metamodel/historical` returns the 10,000 paths of the variance-based weighted meta-model (not based on the meta-leaderboard but on miner contributions, cf <https://github.com/synthdataco/synth-subnet/blob/main/research/synth_metamodel_paper.pdf>)

### Usage

The main usage is to backtest strategies.

1. Fetch the prompts `GET /validation/prompts` : it returns the start time of the prediction one which we can perform a backtest
2. Fetch the historical meta-model `GET /v2/prediction/metamodel/historical`&#x20;

### Endpoint definition

`GET /validation/prompts`

| Parameter        | Type   | Description                                                                                                    |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| `time_increment` | int    | The increment of time between prompts in seconds (e.g., 300 for 24h horizon and 60 for 1h horizon).            |
| `time_length`    | int    | The time length of the predictions in seconds (e.g., 86400 for the 24h horizon and 3600 for the 1h horizon).   |
| `asset`          | string | The asset for which the data is being requested (BTC, ETH, SOL, HYPE, XRP, XAU, SPY, NVDA, GOOGL, TSLA, AAPL). |
| `from`           | string | The start date for the data in ISO format (e.g., 2026-03-02).                                                  |
| `to`             | string | The end date for the data in ISO format (e.g., 2026-03-31).                                                    |

`GET /v2/prediction/metamodel/historical`

| Parameter    | Type   | Description                                                                                              |
| ------------ | ------ | -------------------------------------------------------------------------------------------------------- |
| asset        | string | The asset identifier, such as XAU for gold.                                                              |
| prompt\_name | string | The name of the prompt frequency to use, such as 'low' for the 24h horizon and 'high" for the 1h horizon |
| start\_time  | string | The starting time for the prediction in ISO format (e.g., 2026-04-10).                                   |

## Prediction Historical

Returns historical predictions for backtesting.

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

### Parameters

| Parameter       | Type   | Description                                             |
| --------------- | ------ | ------------------------------------------------------- |
| asset           | string | The asset identifier.                                   |
| miner           | int    | The ID of the miner.                                    |
| start\_time     | string | The starting time in ISO format (e.g., 2026-03-09).     |
| time\_increment | int    | The time increment in seconds (e.g., 60).               |
| time\_length    | int    | The duration of the prediction in seconds (e.g., 3600). |

Example: `curl -L 'https://api.synthdata.co/v2/prediction/historical?asset=BTC&miner=198&miner=200&miner=39&start_time=2026-03-09&time_increment=60&time_length=3600' -H 'Authorization: Apikey ...'`

### Usage

Typical usage is to fetch the historical meta-leaderboard and then the historical predictions of the top miners.

`curl -L 'https://api.synthdata.co/v2/meta-leaderboard/historical?start_time=2026-01-09T00%3A00%3A00Z&prompt_name=high'`