Skip to content
Startmining

API & Développeurs

Intégrez les données de mining Bitcoin dans vos apps, agents IA et systèmes de trading.

Gratuit

0€

Idéal pour projets personnels et exploration

  • Données marché temps réel (prix, hashprice, difficulté)
  • Calculateur de rentabilité
  • Historique 6 mois
  • Mempool & blocs récents
  • Suivi du halving
  • 100 requêtes/jour

Enterprise

Sur mesure

Pour trading desks, fonds et opérateurs mining

  • Tout le tier gratuit inclus
  • Historique complet (depuis 2009)
  • Données haute fréquence (par minute)
  • WebSocket temps réel
  • Rate limits personnalisés (100k+/jour)
  • SLA 99.9%
  • Support dédié
Nous contacter

Widget Embed

Intégrez le calculateur de rentabilité mining sur votre blog, newsletter ou doc en 2 lignes de HTML. Données live, gratuit, sans clé API.

  • Données live d'un nœud Bitcoin Core
  • Sliders interactifs (BTC, difficulté, coût)
  • Bilingue FR/EN, responsive
  • Backlink dofollow vers Startmining
Voir la doc & exemples

Serveur MCP

Utilisez avec Claude, ChatGPT et autres assistants IA via Model Context Protocol

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

Configuration Claude Desktop

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

Endpoints REST API

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

GET
/api/market/price

Prix BTC, hashprice, variation 24h

GET
/api/market/difficulty

Difficulté actuelle, prochain ajustement

GET
/api/market-summary

Résumé marché complet

GET
/api/asic-prices

Prix ASIC par tier d'efficacité

12 endpoints — interactive reference

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

Open Swagger UI

Outils MCP

Outils disponibles via le serveur MCP

get_market_data

Données marché actuelles

get_hashprice

Détail hashprice

get_difficulty

Difficulté & prochain ajustement

get_halving_info

Info halving & compte à rebours

get_price_history

Historique prix BTC

get_difficulty_history

Historique difficulté

calculate_profitability

Calculer rentabilité mining

calculate_breakeven

Calculer prix breakeven

get_mempool

État mempool & frais

get_recent_blocks

Blocs récents

get_asic_prices

Prix marché ASIC

Démarrage rapide

Appelez n'importe quel endpoint sans clé API. Le premier appel le plus utile est /api/market-summary — prix BTC, hashprice, difficulté, hashrate réseau et dernier bloc en un seul aller-retour.

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'])

Authentification

Tier gratuit

Anonyme, sans clé API. Envoyez n'importe quelle requête sans authentification. Une limite de débit par IP s'applique (voir Rate limits ci-dessous). Adapté aux projets personnels, prototypes et embeds à faible volume.

Tier Enterprise

Limite de débit personnalisée, SLA, support prioritaire, déploiement privé optionnel. Une fois provisionné, ajoutez le headerx-api-keyà chaque requête.

Nous contacter

Limites de débit

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

Les utilisateurs en production avec une charge prévisible doivent passer en Enterprise pour obtenir des headers de rate limit explicites et un SLA. Le trafic en burst sur le tier gratuit peut recevoir des réponses dégradées sans avertissement.

Erreurs

Les réponses réussies retournent 200 OK avec la forme JSON documentée. Les réponses d'erreur suivent cette enveloppe :

{ "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 & dépréciation

Nous suivons semver. L'API actuelle est en v1. Les endpoints sont stables jusqu'à la prochaine version majeure.

  • 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.

Journal des modifications

Modifications récentes apportées à la surface API et à l'expérience développeur.

  • 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.