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

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.

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

​
ما هي واجهة برمجة تطبيقات Perps؟

واجهة برمجة تطبيقات Raydium Perps (V1) هي خدمة تكوين وبيانات وصفية لواجهة المستخدم والتكاملات في Raydium Perpetual Futures. توفر:
  • تكوين الواجهة – الإصدار الحالي، دعم الإصدارات الدنيا
  • نقاط نهاية RPC – نقاط نهاية Solana RPC الموثوقة للواجهة
  • إحصائيات السوق – حجم التداول والفائدة المفتوحة على مدى 24 ساعة و7 أيام و30 يومًا
  • القيود الإقليمية – فحوصات التوفر حسب الدولة
  • بيانات Pool – أسواق الـ perp النشطة وبيانات الحجم
  • بيانات الحملات – جدول المتصدرين وإحصائيات المستخدمين والمكافآت
  • مشاركة الأرباح والخسائر – إنشاء لقطات شاشة قابلة للمشاركة للمراكز
مهم: معالجة تقديم الطلبات نفسها يتم بواسطة واجهة برمجة تطبيقات Orderly Network. تركز هذه الخدمة على دعم الواجهة والبيانات الوصفية.

​
نظرة عامة على البنية المعمارية

يتكون نظام Perps من مكونين مستقلين:
  1. واجهة برمجة تطبيقات Raydium Perp (هذه الخدمة) – تقرأ التكوين، توفر بيانات الواجهة، تنشئ الصور
  2. شبكة Orderly – تنفذ الطلبات، تدير المراكز، والتسوية
عند تقديم المستخدم لطلب perp عبر واجهة Raydium:
  1. تجلب الواجهة تكوين السوق من هذه الواجهة البرمجية (المجموعات وRPC والتوفر)
  2. ترسل الواجهة الطلب إلى واجهة برمجة تطبيقات Orderly Network
  3. تنفذ Orderly الطلب وتحافظ على حالة المركز
  4. تسترجع الواجهة بيانات المركز والإحصائيات من واجهة برمجة تطبيقات Orderly أو نقطة نهاية الحملة الخاصة بنا
يسمح هذا الفصل لـ Raydium بإدارة البيانات الوصفية والعلامات التجارية بينما تتولى Orderly المهام الثقيلة لمطابقة الطلبات والتسوية.

​
نقاط نهاية واجهة برمجة التطبيقات حسب الفئة

​
نقاط النهاية الرئيسية

معلومات الخدمة الأساسية وفحوصات التوفر.

​
GET /main/version

يُرجع إصدار الواجهة المستقرة الحالي والإصدار الأقل المدعوم. الاستخدام: تحقق مما إذا كان إصدار الواجهة الخاص بالعميل لا يزال مدعومًا. الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "latest": "1.2.0",
    "least": "1.0.0"
  }
}

​
GET /main/rpcs

يُرجع نقاط نهاية Solana RPC الموثوقة للواجهة للاستخدام. الاستخدام: ملء محدد RPC في الواجهة؛ يضمن توصيل العملاء بنقاط نهاية مستقرة وموثوقة من قبل Raydium.

​
GET /main/info

يُرجع إحصائيات السوق على نطاق واسع. الاستخدام: عرض حجم التداول لمدة 24 ساعة و7 أيام و30 يومًا والفائدة المفتوحة الإجمالية والطويلة والقصيرة على لوحة التحكم. الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "volume": {
      "24h": 1234567,
      "7d": 9876543,
      "30d": 50000000
    },
    "openInterest": {
      "long": 5000000,
      "short": 3000000,
      "all": 8000000
    }
  }
}

​
GET /main/availability-check

يتحقق من توفر تداول perp في منطقة المستخدم الجغرافية. الاستخدام: إصدار تحذير أو تقييد الوصول في المناطق المقيدة (مثل الولايات المتحدة). كيفية العمل:
  • يقرأ رأس cf-ipcountry من Cloudflare (إذا كان خلف Cloudflare)
  • يرجع إلى تكوين افتراضي إذا كان الرأس غائبًا
  • يُرجع حالة التوفر لكل منطقة
الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "available": true,
    "country": "US"
  }
}

​
GET /main/temp-key?wallet=...

ينشئ زوج مفاتيح Ed25519 مؤقتًا للمصادقة الأولية أو التوقيع المؤقت. الاستخدام: إنشاء مفاتيح مؤقتة غير حجوزية لتدفقات المصادقة معينة. الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "key": "ed25519:AAAA..."
  }
}

​
نقاط نهاية Pool

تكوين سوق المشتقات الدائمة.

​
GET /pool/default-list

يُرجع قائمة بأسواق perp الافتراضية مع حجم 24 ساعة و7 أيام و30 يومًا. الاستخدام: ملء محدد السوق أو عنصر واجهة لوحة التحكم بأزواج perp المتاحة. الرد: 
{
  "id": "...",
  "success": true,
  "data": [
    {
      "symbol": "BTC/USDC",
      "volume24h": "1000000",
      "volume7d": "7000000",
      "volume30d": "30000000"
    }
  ]
}

​
نقاط نهاية الحملات

جدول المتصدرين وإحصائيات المستخدمين وبيانات المكافآت.

​
GET /campaign/configs

يُرجع معاملات ومعايير الحملة النشطة. الاستخدام: عرض شروط الحملة ومتطلبات المشاركة في الواجهة.

​
GET /campaign/user?wallet=...&index=0

يُرجع إحصائيات الحملة للمستخدم (الحجم والأرباح والخسائر والنقاط والمكافآت المكتسبة). الاستخدام: العرض في ملف تعريف المستخدم أو لوحة تحكم الحساب. الرد (المستخدم بدون سجل يستخدم البيانات الافتراضية): 
{
  "id": "...",
  "success": true,
  "data": {
    "userInfo": {
      "index": "42",
      "walletAddress": "11111...1111",
      "volume": 500000,
      "pnl": 25000,
      "pnlW": 22500,
      "score": 850,
      "rewards": [...]
    }
  }
}

​
GET /campaign/list?index=0

يُرجع جدول المتصدرين لمؤشر حملة معين (مع التقسيم). الاستخدام: عرض أفضل المتداولين والترتيبات. الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "updateTime": 1699999999000,
    "rows": [
      {
        "rank": 1,
        "wallet": "11111...1111",
        "volume": 5000000,
        "pnl": 250000,
        "score": 9500
      }
    ]
  }
}

​
نقاط نهاية المشاركة

إنشاء لقطات شاشة قابلة للمشاركة للمراكز.

​
POST /share/position

ينشئ صورة قابلة للمشاركة لمركز perp الحالي للمستخدم. الاستخدام: المشاركة الاجتماعية (تويتر، Discord) للمراكز الحية. الطلب: 
{
  "symbol": "BTC/USDC",
  "side": "long",
  "size": "0.5",
  "entryPrice": "45000",
  "markPrice": "46000",
  "pnl": "500",
  "leverage": "5x"
}
الرد: 
{
  "id": "...",
  "success": true,
  "data": {
    "imgFileName": "abc123def456",
    "msg": "Position image generated"
  }
}

​
POST /share/history-position

ينشئ صورة قابلة للمشاركة لمركز مغلق مع الأرباح والخسائر المحققة. الاستخدام: مشاركة التجارات المغلقة مع تفاصيل الربح والخسارة. الطلب: 
{
  "symbol": "ETH/USDC",
  "side": "short",
  "size": "10",
  "entryPrice": "2500",
  "exitPrice": "2450",
  "realizedPnl": "500"
}
الرد: نفس /share/position.

​
غلاف الرد

جميع نقاط النهاية ترجع غلافًا قياسيًا: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": true,
  "data": { ... }
}
في حالة الخطأ: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "success": false,
  "msg": "Error message or code"
}

​
التخزين المؤقت

تُرجع معظم نقاط النهاية رأس cache-control: max-age=60، مما يعني:
  • يتم تخزين النتائج مؤقتًا من جهة الخادم وتحديثها كل 60 ثانية
  • يمكن للعملاء أيضًا التخزين المؤقت لمدة 60 ثانية لتقليل الحمل
  • لا يتم ضمان البيانات في الوقت الفعلي؛ توقع تأخير يتراوح بين 0 و60 ثانية

​
التوفر الإقليمي

يتم معالجة القيود الإقليمية عبر رأس cf-ipcountry (Cloudflare). يتم تكوين المناطق المدعومة والقيود من جهة الخادم وتحديثها بشكل دوري.

​
نقاط نهاية الشبكة

البيئةالمضيف
الإنتاجapi-perp-v1.raydium.io
لا توجد نسخة devnet؛ تداول perp للشبكة الرئيسية فقط.

​
التكامل مع شبكة Orderly

لتقديم طلب:
  1. استدعِ /campaign/user أو /main/info لجلب البيانات الوصفية وعرضها للمستخدم
  2. أرسل الطلب إلى واجهة برمجة تطبيقات Orderly Network (وليس هذه الواجهة)
  3. تُرجع Orderly تأكيد التجارة وحالة المركز
  4. استدعِ /campaign/user مرة أخرى لاحقًا لرؤية الإحصائيات المحدثة
واجهة برمجة تطبيقات perp من Raydium لا تتعامل مع تقديم الطلبات؛ فهي للقراءة فقط البيانات الوصفية والتكوين.

​
انظر أيضًا