API & Developers

Integrate Bitcoin mining data into your apps, AI agents, and trading systems.

Free Tier

Perfect for personal projects and exploration

Real-time market data (price, hashprice, difficulty)
Profitability calculator
6-month historical data
Mempool & recent blocks
Halving tracker
100 requests/day

Enterprise

Custom

For trading desks, funds, and mining operations

Everything in Free tier
Full historical data (since 2009)
High-frequency data (per-minute)
WebSocket live feeds
Custom rate limits (100k+/day)
99.9% SLA
Dedicated support

Embed Widget

Add the mining profitability calculator to your blog, newsletter or docs in 2 lines of HTML. Live data, free, no API key required.

Live data from a Bitcoin Core node
Interactive sliders (BTC, difficulty, cost)
Bilingual FR/EN, responsive
Dofollow backlink to Startmining

See docs & examples

MCP Server

Use with Claude, ChatGPT, and other AI assistants via Model Context Protocol

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

Claude Desktop Configuration

{
  "mcpServers": {
    "startmining": {
      "command": "npx",
      "args": ["startmining-mcp"]
    }
  }
}

npm GitHub

REST API Endpoints

Base URL: https://pro.startmining.io

GET

/api/market/price

BTC price, hashprice, 24h change

GET

/api/market/difficulty

Current difficulty, next adjustment

GET

/api/market-summary

Complete market summary

GET

/api/asic-prices

ASIC prices by efficiency tier

12 endpoints — interactive reference

OpenAPI 3.1 spec, try any endpoint from the browser, no API key.

Open Swagger UI

MCP Tools

Available tools when using the MCP server

get_market_data

Current market data

get_hashprice

Hashprice breakdown

get_difficulty

Difficulty & next adjustment

get_halving_info

Halving info & countdown

get_price_history

Historical BTC prices

get_difficulty_history

Historical difficulty

calculate_profitability

Calculate mining profitability

calculate_breakeven

Calculate breakeven price

get_mempool

Mempool status & fees

get_recent_blocks

Recent blocks info

get_asic_prices

ASIC market prices

Quick start

Hit any endpoint without an API key. The most useful first call is /api/market-summary — BTC price, hashprice, difficulty, network hashrate and last block in one round-trip.

curl

curl https://pro.startmining.io/api/market-summary

JavaScript / fetch

const r = await fetch(
  'https://pro.startmining.io/api/market-summary'
)
const data = await r.json()
console.log(data.btcPrice, data.hashpriceUsd)

Python / requests

import requests

r = requests.get(
  'https://pro.startmining.io/api/market-summary'
)
print(r.json()['hashpriceUsd'])

Authentication

Free tier

Anonymous, no API key. Send any request without authentication. Per-IP rate limit applies (see Rate limits below). Suitable for personal projects, prototypes, and low-volume embeds.

Enterprise tier

Custom rate limit, SLA, priority support, optional private deployment. Ship thex-api-keyheader on every request once provisioned.

Rate limits

Surface	Limit	When exceeded
`/embed/*` (iframe widget)	60 req / min per (IP, embedding domain)	`429` + `Retry-After: 60`
`/api/*` (REST endpoints)	Soft limit at infrastructure level (~60 req / min / IP)	Connection throttled, no JSON envelope
Enterprise	Custom (negotiated)	`429` + `X-RateLimit-*` headers

Production users with predictable load should switch to Enterprise to get explicit rate-limit headers and an SLA. Burst traffic on the Free tier may receive degraded responses without warning.

Errors

Successful responses return 200 OK with the documented JSON shape. Failure responses follow this envelope:

{ "error": "rate_limited", "message": "Free tier — slow down or contact contact@startmining.io." }

Code	Meaning	Action
200	OK	—
400	Malformed query parameter	Inspect the `message` field, fix the request.
401	Authentication required (Enterprise endpoints only)	Add the `x-api-key` header.
404	Endpoint or resource not found	Check the path against the OpenAPI spec.
429	Rate-limited	Honour `Retry-After`, then resume.
500	Bitcoin Core node or upstream aggregator unavailable	Retry with exponential backoff.

Versioning & deprecation

We follow semver. The current API is v1. Endpoints are stable until a new major version ships.

Patch / minor changes are additive — new fields, new endpoints, no breakage.
Major bumps go through a 6-month deprecation window. Affected endpoints emit a Deprecation response header pointing to a migration note before the cut-over.
Breaking changes are announced on this page and in the llms-full.txt changelog block.

Changelog

Recent changes to the API surface and developer experience.

2026-04-30OpenAPI 3.1 spec published at /openapi.yaml with interactive Swagger UI at /developers/api. 12 endpoints documented end-to-end with real-data examples.
2026-04-30/embed/* rate-limited at 60 req/min per (IP, embedding domain).
2026-04-30GDPR rights surfaced — account export (Art. 20) and delete (Art. 17) at /account.
2026-04-30SEO refresh — 308 permanent redirects on /fr/*, x-robots-tag: noindex on the OG image, dynamic ASIC count in titles/descriptions.
2026-04-30Catalogue extended to 87 ASIC models — solo miners (Bitaxe, GekkoScience, Lucky Miner) added with proper categorisation.
2026-04-30Iframe widget redesigned — 4 surfaces refreshed, brand-chart compliant, container queries for true responsiveness.
2026-04-30/halving page shipped — countdown to halving #5 (April 2028, block 1,050,000) with per-ASIC break-even table.
2026-04Multi-locale support extended to 7 languages (FR, EN, ES, AR, DE, PT, ZH) on every public page.