General APIs with JWT

Get comprehensive statistics for a provider

Changed on

Endpoint to retrieve detailed statistics for a provider including network speed, location, feedback rates, rental failures, rental successes, uptime, and more. No API key or session is needed: the marketplace provider page shows these statistics to every visitor (DAH-3462).

get/provider-stats/{miner_hotkey}

Request

  • Base URL: https://lium.io/api
  • URL: https://lium.io/api/provider-stats/{miner_hotkey}
  • Auth: none declared

Path parameters

miner_hotkeystring required

Response

Provider statistics retrieved successfully

miner_hotkeystring required

The hotkey of the provider

Example response

{
  "average_network_speed": {
    "average_download_speed_mbps": 520.75,
    "average_upload_speed_mbps": 450.25,
    "total_machines_with_network_data": 5
  },
  "collateral_status": {
    "active_count": 5,
    "collateral_deposited_count": 5,
    "collateral_percentage": 100,
    "total_machines": 5,
    "verified_count": 5,
    "verified_percentage": 100
  },
  "feedback_rates": {
    "bad_feedbacks": 5,
    "good_feedbacks": 45,
    "good_percentage": 90,
    "total_feedbacks": 50
  },
  "locations": [
    {
      "city": "San Francisco",
      "country": "United States",
      "country_code": "US",
      "latitude": 37.7749,
      "longitude": -122.4194,
      "region": "California",
      "timezone": "America/Los_Angeles"
    }
  ],
  "max_rental_time": {
    "max_rental_duration_hours": 168.5
  },
  "miner_hotkey": "5Abc123...",
  "rental_failures": {
    "rental_failures": 2
  },
  "rental_successes": {
    "rental_successes": 150,
    "success_rate_percentage": 98.68
  },
  "unique_positive_renters": {
    "unique_positive_renters": 25
  },
  "unique_renters": {
    "unique_renters": 28
  },
  "uptime_counts": {
    "average_uptime_hours": 720,
    "reclaimed_count": 1,
    "total_gpus": 40,
    "total_machines": 5
  }
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property to the response with the status