BITCOIN · ETHEREUM · BNB · SOLANA

واجهة API لخلاط العملات المشفرة

اخلط Bitcoin وEthereum وBNB وSolana من شيفرتك الخاصة. JSON بسيط عبر HTTPS دون حساب ودون مفتاح API: ابدأ عملية خلط، وأرسل العملات إلى عنوانها المخصص لمرة واحدة، ثم تابعها حتى تصل العملات الجديدة إلى عنوان الاستلام.

كيف تعمل واجهة API للخلاط

استدعِ POST /api/v1/mixes مع العملة وعنوان الاستلام ومدة تأخير من 30 إلى 1,200 دقيقة.
أرسل الحد الأدنى على الأقل إلى send_to_address، ثم استدعِ /sent.
تُؤكَّد العملات على السلسلة، ويبدأ التأخير الذي اخترته.
عند انتهاء التأخير تُرسَل عملات جديدة إلى عنوان الاستلام. استعلم عن عملية الخلط دوريًا حتى تصبح حالتها complete.

عنوان URL الأساسي: https://bitcoinmix.io/api/v1. المواصفات الكاملة: OpenAPI 3.1. تفضّل الأدوات على HTTP؟ استخدم خادم MCP لخلاط العملات المشفرة.

نقاط النهاية

الطريقة	المسار	الوظيفة
GET	`/api/v1/coins`	العملات والشبكات والحدود الدنيا والرسوم ونطاق التأخير
POST	`/api/v1/mixes`	بدء عملية خلط والحصول على العنوان المخصص لمرة واحدة لإرسال العملات إليه
GET	`/api/v1/mixes/{mix_id}`	حالة عملية خلط واحدة ومبالغها وتوقيتها
POST	`/api/v1/mixes/{mix_id}/sent`	تم إرسال العملات: يُفحَص العنوان بعد +1 و+5 و+10 دقائق
GET	`/api/v1/mixes/{mix_id}/letter`	خطاب الضمان كنص عادي

بدء عملية خلط

أرسل JSON يحتوي على coin وreceiving_address وdelay_minutes. ويمكن إضافة partner_code اختياريًا لاحتساب العمولة لشريك. تُرفَض الحقول غير المعروفة.

curl -X POST https://bitcoinmix.io/api/v1/mixes \
  -H 'Content-Type: application/json' \
  -d '{
    "coin": "BTC",
    "receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
    "delay_minutes": 120
  }'

الاستجابة، بشكل مختصر:

{
  "mix_id": "5f1c…64 hex characters…a9e0",
  "coin": "BTC",
  "status": "waiting_for_coins",
  "send_to_address": "bc1qgr7f3jfuzhpe45h3dnqxxjr3ml0de4ad2w3ysd",
  "receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
  "minimum_amount": "0.0015",
  "delay_minutes": 120,
  "service_fee_percent": 3.36,
  "link_expires_at": "2026-10-17T14:49:04.943Z",
  "letter_of_guarantee": "…"
}

تتبع عملية الخلط

# Coins sent: check the address now
curl -X POST https://bitcoinmix.io/api/v1/mixes/$MIX_ID/sent

# Follow the mix
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID

# Save the Letter of Guarantee
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID/letter > letter.txt

الحالة	المعنى
`waiting_for_coins`	العنوان المخصص لمرة واحدة بانتظار وصول عملاتك.
`coins_received`	تأكدت العملات على السلسلة. التأخير الذي اخترته قيد التنفيذ.
`processing`	انتهى التأخير. العملات الجديدة في طريقها إلى عنوان الاستلام.
`complete`	وصلت العملات الجديدة إلى عنوان الاستلام.
`below_minimum`	وصل مبلغ أقل من الحد الأدنى، ويُحتفَظ به كتبرع.

العملات والحدود الدنيا والتأكيدات

العملة	الشبكة	الحد الأدنى	التأكيدات
خلاط بيتكوين	شبكة Bitcoin	0.0015 BTC	3
خلاط إيثريوم	شبكة Ethereum الرئيسية	0.05 ETH	12
خلاط BNB	BNB Smart Chain	0.15 BNB	15
خلاط سولانا	شبكة Solana الرئيسية	1 SOL	32

رسوم الخدمة عشوائية لكل عملية خلط، من 2.1% إلى 5%، وتُعاد ضمن الاستجابة عند إنشاء عملية الخلط. يقبل Bitcoin العناوين التي تبدأ بـ 1… أو 3… أو bc1q… أو bc1p…. الشبكة الرئيسية فقط.

الأخطاء

كل خطأ يُعاد بصيغة JSON: { "error": { "code": "…", "message": "…" } }.

HTTP	الرمز	متى يحدث
400	`invalid_coin`	قيمة coin ليست BTC أو ETH أو BNB أو SOL
400	`invalid_address`	عنوان الاستلام غير صالح لتلك العملة
400	`invalid_delay`	قيمة delay_minutes ليست عددًا صحيحًا من 30 إلى 1,200
400	`bad_request`	المحتوى ليس JSON، أو يحتوي على حقل غير معروف، أو ينقصه حقل
404	`not_found`	لا توجد عملية خلط بهذا المعرّف، أو انتهت صلاحية رابطها
429	`rate_limited`	استدعاءات كثيرة جدًا: انتظر المدة المحددة في Retry-After
503	`unavailable`	الخلط متوقف مؤقتًا للحظات: أعد المحاولة بعد قليل

الحفاظ على خصوصية عملية الخلط

معرّف عملية الخلط (mix id) هو المفتاح الوحيد لها. أبقِه بعيدًا عن السجلات والروابط التي تشاركها والشيفرة العامة.
أرسل من عنوان تتحكم فيه، كي تبقى إمكانية الاسترداد قائمة. عناوين منصات التداول يتشاركها كثير من المستخدمين.
احتفظ بخطاب الضمان حتى تكتمل عملية الخلط.

الأسئلة الشائعة حول واجهة API للخلاط

هل تحتاج واجهة API لخلاط العملات المشفرة إلى مفتاح API؟

لا. لا يوجد مفتاح ولا حساب ولا تسجيل. لكل عملية خلط معرّف خاص بها من 64 حرفًا، وهو المفتاح الوحيد لتلك العملية.

ما العملات التي يمكن خلطها عبر واجهة API للخلاط؟

Bitcoin (BTC) وEthereum (ETH) وBNB على BNB Smart Chain وSolana (SOL). تُرسَل كل عملة على شبكتها الخاصة إلى عنوان استلام على الشبكة نفسها.

كم تبلغ تكلفة عملية الخلط عبر واجهة API؟

تُحدَّد رسوم الخدمة عشوائيًا بين 2.1% و5% لكل عملية خلط، وتُعاد عند إنشاء العملية قبل أن ترسل أي شيء. وتُضاف إليها رسوم الشبكة الخاصة بالدفعة الصادرة.

هل يوجد خادم MCP لوكلاء الذكاء الاصطناعي؟

نعم. الإجراءات نفسها متاحة كأدوات MCP عبر Streamable HTTP، فيستطيع وكيل الذكاء الاصطناعي بدء عملية خلط ومتابعتها دون شيفرة مخصصة.