logo
API docs by Redocly

Mode Synth Subnet API (1.0)

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

Delete an API Key

header Parameters
Authorization
required
string
Example: Apikey MY_API_KEY

API key of an admin

Request Body schema: application/json
required

the key to delete

string

Responses

Request samples

Content type
application/json
"string"

Response samples

Content type
application/json
"string"

Get a list of all API Keys

header Parameters
Authorization
required
string
Example: Apikey MY_API_KEY

API key of an admin

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a new API Key

header Parameters
Authorization
required
string
Example: Apikey MY_API_KEY

API key of an admin

Request Body schema: application/json
required

Attributes of the key to created.

label
string
rate_limit
number
role
string

Responses

Request samples

Content type
application/json
{
  • "label": "string",
  • "rate_limit": 0,
  • "role": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "key_plain_text": "string",
  • "label": "string",
  • "rate_limit": 0,
  • "role": "string"
}

Modify an API Key

header Parameters
Authorization
required
string
Example: Apikey MY_API_KEY

API key of an admin

Request Body schema: application/json
required

Key to modify and it's new attributes.

id
integer
label
string
rate_limit
number
role
string

Responses

Request samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "rate_limit": 0,
  • "role": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "label": "string",
  • "rate_limit": 0,
  • "role": "string"
}

Leaderboard

Gets the current leaderboard.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

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

Content type
application/json
[
  • {
    }
]

Best Prediction Rates

Gets the best prediction rates.

query Parameters
asset
required
string
Example: asset=BTC

the symbol of the asset

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

Content type
application/json
[
  • {
    }
]

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

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

Content type
application/json
[
  • {
    }
]

Latest Prediction Rates

Gets the latest 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

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

Content type
application/json
[
  • {
    }
]

Get 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

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

Get 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

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Latest Scores

Gets the most recent validation scores for all miners

Responses

Response samples

Content type
application/json
[
  • {
    }
]