الـAPI العام

كل شي بيعرضه الموقع متوفّر كـJSON من نفس الـAPI للقراءة فقط. ما بدّو مفتاح.

https://api.hashlak.com/api/v1

  • المال دايماً نص (string) مش رقم عشري: اعرضه، وما تحسب فيه بالـJavaScript.
  • حدّ الطلبات: 60 طلب بالدقيقة لكل IP (429 فوق هيك).
  • الردود مخزّنة مؤقّتاً 30–60 ثانية؛ cached_for_seconds بيقلّك قدّيش.
  • CORS مفتوح لـhashlak.com؛ من مصادر تانية نادي الـAPI من سيرفرك.
  • الأخطاء JSON فيها حقل message؛ pool غير معروف أو عنوان غلط = 404.
  • explorer_url رابط لمستكشف البلوكات العام لشبكة العملة الحالية؛ بيكون null بس على شبكة اختبار خاصة (ما إلها مستكشف عام).

GET /pools

كل الـpools مع الإحصاءات الحيّة، المجاميع، الحظّ، وعيّنات 24 ساعة للرسم.

{"data":[{"id":"zeph1","ticker":"ZEPH","stats":{"pool_hashrate":3311,"connected_miners":2,"network_height":2224},"blocks":{"confirmed":51,"pending":1},"payouts":{"count":2,"total_paid":"662.95"},"luck":{"luck_percent":112.4},"samples_24h":[…]}]}

GET /pools/{pool}

pool واحد.

{"data":{"id":"zeph1", …same as above… }}

GET /pools/{pool}/stats?range=24h|7d

عيّنات متوسّطة للرسوم البيانية: كل 10 دقايق على 24 ساعة، وكل ساعة على 7 أيام.

{"data":[{"at":"2026-11-01T09:00:00+00:00","pool_hashrate":3400.5,"network_hashrate":1400,"connected_miners":2,"network_difficulty":165000}],"range":"24h"}

GET /pools/{pool}/blocks?page=1&page_size=25

البلوكات، الأحدث أول، مع تقدّم التأكيد وروابط المستكشف.

{"data":[{"height":9713145,"status":"confirmed","reward":"0.30546944","effort":0.92,"miner":"xel:psqe…","hash":"5244be8a…","explorer_url":"https://explorer.xelis.io/block/5244be8a…","found_at":"…"}],"meta":{"current_page":1,"last_page":3,"per_page":25,"total":52}}

GET /pools/{pool}/payments?page=1

الدفعات، الأحدث أول، مع hash المعاملة.

{"data":[{"address":"xel:psqe…","amount":"0.51234567","tx_hash":"409e72c8…","explorer_url":"https://explorer.xelis.io/tx/409e72c8…","paid_at":"…"}],"meta":{…}}

GET /pools/{pool}/miners/{address}

محفظة على pool: الرصيد المعلّق، المدفوع، الأجهزة، هاشريت 24 ساعة.

{"data":{"pending_balance":"25.560180721352","total_paid":"637.384843661221","paid_last_24h":"0","payout_count":1,"workers":[{"worker":"rig1","hashrate":1250,"last_seen":"…"}],"hashrate_24h":[…],"blocks_found":3}}

GET /pools/{pool}/miners/{address}/payments · /blocks

دفعات وبلوكات هالمحفظة، على صفحات.

same shapes as the pool lists, filtered to the address

GET /coins

سجلّ العملات: المنافذ (عادي وTLS)، الرسوم، الحدّ الأدنى للسحب، أوامر الـminer، بيانات التواصل.

{"data":[{"id":"rvn1","ports":[{"port":3301,"tls":false},{"port":3501,"tls":true}],"miners":[{"software":"T-Rex (NVIDIA)","command":"t-rex -a kawpow -o stratum+tcp://stratum.hashlak.com:3301 -u {wallet}.{worker} -p x"}]}],"meta":{"telegram_bot_username":"…"}}

GET /economics

مدخلات الحاسبة لكل بول: مكافأة البلوك (وسيط آخر البلوكات المؤكّدة على الشبكة الرئيسية، وإلا القيمة الاسمية)، آخر قوة للشبكة، سعر USD من CoinGecko مع تاريخه وعلامة إذا كان قديم. مخزّن 5 دقايق.

{"data":[{"id":"xel","ticker":"XEL","network":"mainnet","algorithm":"XelisHash v3","block_time_seconds":5,"fee_percent":"0","block_reward":"0.3057","block_reward_source":"observed","network_hashrate":62400000,"sampled_at":"…","price_usd":"0.309481","price_updated_at":"…","price_source":"coingecko","price_stale":false}],"cached_for_seconds":300,"disclaimer":"Estimates …"}

GET /health

قاعدة البيانات شغّالة والإحصاءات حديثة — للمراقبة.

{"status":"ok","database":"ok","newest_sample_age_seconds":114}   (503 when degraded)