Skip to content
Startmining

API & Desenvolvedores

Integre dados de mineração Bitcoin em seus apps, agentes IA e sistemas de trading.

Gratuito

R$0

Perfeito para projetos pessoais e exploração

  • Dados de mercado em tempo real (preço, hashprice, dificuldade)
  • Calculadora de rentabilidade
  • Dados históricos de 6 meses
  • Mempool e blocos recentes
  • Rastreamento do halving
  • 100 requisições/dia

Enterprise

Personalizado

Para mesas de trading, fundos e operações de mineração

  • Tudo do tier gratuito
  • Dados históricos completos (desde 2009)
  • Dados de alta frequência (por minuto)
  • WebSocket em tempo real
  • Limites personalizados (100k+/dia)
  • SLA 99,9%
  • Suporte dedicado
Fale conosco

Widget Embed

Adicione a calculadora de rentabilidade de mineração ao seu blog, newsletter ou documentação em 2 linhas de HTML. Dados ao vivo, grátis, sem chave API.

  • Dados ao vivo de um nó Bitcoin Core
  • Sliders interativos (BTC, dificuldade, custo)
  • Bilíngue FR/EN, responsivo
  • Backlink dofollow para Startmining
Ver documentação & exemplos

Servidor MCP

Use com Claude, ChatGPT e outros assistentes IA via Model Context Protocol

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

Configuração Claude Desktop

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

Endpoints REST API

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

GET
/api/market/price

Preço BTC, hashprice, variação 24h

GET
/api/market/difficulty

Dificuldade atual, próximo ajuste

GET
/api/market-summary

Resumo completo do mercado

GET
/api/asic-prices

Preços ASIC por tier de eficiência

12 endpoints — interactive reference

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

Open Swagger UI

Ferramentas MCP

Ferramentas disponíveis com o servidor MCP

get_market_data

Dados de mercado atuais

get_hashprice

Detalhamento do hashprice

get_difficulty

Dificuldade e próximo ajuste

get_halving_info

Info halving e contagem regressiva

get_price_history

Histórico de preços BTC

get_difficulty_history

Histórico de dificuldade

calculate_profitability

Calcular rentabilidade de mineração

calculate_breakeven

Calcular preço de equilíbrio

get_mempool

Status mempool e taxas

get_recent_blocks

Blocos recentes

get_asic_prices

Preços 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.

Fale conosco

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.