logo
API docs by Redocly

Synth (1.0)

URL: https://synthdata.co

Synth API offers programmatic access to probabilistic price forecasts for Equities, Commodities and Cryptocurrencies.

Miners - Registrations

Gets the miners that took a uid between two dates: one row per (uid, hotkey), at the time the validator first saw that hotkey on that uid

query Parameters
from
required
string
Example: from=2025-02-03T10:19:04Z

Start date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

to
required
string
Example: to=2025-02-10

End date, inclusive UTC day, at most 30 days after from (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Rewards - Scores

Per-miner smoothed scores and reward weights over a date range (max 7 days).

query Parameters
from
required
string
Example: from=2026-06-01

start date (ISO 8601)

to
required
string
Example: to=2026-06-07

end date (ISO 8601)

miner_uid
integer

filter to a single miner UID

competition
string
Example: competition=crypto-24h

competition filter: crypto-1h, crypto-24h, or com-equ-24h (default: all competitions)

prompt_name
string
Example: prompt_name=low

DEPRECATED legacy alias for competition: low (=crypto-24h) or high (=crypto-1h); use competition

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Leaderboard - Leaderboard History V2

Gets the leaderboard history.

query Parameters
start_time
required
string
Example: start_time=2025-02-03T10:19:04Z

an URL encoded ISO 8601 date/time to start from (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

end_time
required
string
Example: end_time=2025-02-03T10:19:04Z

an URL encoded ISO 8601 date/time to end at (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

prompt_name
string
Example: prompt_name=crypto-24h

Competition: crypto-1h, crypto-24h, or com-equ-24h (legacy aliases: low, high)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Leaderboard - Latest Leaderboard V2

Gets the current leaderboard.

query Parameters
prompt_name
string
Example: prompt_name=crypto-24h

Competition: crypto-1h, crypto-24h, or com-equ-24h (legacy aliases: low, high)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Leaderboard - Meta-Leaderboard History V2

Gets the meta-leaderboard history, which aggregates miners' incentives over a period of days in the past.

query Parameters
start_time
required
string
Example: start_time=2025-02-03T10:19:04Z

an URL encoded ISO 8601 date/time to start from (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

prompt_name
string
Example: prompt_name=crypto-24h

Competition: crypto-1h, crypto-24h, or com-equ-24h (legacy aliases: low, high)

days
integer
Example: days=14

Number of days to aggregate for the meta-leaderboard (default is 14)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Leaderboard - Latest Meta-Leaderboard V2

Get the current meta-leaderboard, which aggregates miners' incentives over a period of days. This provides another way to rank prediction accuracy, thereby increasing stability.

query Parameters
days
integer
Example: days=14

Number of days to aggregate for the meta-leaderboard (default is 14)

prompt_name
string
Example: prompt_name=crypto-24h

Competition: crypto-1h, crypto-24h, or com-equ-24h (legacy aliases: low, high)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Validations - Miner Validation

Gets the validation status for a specific miner

query Parameters
uid
required
integer <int64>

ID of the miner to get validation for

Responses

Response samples

Content type
application/json
{
  • "reason": "string",
  • "response_time": "string",
  • "validated": true
}

Validations - Prompts

Gets the prompts of the validator

query Parameters
from
required
string
Example: from=2025-02-03T10:19:04Z

Start date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

to
required
string
Example: to=2025-02-03T10:19:04Z

End date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

asset
string
Example: asset=BTC

The symbol of the asset: BTC, ETH, XAU, SOL, SP500, NVDAX, TSLAX, AAPLX, GOOGLX (default BTC)

time_increment
required
integer
Example: time_increment=300

the time interval (in seconds) of the validator prompt between each rate: 300 or 60.

time_length
required
integer
Example: time_length=86400

the length of time (in seconds) of the validator prompt from the start time: 86400 or 3600.

Responses

Response samples

Content type
application/json
{
  • "start_times": [
    ]
}

Validations - Realized Path

Gets the realized close-price path that the validator used to score predictions for a given prompt

query Parameters
start_time
required
string
Example: start_time=2025-02-03T10:19:04Z

Start time of the validator request (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

asset
string
Example: asset=BTC

The symbol of the asset: BTC, ETH, XAU, SOL, SP500, NVDAX, TSLAX, AAPLX, GOOGLX, XRP, HYPE, WTIOIL (default BTC)

time_increment
required
integer
Example: time_increment=300

the time interval (in seconds) of the validator prompt between each rate: 300 or 60.

time_length
required
integer
Example: time_length=86400

the length of time (in seconds) of the validator prompt from the start time: 86400 or 3600.

Responses

Response samples

Content type
application/json
{
  • "asset": "string",
  • "real_prices": [
    ],
  • "start_time": "string",
  • "time_increment": 0,
  • "time_length": 0
}

Validations - Historical Scores

Gets the validation scores for all miners between two dates

query Parameters
from
required
string
Example: from=2025-02-03T10:19:04Z

Start date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

to
required
string
Example: to=2025-02-03T10:19:04Z

End date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

miner_uid
integer <int64>

Optional miner ID to filter by

asset
string
Example: asset=BTC

The symbol of the asset: BTC, ETH, XAU, SOL, SP500, NVDAX, TSLAX, AAPLX, GOOGLX, XRP, HYPE, WTIOIL (default BTC)

time_increment
integer
Example: time_increment=300

the time interval (in seconds) of the validator prompt between each rate: 300 or 60 (default 300).

time_length
integer
Example: time_length=86400

the length of time (in seconds) of the validator prompt from the start time: 86400 or 3600 (default 86400)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Validations - Latest Scores

Gets the most recent validation scores for all miners

query Parameters
asset
string
Example: asset=BTC

The symbol of the asset: BTC, ETH, XAU, SOL, SP500, NVDAX, TSLAX, AAPLX, GOOGLX, XRP, HYPE, WTIOIL (default BTC)

time_increment
integer
Example: time_increment=300

the time interval (in seconds) of the validator prompt between each rate: 300 or 60 (default 300).

time_length
integer
Example: time_length=86400

the length of time (in seconds) of the validator prompt from the start time: 86400 or 3600 (default 86400)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Validations - Scores Save Order

For each minute in which the validator scored the prompts of several assets of one time length, those assets in the order their scores were saved. Minutes scored for a single asset are omitted

query Parameters
from
required
string
Example: from=2025-02-03T10:19:04Z

Start date (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

to
required
string
Example: to=2025-02-04

End date, inclusive UTC day, at most 2 days after from (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03)

time_length
integer
Example: time_length=86400

the length of time (in seconds) of the validator prompt from the start time: 86400 or 3600 (default 86400)

Responses

Response samples

Content type
application/json
[
  • {
    }
]