Introduction

The Minerstat Hardware API delivers hashrate, power consumption, and specification data for GPUs and ASIC devices in our catalogue. Use of this endpoint now requires an authenticated developer account. Sign up in the Developer Portal, verify your email, and choose a subscription plan to generate an API key.

Authorization

Every request must include your API key in the X-API-Key header (preferred) or as ?key=YOUR_KEY during testing. Missing or invalid credentials return HTTP 401; revoked keys or inactive subscriptions return HTTP 403.

Requirements

• An active developer account.
• An API key created in the API Keys tab of the Developer Portal.
• Compliance with the subscription terms regarding attribution and data usage.

Base URL

Rate limits

Authenticated calls deduct from your monthly quota. In addition we enforce an approximate limit of 12 requests per minute per IP to protect service quality. Hardware data refreshes roughly once per minute—calling the endpoint more frequently provides no additional insight. Once your monthly quota is exhausted, the API responds with HTTP 402 “Monthly quota exceeded” until the cycle renews or you upgrade.

Responses and error handling

All responses are JSON encoded. Common error codes include:

• 400 – Invalid parameter
• 401 – Missing or invalid API key
• 402 – Monthly quota exceeded
• 403 – Subscription not active or key revoked
• 404 – Non-existent content
• 500 – API/System error