Skip to content
Startmining

API & Desarrolladores

Integra datos de minería Bitcoin en tus apps, agentes IA y sistemas de trading.

Gratuito

$0

Perfecto para proyectos personales y exploración

  • Datos de mercado en tiempo real (precio, hashprice, dificultad)
  • Calculadora de rentabilidad
  • Datos históricos de 6 meses
  • Mempool y bloques recientes
  • Seguimiento del halving
  • 100 solicitudes/día

Enterprise

Personalizado

Para mesas de trading, fondos y operaciones de minería

  • Todo lo del tier gratuito
  • Datos históricos completos (desde 2009)
  • Datos de alta frecuencia (por minuto)
  • WebSocket en tiempo real
  • Límites personalizados (100k+/día)
  • SLA 99.9%
  • Soporte dedicado
Contáctenos

Widget Embed

Añade la calculadora de rentabilidad de minería a tu blog, newsletter o documentación en 2 líneas de HTML. Datos en vivo, gratis, sin clave API.

  • Datos en vivo desde un nodo Bitcoin Core
  • Sliders interactivos (BTC, dificultad, coste)
  • Bilingüe FR/EN, responsive
  • Backlink dofollow a Startmining
Ver documentación & ejemplos

Servidor MCP

Usa con Claude, ChatGPT y otros asistentes IA vía Model Context Protocol

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

Configuración Claude Desktop

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

Endpoints REST API

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

GET
/api/market/price

Precio BTC, hashprice, cambio 24h

GET
/api/market/difficulty

Dificultad actual, próximo ajuste

GET
/api/market-summary

Resumen completo del mercado

GET
/api/asic-prices

Precios ASIC por tier de eficiencia

12 endpoints — interactive reference

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

Open Swagger UI

Herramientas MCP

Herramientas disponibles con el servidor MCP

get_market_data

Datos de mercado actuales

get_hashprice

Desglose de hashprice

get_difficulty

Dificultad y próximo ajuste

get_halving_info

Info halving y cuenta regresiva

get_price_history

Historial de precios BTC

get_difficulty_history

Historial de dificultad

calculate_profitability

Calcular rentabilidad minera

calculate_breakeven

Calcular precio de equilibrio

get_mempool

Estado mempool y tarifas

get_recent_blocks

Bloques recientes

get_asic_prices

Precios de mercado ASIC

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.

Contáctenos

Rate limits

SurfaceLimitWhen 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
EnterpriseCustom (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." }
CodeMeaningAction
200OK—
400Malformed query parameterInspect the message field, fix the request.
401Authentication required (Enterprise endpoints only)Add the x-api-key header.
404Endpoint or resource not foundCheck the path against the OpenAPI spec.
429Rate-limitedHonour Retry-After, then resume.
500Bitcoin Core node or upstream aggregator unavailableRetry 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.