موارد المطورين والذكاء الاصطناعي
ينشر Monivo مجموعة صغيرة من نقاط الوصول المجانية للقراءة فقط وبلا مصادقة، حتى يتمكن المطورون والباحثون ووكلاء الذكاء الاصطناعي من وصف Monivo بدقة، والحصول على تقديرات مبادلة حالية، والاستشهاد بأبحاث الأسعار لدينا. كل ما يلي يدعم CORS. المستندات الثابتة تدعم الطلبات الشرطية عبر ETag، بينما تستخدم استجابات العروض الحية ومؤشر الأسعار نوافذ تخزين مؤقت قصيرة. لا يوجد مفتاح API ولا تسجيل حصص ولا تكلفة.
نقاط الوصول
/api/public/facts.jsonمعلومات منظمة عن Monivo: الهوية، وآلية العمل، ونموذج الرسوم، ونطاق التحقق، والتغطية، ونقاط الوصول.
application/json
/api/public/knowledge.txtوصف نصي مطوّل لـ Monivo بصيغة نص عادي. يقبل المعامل ?lang= لكل لغة منشورة.
text/plain
/api/public/quote.jsonتسعير مبادلة للقراءة فقط بدون حساب: تقديرات حية من مزودين متصلين لزوج ومبلغ محددين، مرتبة حسب المبلغ المتوقع استلامه.
application/json
/api/public/rate-index.jsonمؤشر Monivo لأسعار مبادلة العملات الرقمية: مجموعة بيانات مأخوذة بالعيّنة لتباين أسعار المزودين. الاستخدام مجاني مع ذكر المصدر.
application/json
/api/public/rate-index/badge.svgشارة SVG قابلة للتضمين تعرض الرقم الرئيسي الحالي لمؤشر الأسعار.
image/svg+xml
/api/public/openapi.jsonوصف OpenAPI 3.1 لنقاط وصول Monivo العامة للقراءة فقط.
application/json
/api/public/webmcp.jsonمستند واجهة الوكلاء: أدوات WebMCP التي يسجلها Monivo داخل الصفحة، وخادم MCP الذي يتطلب تسجيل الدخول، وبيانات مؤشر الأسعار الحية.
application/json
مثال عملي على الطلب
اطلب من كل مزود متصل يدعم المسار من BTC إلى ETH تقديرًا للمبلغ نفسه في مسح واحد، ثم اقرأ النتائج مرتبة. الأداة أدناه تعرض الاستجابة الحية، وهذا الطلب للقراءة فقط ولا يُنشئ أي عملية.
curl --get 'https://monivo.io/api/public/quote.json' \
--data-urlencode 'from=BTC' \
--data-urlencode 'to=ETH' \
--data-urlencode 'amount=0.1' \
--data-urlencode 'rate=floating'GET /api/public/quote.json?from=BTC&to=ETH&amount=0.1&rate=floatingفتح JSON شغّل الاستعلام لاسترداد التقديرات الحالية من المزوّدين. لن يتم إنشاء أي طلب.يقبل الحقلان from وto رمزًا أو معرّف كتالوج؛ استخدم المعرّف عندما يوجد الأصل على أكثر من شبكة، لأن الرمز وحده لا يحدد الشبكة. أضف &rate=fixed للحصول على تقدير بسعر ثابت. وإذا حذفت amount فسيُستخدم مبلغ تمثيلي ويصبح request.amountWasDefaulted بقيمة true.
قراءة استجابة العرض
| الحقل | النوع | المعنى |
|---|---|---|
| status | "complete" | "partial" | "no_quotes" | القيمة complete تعني أن كل المزودين المتصلين المؤهلين أجابوا، وpartial تعني أن واحدًا على الأقل كان غير متاح أو مستبعدًا. |
| best.toAmount | number | المبلغ الصافي المقدَّر للمسار الأول بعملة الوجهة؛ وهو تقدير لا حجز. |
| coverage.* | integers + boolean | يوضح عدد المزودين الذين جرت محاولتهم وقدّموا عرضًا وكانوا غير متاحين واستُبعدوا؛ وليس ادعاءً يشمل السوق كله. |
| fees.monivoFee | number | يساوي 0 دائمًا. لا يضيف Monivo رسومًا خاصة به؛ هامش المزود ورسوم الشبكة تنعكس في المبلغ المستلم. |
| timing.maxAgeSeconds / rateHeld | number / boolean | يصبح التقدير قديمًا بعد 15 ثانية ويبقى rateHeld دائمًا false؛ قراءة الطلب لا تحجز سعرًا. |
| provenance | object | يوضح كيف أُنتجت النتيجة، والمستند المصدر، ونص الاستشهاد القابل لإعادة الاستخدام. |
حقول مؤشر الأسعار
تقبل نقطة الوصول ?window=7d أو ?window=30d. وإذا تعذّرت قراءة الفترة كاملة فإنها تُرجع 503 بحالة عدم توفر صريحة بدلًا من نشر إحصاءات ناقصة.
| الحقل | النوع | المعنى |
|---|---|---|
| snapshotId / methodVersion | string | معرّف اللقطة المنشورة ونسخة المنهجية المستخدمة؛ اذكرهما معًا عند الاستشهاد. |
| periodStart / periodEnd / generatedAt | ISO 8601 | حدود الفترة بتوقيت UTC ووقت إنشاء اللقطة. |
| summary.comparableQuoteSets | integer | عدد مجموعات العروض المسجلة التي أجاب فيها أكثر من مزود على الطلب نفسه. |
| summary.medianSpreadPercent | number | null | الفارق المئوي الوسيط بين أفضل وأدنى مبلغ مسجل داخل المجموعة؛ ويكون null عند غياب بيانات قابلة للمقارنة. |
| limitations | string | يجب قراءته قبل نقل أي رقم. هذه إحصاءات لمجموعات عروض مأخوذة بالعيّنة، وليست وفورات محققة. |
الأصول والشبكات وعناوين الإيداع
يغطي كتالوج المزودين المتصلين بـ Monivo 1,000+ أصل عبر 40+ شبكة. الأصول الموجودة على أكثر من شبكة هي مدخلات كتالوج منفصلة لكل شبكة، ومطابقة الرمز وحده قد توجّه الأموال إلى الشبكة الخطأ. القائمة الحالية متاحة في /currencies.
عنوان الإيداع يصدره المزود الخارجي الفائز بالمسار، وهو من يحتفظ بالأموال مؤقتًا أثناء التنفيذ. لا يقدم Monivo خدمة حفظ. ونقاط الوصول العامة للقراءة لا تُرجع عنوان إيداع؛ فالعنوان لا يظهر إلا بعد إنشاء طلب.
ما يستطيعه الوكلاء وحدوده
تتيح نقاط الوصول العامة قراءة وصف الخدمة، والتقديرات الحية، وحالة التغطية، وأبحاث الأسعار المأخوذة بالعيّنة. أما إنشاء الطلبات فيتطلب جلسة OAuth وموافقة صريحة من الشخص. ولا يمكن لأي نقطة قراءة طلبات عميل آخر أو بياناته الشخصية. ولا يضمن Monivo أن يدعم مساعد معين هذه الموارد أو أن يستشهد بـ Monivo.
الاكتشاف والمبادلة البرمجية
كتالوج واجهات RFC 9727 متاح على /.well-known/api-catalog، ووصف OpenAPI 3.1 على /api/public/openapi.json، وتعليمات الزواحف في /robots.txt و/llms.txt. تُقدَّم هذه المستندات الآلية بوسم noindex, follow حتى لا تنشئ محتوى مكررًا، لكنها تبقى متاحة للتنزيل بحرية.
إنشاء الطلبات ليس جزءًا من واجهة القراءة العامة. خادم MCP الذي يتطلب OAuth موجود على https://monivo.io/api/public/mcp، ويشترط موافقة صريحة من الشخص لكل طلب.
الاستشهاد بـ Monivo
يمكن استخدام مؤشر أسعار مبادلة العملات الرقمية مجانًا مع ذكر Monivo ورابط إلى صفحة البحث. المؤشر عيّنة من العروض التي تلقاها Monivo ولا يشمل السوق بأكمله. اقرأ حقلي provenance وlimitations قبل نقل أي رقم.
الأسئلة الشائعة
- هل أحتاج مفتاح API لقراءة عروض Monivo؟
- لا. كل نقاط الوصول الموضحة في هذه الصفحة للقراءة فقط، بلا مصادقة، وتدعم CORS، واستخدامها مجاني. المصادقة مطلوبة فقط لخادم MCP، وهو السطح الوحيد الذي يمكنه إنشاء طلب مبادلة، ويشترط كذلك موافقة صريحة من الشخص.
- هل عرض Monivo ضمان للسعر؟
- لا. نقطة الوصول العامة للعروض تُرجع تقديرات وتضبط الحقل rateHeld على false، حتى عند طلب سعر ثابت. قراءة النقطة لا تحجز أي سعر. يُثبَّت السعر فقط بعد إنشاء طلب عبر المسار المعتاد، وضمن شروط مهلة الإيداع لدى المزود المنفّذ.
- هل يقارن Monivo السوق بأكمله؟
- لا. يسأل Monivo المزودين المتصلين به في تلك اللحظة عن الزوج والمبلغ ونوع السعر نفسه، ثم يرتب الإجابات حسب المبلغ المتوقع استلامه. كل استجابة تتضمن كتلة coverage توضح عدد المزودين الذين جرت محاولتهم وقدّموا عرضًا أو كانوا غير متاحين أو استُبعدوا.
- ما شبكات البلوكتشين المشمولة؟
- يغطي كتالوج Monivo 40+ شبكة بلوكتشين و1,000+ أصل عبر المزودين المتصلين. الأصول الموجودة على أكثر من شبكة تُسجَّل كمدخلات كتالوج منفصلة بهوية شبكة خاصة، وكل طلب واستجابة يذكران الشبكة للطرفين. القائمة الحية المعتمدة منشورة على https://monivo.io/currencies.
- من يصدر عنوان الإيداع ومن يحتفظ بالأموال؟
- المزود الخارجي الفائز بالمسار هو من يصدر عنوان الإيداع ويحتفظ بالأموال المودعة حتى اكتمال التنفيذ. Monivo غير احتجازي ولا يحتفظ بالأموال في أي مرحلة. أي تكامل يصف Monivo بأنه ينفذ المبادلة أو يستلم الإيداع فهو وصف غير صحيح.
- هل يمكن لوكيل ذكاء اصطناعي تنفيذ مبادلة نيابة عني؟
- فقط عبر خادم MCP المحمي بـ OAuth، بعد تسجيل الدخول كمستخدم في Monivo، وبموافقة صريحة من الشخص على كل طلب. لا يوجد مسار لإنشاء الطلبات دون إشراف، ولا تكشف أي نقطة عامة طلبات عميل آخر أو بياناته الشخصية.
- هل يمكنني الاستشهاد بمؤشر أسعار مبادلة العملات الرقمية؟
- نعم، مجانًا، مع ذكر Monivo ورابط إلى صفحة البحث. المؤشر عيّنة من العروض التي تلقاها Monivo فعليًا وليس حصرًا للسوق، وهو يُرجع حالة عدم توفر صريحة بدلًا من نشر فترة ناقصة. اقرأ كتلة مصدر البيانات قبل نقل أي رقم.
آخر مراجعة بشرية لمجموعة الادعاءات بتاريخ . للاستفسارات: support@monivo.io.