SN50 | Synth API (1.0)
The Synth API provides the latest & historical prediction rates as well as the current leaderboard.
Insight - Liquidation probability
It selects the top 'limit' miners from the the meta-leaderboard to calculate the probability of liquidation in 6, 12, 18 and 24 hours for different price levels.
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). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 500
"string"Insight - Liquidity provider bounds
It selects the top 'limit' miners from the the meta-leaderboard to calculate price intervals and probability to stay in each interval for the next 24 hours, expected time to stay in each interval and impermanent loss.
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). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 500
"string"Insight - Liquidity provider bounds chart
It selects the top 'limit' miners from the the meta-leaderboard to calculate the probability of asset price to be above 11 prices and bellow 11 prices.
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). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 500
"string"Insight - Option pricing
It selects the top 'limit' miners from the the meta-leaderboard to calculate the call and put prices for different strike prices.
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). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 500
"string"Insight - Volatility
It selects the top 'limit' miners from the the meta-leaderboard to calculate the volatility.
query Parameters
| asset | string Example: asset=BTC Asset: BTC or ETH |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 400
- 500
"string"Insight - Volatility Percentiles
It selects the top 'limit' miners from the the meta-leaderboard to calculate the volatility percentiles.
query Parameters
| asset | string Example: asset=BTC Asset: BTC or ETH |
| days | integer Example: days=14 Number of days to aggregate for the meta-leaderboard (default is 14). See 'Leaderboard - Latest Meta-Leaderboard'. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
header Parameters
| Authorization required | string Example: Apikey MY_API_KEY API key |
Responses
Response samples
- 200
- 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
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) |
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, 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) |
| 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 current 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) of the validator prompt between each rate. Only 300 for now. |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) of the validator prompt from the start time. Only 86400 for 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) of the validator prompt between each rate. Only 300 for now. |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) of the validator prompt from the start time. Only 86400 for 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 - 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) of the validator prompt between each rate. Only 300 for now. |
| time_length required | integer Example: time_length=86400 the length of time (in seconds) of the validator prompt from the start time. Only 86400 for now. |
| limit | integer Example: limit=10 Number of miners from the meta-leaderboard to use for the analysis (default is 10) |
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_holding_rewards": [
- {
- "amount": 0,
- "asset": "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_holding_rewards": [
- {
- "amount": 0,
- "asset": "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"
}
]