API 与开发者

将比特币挖矿数据集成到您的应用、AI 代理和交易系统中。

免费版

免费

适合个人项目和探索

实时市场数据（价格、hashprice、难度）
收益计算器
6个月历史数据
内存池和最新区块
减半追踪
每天 100 次请求

企业版

定制

适用于交易台、基金和挖矿运营

包含免费版所有功能
完整历史数据（自2009年起）
高频数据（每分钟）
WebSocket 实时推送
自定义速率限制（100k+/天）
99.9% SLA
专属支持

联系我们

嵌入小工具

用 2 行 HTML 将挖矿盈利能力计算器添加到您的博客、新闻通讯或文档中。实时数据、免费、无需 API 密钥。

来自 Bitcoin Core 节点的实时数据
交互式滑块（BTC、难度、成本)
双语 FR/EN、响应式
Dofollow 反向链接到 Startmining

查看文档与示例

MCP 服务器

通过 Model Context Protocol 与 Claude、ChatGPT 等 AI 助手配合使用

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

Claude Desktop 配置

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

npm GitHub

REST API 端点

基础 URL：https://pro.startmining.io

GET

/api/market/price

BTC 价格、hashprice、24小时涨跌

GET

/api/market/difficulty

当前难度、下次调整

GET

/api/market-summary

完整市场摘要

GET

/api/asic-prices

按效率等级的 ASIC 价格

12 endpoints — interactive reference

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

Open Swagger UI

MCP 工具

使用 MCP 服务器时可用的工具

get_market_data

当前市场数据

get_hashprice

hashprice 详情

get_difficulty

难度与下次调整

get_halving_info

减半信息与倒计时

get_price_history

BTC 历史价格

get_difficulty_history

历史难度

calculate_profitability

计算挖矿收益

calculate_breakeven

计算盈亏平衡价格

get_mempool

内存池状态与费用

get_recent_blocks

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.