Introduction

The Minerstat Pools API provides curated information about mining pools, supported coins, fees, and payout thresholds. Access has moved behind authenticated developer accounts. Register via the Developer Portal, verify your email, and subscribe to a plan to receive an API key.

Authorization

Attach your key to every request using the X-API-Key header (preferred) or the ?key= query parameter for quick tests. Unauthorized calls 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

Requests count toward your monthly subscription quota and are additionally throttled to roughly 12 requests per minute. Pool data refreshes about once per minute, so calling the endpoint more frequently offers no benefit. Once the quota is consumed the API responds with HTTP 402 until the next billing cycle or you upgrade.

Responses and error handling

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