For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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.

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'

Last updated