Providers
GET /v1/providers
List storage providers.
Query parameters
| Param | Type | Notes |
|---|---|---|
network | string | Required |
status | active | waitlisted | all | Default all |
az | string | Filter by availability zone |
limit | number | Default 50 |
offset | number | Default 0 |
Response
{ "providers": [], "count": 0, "total": 0 }GET /v1/providers/:address
Single provider detail, including reputation and PG assignment.
Query parameters
| Param | Type | Notes |
|---|---|---|
network | string | Required |
Response
{
"address": "0x...",
"reputationScore": 0,
"uptimePct30d": 0,
"designatedPgs": [],
"stake": "0",
"epochHistory": []
}GET /v1/providers/leaderboard
Ranked provider leaderboard.
Query parameters
| Param | Type | Notes |
|---|---|---|
network | string | Required |
sort | score | uptime | stake | Default score |
limit | number | Default 20 |
Response
{ "leaderboard": [{ "rank": 1, "address": "0x...", "score": 0 }] }GET /v1/providers/:address/history
Health history for a single provider.
Query parameters
| Param | Type | Notes |
|---|---|---|
network | string | Required |
from | ISO timestamp | |
to | ISO timestamp | |
resolution | string | Default 1h |
Response
{ "history": [{ "time": "2026-07-30T00:00:00Z", "health": "Healthy", "condition": 0 }] }GET
/v1/providersList storage providers.
GET
/v1/providers/leaderboardRanked SP leaderboard.
GET
/v1/providers/{address}Single provider detail. Use a real address from the leaderboard response above — post-wipe shelbynet addresses differ from any older testnet examples.
GET
/v1/providers/{address}/historyHealth/condition history for a single provider over time.