Public API

Miners Tools CDN exposes a free, read-only JSON API over the firmware archive. No API key — just HTTP GET. CORS is open (Access-Control-Allow-Origin: *), and it is generated statically from the same data as the site, so it never goes stale.

Base URL: https://cdn.miners.tools/api/v1/

Endpoints

Method & path	Returns
GET /api/v1/manufacturers	list of manufacturers + counts
GET /api/v1/{manufacturer}/models	models for a manufacturer
GET /api/v1/{manufacturer}/{model}/firmware/list	firmwares for a model
GET /api/v1/{manufacturer}/{model}/firmware/download/{firmware}	302 redirect to the file

where {manufacturer} is one of bitmain, innosilicon, whatsminer, vnish.

Example

# list firmwares for the Bitmain Antminer S19 Pro
curl https://cdn.miners.tools/api/v1/bitmain/s19pro/firmware/list

# download a firmware (follows the 302 to the file)
curl -L -O https://cdn.miners.tools/api/v1/bitmain/s19pro/firmware/download/Antminer-S19-Pro-merge-release-20221226124238.bmu

Response shape

{
  "api": "v1",
  "manufacturer": "bitmain",
  "model": "s19pro",
  "name": "Antminer S19PRO",
  "count": 6,
  "firmwares": [
    {
      "filename": "Antminer-S19-Pro-merge-release-20221226124238.bmu",
      "size_human": "48.5 MB",
      "released": "2022-12-26",
      "download": "https://cdn.miners.tools/api/v1/bitmain/s19pro/firmware/download/Antminer-S19-Pro-merge-release-20221226124238.bmu",
      "direct": "https://cdn.miners.tools/downloads/bitmain/sha256/S19PRO/FW/Antminer-S19-Pro-merge-release-20221226124238.bmu"
    }
  ]
}

Each firmware has two links: download is the API endpoint that 302-redirects to the file (stay inside the API), while direct is the plain file URL on the CDN (no redirect). Both are absolute URLs.