سطح REST API

نظرة عامة على مستوى عالٍ من خدمات Raydium الأحد عشرة العامة — ما يفعله كل منها، والاتفاقيات المشتركة بينها (غلاف الاستجابة، المصادقة، حدود المعدل، التخزين المؤقت)، وكيفية اختيار الخدمة الصحيحة للتكامل.

هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.

عرض النسخة الإنجليزية →

توثيق مستوى النقاط النهائية موجود في علامة التبويب API Reference. لكل نقطة نهاية هناك لوحة جرّب الآن تفاعلية مدعومة من ملعب OpenAPI في Mintlify — املأ المعاملات في المتصفح واضغط مباشرة على الشبكة الرئيسية (أو devnet، حيث يكون متاحًا). هذه الصفحة هي رفيق سردي: ما هي الخدمات الموجودة، متى تستخدم أيًا منها، والاتفاقيات التي تمتد على جميعها. إذا كنت تبحث عن “ما الذي يقبله GET /pools/info/ids”، انقر فوق API Reference؛ إذا كنت تبحث عن “أي خدمة يجب أن أدمجها”، فتابع القراءة.

​

الخدمات الأحد عشرة في لمحة

تشغل Raydium إحدى عشرة خدمة HTTP عامة. يتم توثيق كل منها كمجموعة خاصة بها في علامة التبويب API Reference وتحتوي على مواصفات OpenAPI تدعم ملعب التفاعل.

الخدمة	مضيف الشبكة الرئيسية	مضيف Devnet	ما تخدمه
API v3	api-v3.raydium.io	api-v3-devnet.raydium.io	واجهة برمجية قراءة كنسخة أساسية لمعلومات التجمع / الرمز / الإعداد / معلومات السلسلة. بوابة الوصول الافتراضية للواجهة الأمامية ومعظم المدمجين.
Transaction API	transaction-v1.raydium.io	transaction-v1-devnet.raydium.io	بناء معاملة المبادلة من جانب الخادم.
Perps API	api-perp-v1.raydium.io	—	الإعدادات وبيانات أوصاف الأصول واختيار RPC لواجهة Raydium Perps الأمامية.
LaunchLab Mint API	launch-mint-v1.raydium.io	launch-mint-v1-devnet.raydium.io	البحث عن الرموز والفهارس والقوائم والبيانات الوصفية لكل رمز.
LaunchLab History API	launch-history-v1.raydium.io	launch-history-v1-devnet.raydium.io	سجل التداول وتجميعات k-line OHLC لتجمعات LaunchLab.
LaunchLab Forum API	launch-forum-v1.raydium.io	launch-forum-v1-devnet.raydium.io	خيوط التعليقات وتحميلات IPFS على عمليات إطلاق LaunchLab. موقعة بالمحفظة.
LaunchLab Auth API	launch-auth-v1.raydium.io	launch-auth-v1-devnet.raydium.io	إصدار ray-token JWTs قصيرة الأجل من رسالة موقعة بالمحفظة. مطلوبة من قبل Forum.
Dynamic IPFS API	dynamic-ipfs.raydium.io	dynamic-ipfs-devnet.raydium.io	إعادة توليد الصور والبيانات الوصفية لـ NFTs الديناميكية (مواضع CLMM، وما إلى ذلك).
Owner API	owner-v1.raydium.io	owner-v1-devnet.raydium.io	مواضع لكل محفظة وأرصدة ومكافآت قابلة للمطالبة.
API v1 (legacy)	api.raydium.io	—	مسارات /v1 و /v2 القديمة المبقاة حية للعملاء الذين لم ينتقلوا إلى API v3.
Temp API	temp-api-v1.raydium.io	temp-api-v1-devnet.raydium.io	قلم الانتظار للنقاط النهائية المخصصة قصيرة الأجل. يمكن تغيير السطح بدون إشعار.

الإصدار يعيش في اسم المضيف لخدمات v3 / v1 — لا يوجد إصدار إضافي على مستوى المسار. التغييرات الجذرية يتم شحنها كمضيف جديد مع تداخل؛ التزمت الفريق علنًا بما لا يقل عن 6 أشهر من التداخل على أي ترحيل v3 → v4.

​

اختر خدمة

إذا كنت تريد…	استخدم
قراءة بيانات التجمع الوصفية والأسعار والعائدات السنوية وإعدادات الرسوم	API v3
قراءة بيانات الرمز الوصفية (الاسم والرمز والشعار والعشرات والعلامات الخطرة)	API v3 /mint/list, /mint/price
بناء معاملة المبادلة / إضافة السيولة / إزالة السيولة من جانب الخادم	Transaction API
عرض مواضع محفظة (رموز LP، مواضع CLMM، حصص المزرعة)	Owner API
البحث عن رموز LaunchLab وتصفح القوائم وجلب البيانات الوصفية لكل رمز	LaunchLab Mint API
عرض مخطط k-line / شمعة لتجمع LaunchLab	LaunchLab History API
نشر أو قراءة التعليقات على عملية إطلاق LaunchLab	LaunchLab Auth API → ray-token → LaunchLab Forum API
عرض صورة NFT لمواضع CLMM	Dynamic IPFS API
عرض إعدادات سوق العقود الآجلة أو قوائم الأصول لواجهة Perps	Perps API
الحفاظ على التوافق مع عميل بادئة مسار v1/v2	API v1 (legacy)

​

الاتفاقيات الشاملة

​

غلاف الاستجابة

تعيد كل خدمة ما عدا IPFS نفس غلاف JSON:

{
  "id":      "uuid-v4-per-request",
  "success": true,
  "data":    { ... }
}

عند الفشل:

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "human-readable error string",
  "data":    null
}

تتضمن بعض الخدمات بالإضافة إلى ذلك عددًا صحيحًا error.code (يستخدم API v3 هذا لمعرّفات الأخطاء المستقرة عبر الإصدارات الصغيرة). راجع صفحة نظرة عامة على كل خدمة للحصول على الشكل الدقيق.

​

المصادقة

يظهر نمطان:

• بدون مصادقة — كل خدمة ما عدا Forum. اضربهم بشكل مجهول عبر HTTPS.
• مصافحة موقعة بالمحفظة — مطلوبة من قبل LaunchLab Forum API. وقّع رسالة Solana ed25519 بالشكل time:<unix-seconds> بمحفظتك، وأرسل التوقيع وعنوان المحفظة إلى LaunchLab Auth API /request-token، واستقبل JWT، وأمرره كرأس طلب ray-token على استدعاءات المنتدى اللاحقة.

يقبل ملعب Mintlify ray-token في لوحة المصادقة قبل إرسال طلبات المنتدى؛ يتم الاحتفاظ بالقيمة في متصفحك فقط.

​

حدود المعدل

تجلس جميع المضيفات خلف Cloudflare مع تحديد معدل تقدمي لكل عنوان IP مصدر. إرشادات منشورة للمدمجين:

الانفجارات فوق الحدود المنشورة ترجع HTTP 429 مع رأس Retry-After. المجمعات أو الروبوتات التي تحتاج إلى حدود أعلى يجب أن تتصل بفريق Raydium بدلاً من ضرب المضيفات العامة — تشغيل الفهرسة الخاصة بك مقابل معرفات البرنامج الموجودة على السلسلة هو أيضًا خيار لأعباء العمل الثقيلة في القراءة.

​

التخزين المؤقت والاتساق

• معظم نقاط نهاية قراءة API v3 مخزنة مؤقتًا على الحافة لمدة 5-60 ثانية؛ TTLs محددة موضحة على صفحة API Reference لكل نقطة نهاية.
• يتم إبطال الذاكرة المؤقتة من قبل الفهرس على أحداث برنامج لمس يلاحظها.
• أثناء إعادة الهيكلة الكبيرة أو الازدحام، قد يكون هناك تباعد 1-2 slot بين عرض API وحالة السلسلة. SDK وقراءات RPC المباشرة دائمًا أكثر حداثة — إذا كان العميل على وشك توقيع معاملة، أعد جلب الحسابات ذات الصلة عبر RPC، لا تثق بقيمة API بشكل أعمى أبدًا.

​

تنسيق الخطأ

تعود الأخطاء كـ HTTP 4xx/5xx مع نفس الغلاف (success: false، msg مملوء). API v3 بالإضافة إلى ذلك يتضمن error.code مستقر:

{
  "id":      "uuid-v4-per-request",
  "success": false,
  "msg":     "Pool not found",
  "error":   { "code": 40401, "message": "Pool not found" }
}

error.code مستقر عبر الإصدارات الصغيرة؛ عامله كإشارة أساسية في منطق العميل و msg كسطح يمكن قراءته من قبل الإنسان.

​

اتفاقية معامل mint-pair

العديد من نقاط نهاية API v3 تقبل mint1=…&mint2=… وتتطلب mint1 < mint2 (ترتيب بايت pubkey تصاعدي). هذا حتى تتمكن API من إرجاع نفس التجمع الأساسي بغض النظر عن ترتيب حجة المتصل المفضل. رتّب الرمزين من جانب العميل قبل بناء URL — تكرر توثيق مستوى النقطة النهاية هذا القيد حيث ينطبق.

​

أنماط العميل الموصى بها

1. ملء مرة واحدة، تحديث بكسل. اسحب GET /main/info و GET /mint/list (كلاهما على API v3) في تحميل التطبيق وخزّن مؤقتًا محليًا مع TTL بساعة واحدة. كلاهما مخزن مؤقت بشكل كبير على الحافة ونادرًا ما يتغير.
2. الكميات حيث تسمح النقطة النهاية. GET /pools/info/ids?ids=… يقبل قائمة مفصولة بفواصل — اجلب عشرة تجمعات في طلب واحد، وليس عشرة طلبات.
3. تجنب عمليات جلب السعر على المسار الساخن. GET /mint/price جيد لعرض الواجهة؛ لا تحلقها أبدًا في بوت. للروبوتات التجارية، قم بتشغيل الفهرس أو اشترك في أحداث programSubscribe RPC مباشرة.
4. المرآة أو الوكيل لإنتاجية عالية. أي شيء فوق سقف حد المعدل المنشور يجب أن يتم تقديمه من طبقة الذاكرة المؤقتة الخاصة بك، وليس مباشرة من المضيفات العامة. المجمعات ذات >120 req/min المستمرة ضد transaction-v1 يجب أن تشغل محرك الاقتباس / الأسار الخاص بها.
5. أعد الجلب قبل التوقيع مباشرة. استجابات API يمكن أن تكون قديمة 5-60 ثانية. للحصول على لقطة تجمع صحيحة فعلاً في وقت التوقيع، أعد قراءة الحسابات ذات الصلة عبر SDK أو اتصال RPC مباشر getMultipleAccounts. تعامل مع قيم API كتلميح بحث، وليس كمصدر تسوية.
6. استخدم Transaction API للتكامل منخفض الاحتكاك. إذا كنت لا تريد تجميع SDK في عميلك (أصلي محمول، بوت في بيئة مقيدة)، فسيعود Transaction API معاملة موضوعة بـ base64 الإصدار للمستخدم للتوقيع عليها. swapResponse الذي يعيده يضمن عرضًا — تعامل معه كصالح لحوالي 30 ثانية.

​

أين تذهب بعد ذلك

• مرجع النقطة النهاية (تفاعلي) — API Reference. كل خدمة لها مجموعتها الخاصة؛ انقر فوق أي نقطة نهاية للمعاملات وشكل الاستجابة وعينات الكود ولوحة جرّب الآن.
• TypeScript SDK — sdk-api/typescript-sdk. يستهلك SDK API v3 داخليًا لعدة مسارات؛ لبناء المعاملات يعيد جلب الحالة من RPC دائمًا، لا يثق بـ API بشكل أعمى.
• تكامل Trade API — integration-guides/aggregator. أنماط لربط سيولة Raydium في مجمع متعدد DEX.
• الوثائق الملائمة للذكاء الاصطناعي — sdk-api/ai-integration. مؤشرات لعملاء الكود بالذكاء الاصطناعي الذين يحتاجون إلى استدعاء هذه الواجهات البرمجية.