الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

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

​
ما هو Raydium API v3؟

يوفر Raydium API v3 واجهة REST للاستعلام عن حمامات السيولة وبيانات الرموز والمزارع والإحصائيات على منصات التداول التابعة لـ Raydium على Solana. يستخدمه المحافظ والمجمعات والموجهات الآلية والمتاجرون للحصول على بيانات حمامات موثوقة وتغذيات الأسعار والتحليلات التاريخية. تم تصميم API لمعالجة إنتاجية عالية — عادة ما تكون الاستجابات بتأخير 1-5 دقائق حسب حساسية نقطة النهاية. يتم لف جميع الاستجابات في غلاف متسق يتضمن البيانات الوصفية.

​
خوادم الأساس

البيئةURL
Mainnethttps://api-v3.raydium.io
Devnethttps://api-v3-devnet.raydium.io

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

تُرجع جميع نقاط النهاية غلافًا من JSON يتضمن بيانات وصفية للطلب والحمولة:

​
استجابة ناجحة

{
  "id": "abc123def456",
  "success": true,
  "data": {
    // Endpoint-specific data
  }
}

​
استجابة خطأ

{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
حقل id هو معرّف طلب فريد (UUID). تحقق دائمًا من success قبل معالجة data.

​
المشاكل الشائعة

​
ترتيب زوج الرمز على /pools/info/mint

عند الاستعلام عن /pools/info/mint?mint1=ABC&mint2=XYZ، توحّد نقطة النهاية الزوج داخليًا بترتيب الرموز أبجديًا. إذا كنت بحاجة للبحث عن رمز واحد، فحذف mint2 تمامًا — سيجد API جميع الحمامات التي تتضمن هذا الرمز.

​
قيم مرشح نوع الحمام

تقبل معاملة الاستعلام poolType قيمًا محددة:
  • all — جميع أنواع الحمامات
  • concentrated — حمامات CLMM فقط
  • standard — حمامات AMM (منتج ثابت) فقط
  • allFarm — حمامات بها مزرعة واحدة على الأقل نشطة
  • concentratedFarm — حمامات مركزة بها مزارع
  • standardFarm — حمامات قياسية بها مزارع
سيتم رفض الأخطاء الإملائية أو عدم تطابق حالة الأحرف.

​
قيم حقل ترتيب الحمام

قيم poolSortField الصحيحة هي:
  • default (يرتب حسب حجم 24 ساعة)
  • liquidity (TVL)
  • volume24h و volume7d و volume30d
  • fee24h و fee7d و fee30d
  • apr24h و apr7d و apr30d

​
الترقيم مع /pools/info/list-v2

يستخدم إصدار v2 الترقيم المستند إلى المؤشر عبر nextPageId. يتم إرجاع الرمز المعتم في الاستجابة ويجب تمريره حرفيًا. لا تحاول إنشاء مؤشر خاص بك — فهو يرمز حالة Elasticsearch.

​
الحدود الافتراضية والحدود القصوى لحجم الصفحة

  • /pools/info/list و /pools/info/mint يحددان pageSize بـ 1000 كحد أقصى.
  • /farms/info/lp يحدد pageSize بـ 100 كحد أقصى.
  • /pools/info/list-v2 يحدد size بـ 1000 كحد أقصى.
يتم رفض الطلبات التي تتجاوز الحدود برسالة خطأ.

​
تكوينات CLMM للرسوم الديناميكية وأوامر الحد

تكشف نقطتا نهاية جديدتان عن بيانات المعايرة لتدفق CreateCustomizablePool في CLMM:
  • GET /main/clmm-dynamic-config — قائمة مستويات DynamicFeeConfig (فترة التصفية، فترة الانحطاط، عامل التقليل، الحد الأقصى للبسط، عنصر تحكم الرسم الديناميكي). مرّر id واحد من هذه عند إنشاء createCustomizablePool مع enableDynamicFee=true.
  • GET /main/clmm-limit-order-config — تكوين أوامر الحد لكل حمام: ما إذا كانت أوامر الحد مفعلة والحد الأدنى من مبلغ الإدخال وحارس limit_order_admin خارج السلسلة المصرح به بتسوية الطلبات المملوءة.
بيانات أوامر الحد لكل محفظة (مفتوح / ممتلأ / مغلق) توجد على Temp API؛ انظر api-reference/temp-api-v1/overview.

​
الوثائق ذات الصلة

​
مثال على الاستخدام

الحصول على الإحصائيات الرئيسية: 
curl -s https://api-v3.raydium.io/main/info | jq .
عرض أفضل 10 حمامات حسب TVL: 
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
الحصول على حمامات SOL-USDC: 
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
الحصول على أسعار الرموز: 
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
الحصول على حمامات المزرعة لرمز LP: 
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .

​
الحالة والتوفر

Raydium API v3 نشط على mainnet. لمراقبة التوفر والحوادث، تابع @Raydium.