Skip to content
Startmining

API والمطورون

ادمج بيانات تعدين البيتكوين في تطبيقاتك ووكلاء الذكاء الاصطناعي وأنظمة التداول.

مجاني

مجاناً

مثالي للمشاريع الشخصية والاستكشاف

  • بيانات السوق الفورية (السعر، hashprice، الصعوبة)
  • حاسبة الربحية
  • بيانات تاريخية 6 أشهر
  • Mempool والكتل الأخيرة
  • متتبع التنصيف
  • 100 طلب/يوم

المؤسسات

مخصص

لمكاتب التداول والصناديق وعمليات التعدين

  • كل ميزات الباقة المجانية
  • بيانات تاريخية كاملة (منذ 2009)
  • بيانات عالية التردد (بالدقيقة)
  • WebSocket مباشر
  • حدود مخصصة (100k+/يوم)
  • SLA 99.9%
  • دعم مخصص
اتصل بنا

أداة الإدماج

أضف حاسبة ربحية التعدين إلى مدونتك أو نشرتك الإخبارية أو وثائقك بسطرين من HTML. بيانات حية، مجاني، بدون مفتاح API.

  • بيانات حية من عقدة Bitcoin Core
  • شرائح تفاعلية (BTC، الصعوبة، التكلفة)
  • ثنائي اللغة FR/EN، متجاوب
  • رابط خلفي dofollow إلى Startmining

خادم MCP

استخدم مع Claude وChatGPT ومساعدي الذكاء الاصطناعي الآخرين عبر Model Context Protocol

npm install -g startmining-mcp

# Or use with npx
npx startmining-mcp

إعدادات Claude Desktop

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

نقاط نهاية REST API

الرابط الأساسي: 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

حالة Mempool والرسوم

get_recent_blocks

الكتل الأخيرة

get_asic_prices

أسعار سوق 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.

اتصل بنا

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.