SN50 | Synth API (1.0)
The Synth API provides the latest & historical prediction rates as well as the current leaderboard.
Insight - Liquidation probability
query Parameters
| asset | string Example: asset=BTC Asset |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
| limit | integer Example: limit=10 Number of miner to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 201
- 400
- 500
"string"Insight - Liquidity provider bounds
query Parameters
| asset | string Example: asset=BTC Asset |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
| limit | integer Example: limit=10 Number of miner to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 201
- 400
- 500
"string"Insight - Liquidity provider bounds chart
query Parameters
| asset | string Example: asset=BTC Asset |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
| limit | integer Example: limit=10 Number of miner to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 201
- 400
- 500
"string"Insight - Option pricing
query Parameters
| asset | string Example: asset=BTC Asset |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
| limit | integer Example: limit=10 Number of miner to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 201
- 400
- 500
"string"Leaderboard - Leaderboard History
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) |
Responses
Response samples
- 200
- 500
[- {
- "coldkey": "string",
- "emission": 0,
- "incentive": 0,
- "ip_address": "string",
- "neuron_uid": 0,
- "pruning_score": 0,
- "rank": 0,
- "stake": 0,
- "updated_at": "string"
}
]Leaderboard - Latest Meta-Leaderboard
Gets the current meta-leaderboard: aggregated 14-days miners incentives
query Parameters
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
Responses
Response samples
- 200
- 500
[- {
- "coldkey": "string",
- "emission": 0,
- "incentive": 0,
- "ip_address": "string",
- "neuron_uid": 0,
- "pruning_score": 0,
- "rank": 0,
- "stake": 0,
- "updated_at": "string"
}
]Leaderboard - Meta-Leaderboard History
Gets the meta-leaderboard history: aggregated 14-days miners incentives at a given time
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) |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14) |
Responses
Response samples
- 200
- 500
[- {
- "coldkey": "string",
- "emission": 0,
- "incentive": 0,
- "ip_address": "string",
- "neuron_uid": 0,
- "pruning_score": 0,
- "rank": 0,
- "stake": 0,
- "updated_at": "string"
}
]Predictions - Best Prediction Rates
Gets the latest prediction rates of the best miner.
query Parameters
| asset required | string Example: asset=BTC the symbol of the asset: BTC, ETH, XAU or SOL |
| time_increment required | integer Example: time_increment=300 the time interval (in seconds) between each rate |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) from now |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 404
- 500
[- {
- "asset": "string",
- "miner_uid": 0,
- "num_simulations": 0,
- "prediction": [
- [
- {
- "price": 0,
- "time": "string"
}
]
], - "start_time": "string",
- "time_increment": 0,
- "time_length": 0
}
]Predictions - Historical Prediction Rates
Gets the historical prediction rates.
query Parameters
| miner required | Array of integers a list of specific miners by their ID |
| asset required | string Example: asset=BTC the symbol of the asset: BTC, ETH, XAU or SOL |
| start_time required | string Example: start_time=2025-02-03T10:19:04Z an ISO 8601 date/time to start the historical rates from (2025-02-03T10:19:04Z or 2025-02-03T17:19:04+07:00 or 2025-02-03) |
| time_increment required | integer Example: time_increment=300 the time interval (in seconds) between each rate |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) from the start time |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 404
- 500
[- {
- "asset": "string",
- "miner_uid": 0,
- "num_simulations": 0,
- "prediction": [
- [
- {
- "price": 0,
- "time": "string"
}
]
], - "start_time": "string",
- "time_increment": 0,
- "time_length": 0
}
]Predictions - Latest Prediction Rates
Gets the latest valid prediction rates.
query Parameters
| miner required | Array of integers a list of specific miners by their ID |
| asset required | string Example: asset=BTC the symbol of the asset: BTC, ETH, XAU or SOL |
| time_increment required | integer Example: time_increment=300 the time interval (in seconds) between each rate |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) from now |
| limit | integer Example: limit=10 the maximum number of predictions to return, default is the size of the miners array |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 404
- 500
[- {
- "asset": "string",
- "miner_uid": 0,
- "num_simulations": 0,
- "prediction": [
- [
- {
- "price": 0,
- "time": "string"
}
]
], - "start_time": "string",
- "time_increment": 0,
- "time_length": 0
}
]Rewards - Current axons rewards
Gets the current and total rewards data of all axons along with their current UIDs
Responses
Response samples
- 200
- 400
- 500
[- {
- "axon_ip": "string",
- "cumulative_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
], - "current_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
], - "current_uids": [
- 0
], - "date": "string",
- "miner_count": 0,
- "total_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
]
}
]Rewards - Historical axons rewards
Gets the historical rewards data of all axons between two dates (date range cannot exceed 300 days)
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) |
Responses
Response samples
- 200
- 400
- 500
[- {
- "axon_ip": "string",
- "cumulative_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
], - "current_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
], - "current_uids": [
- 0
], - "date": "string",
- "miner_count": 0,
- "total_rewards": [
- {
- "amount": 0,
- "asset": "string"
}
]
}
]Rewards - Historical miner rewards
Gets the rewards historical data for all miners between two dates (date range cannot exceed 300 days)
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) |
Responses
Response samples
- 200
- 400
- 500
[- {
- "date": "string",
- "rewards": [
- {
- "amount": 0,
- "asset": "string"
}
]
}
]Validations - Rewards Scores
Gets the rewards 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 |
Responses
Response samples
- 200
- 400
- 500
[- {
- "miner_uid": 0,
- "reward_weight": 0,
- "smoothed_score": 0,
- "updated_at": "string"
}
]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 or SOL (default BTC) |
Responses
Response samples
- 200
- 400
- 500
[- {
- "asset": "string",
- "crps": 0,
- "miner_uid": 0,
- "prompt_score": 0,
- "scored_time": "string"
}
]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 or SOL (default BTC) |
Responses
Response samples
- 200
- 500
[- {
- "asset": "string",
- "crps": 0,
- "miner_uid": 0,
- "prompt_score": 0,
- "scored_time": "string"
}
]