SN50 | Synth API (1.0)

The Synth API provides the latest & historical prediction rates as well as the current leaderboard.

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=low Prompt name, high for 1h prompt or low for 24h prompt

Responses

Response samples

200
500

Content type

application/json

[{"coldkey": "string",
"ip_address": "string",
"neuron_uid": 0,
"rewards": 0,
"updated_at": "string"
}
]

Leaderboard - Latest Leaderboard V2

Gets the current leaderboard.

query Parameters

prompt_name

string

Example: prompt_name=low

Prompt name, high for 1h prompt or low for 24h prompt

Responses

Response samples

200
500

Content type

application/json

[{"coldkey": "string",
"ip_address": "string",
"neuron_uid": 0,
"rewards": 0,
"updated_at": "string"
}
]

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=low Prompt name, high for 1h prompt or low for 24h prompt
days	integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14)

Responses

Response samples

200
500

Content type

application/json

[{"coldkey": "string",
"ip_address": "string",
"neuron_uid": 0,
"rewards": 0,
"updated_at": "string"
}
]

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=low Prompt name, high for 1h prompt or low for 24h prompt

Responses

Response samples

200
500

Content type

application/json

[{"coldkey": "string",
"ip_address": "string",
"neuron_uid": 0,
"rewards": 0,
"updated_at": "string"
}
]

Validations - Miner Validation

Gets the validation status for a specific miner

query Parameters

uid

required

integer

ID of the miner to get validation for

Responses

Response samples

200
400
500

Content type

application/json

{"reason": "string",
"response_time": "string",
"validated": true
}

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 Optional miner ID to filter by
asset	string Example: asset=BTC The symbol of the asset: BTC, ETH, XAU, SOL, SPYX, NVDAX, TSLAX, AAPLX, GOOGLX (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

200
400
500

Content type

application/json

[{"asset": "string",
"crps": 0,
"miner_uid": 0,
"prompt_score": 0,
"scored_time": "string",
"time_length": 0
}
]

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, SPYX, NVDAX, TSLAX, AAPLX, GOOGLX (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

200
500

Content type

application/json

[{"asset": "string",
"crps": 0,
"miner_uid": 0,
"prompt_score": 0,
"scored_time": "string",
"time_length": 0
}
]