هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
Raydium Perps هو نشر بعلامة بيضاء على شبكة Orderly Network. دفتر الطلبات، محرك المطابقة، وحالة الحساب كلها توجد على Orderly. Raydium SDK v2 (
@raydium-io/raydium-sdk-v2) لا يغطي perps — للوصول البرمجي، استخدم واجهة برمجة تطبيقات Orderly REST + WebSocket مباشرة. تعرض المقاطع أدناه التدفقات الأكثر شيوعًا؛ المرجع المعتمد موجود في orderly.network/docs.لافتة الإصدار.
- الواجهة الخلفية: Orderly Network REST + WebSocket API
- تم التحقق من مخطط المقطع مقابل واجهة برمجة تطبيقات Orderly اعتبارًا من 2026-04
- مجموعة Solana للإيداعات على السلسلة:
mainnet-beta - التوقيع: Solana ed25519 على حمولة Orderly بنمط EIP-712 (Orderly يستخدم مخطط EIP-712 حتى للسلاسل غير EVM؛ راجع مستندات Orderly للحصول على قائمة الحقول الأحدث)
ما يوجد في هذه الصفحة
تغطي التدفقات أدناه دورة الحياة ذات الصلة بالمدمج:- إعداد الحساب — إيداع USDC وتسجيل الحساب مع Orderly.
- استدعاءات REST المصرح بها — طلب التوقيع لوضع الطلبات والإلغاء واستعلامات الحساب.
- التداول — وضع أوامر السوق/الحد، الإلغاء، جلب المراكز والتعبئات.
- بيانات السوق — الاشتراك في orderbook وتجارة WebSocket.
- السحب — بدء سحب إلى المحفظة.
@solana/web3.js وtweetnacl لتوقيع Ed25519. إنها نقاط انطلاق — سطح واجهة برمجة تطبيقات Orderly واسع ويتغير بسرعة أكثر من هذه الصفحة؛ تحقق دائمًا من مستندات Orderly المباشرة قبل شحن كود الإنتاج.
الإعداد
تسجيل الحساب
قبل وضع أي طلبات، سجل المحفظة مع Orderly:(broker_id, wallet_address) — التسجيل بالتفاعل معها. إذا كانت المحفظة قد سجلت بالفعل مع وسيط Raydium، فستُرجع الاستدعاء معرف الحساب نفسه دون إنشاء حساب جديد.
إيداع USDC
تنقل الودائع USDC من ATA المحفظة إلى خزانة تسوية Orderly. إنها معاملات Solana على السلسلة:/v1/client/holding للتأكد:
orderlyAuthGet معرفة أدناه — كل استدعاء مصرح به يمر عبره.)
مساعد طلب التوقيع
يحمل كل استدعاء REST مصرح به لـ Orderly توقيع Ed25519 على(timestamp + method + path + body):
timestamp التي تبعد أكثر من 5 ثواني عن ساعة الخادم. قم بمزامنة ساعتك (NTP) وتجنب توقيع الطلبات مقدمًا.
وضع أمر السوق
order_id الناتج بالإضافة إلى الحالة. تأتي التعبئات عبر WebSocket (راجع أدناه)؛ الاستجابة REST نفسها لا تمنع التنفيذ حتى يتم ملؤها بالكامل.
وضع أمر حد مع Post-Only
IOC / FOK، اضبط time_in_force: "IOC" أو "FOK". راجع products/perps/order-types لمعاني كل علم.
إلغاء أمر
/v1/orders أو مراقبة WebSocket — افتراض نجاح الإلغاء دون تأكيد يمكن أن يؤدي إلى مراكز مكررة أو غير مقصودة.
جلب المراكز المفتوحة
position_qty هي صفقة بيع قصيرة، الموجبة هي صفقة شراء طويلة. position_qty == 0 تعني أن المركز مغلق لكن الصف قد يظهر حتى التنظيف التالي.
جلب سجل التعبئات
page وsize للترقيم.
WebSocket: بيانات السوق
subscribe موقّعة بنفس طريقة طلبات REST، محددة لمعرف حسابك. مستندات Orderly لها شكل الحمولة الدقيق؛ يتغير أحيانًا، لذا لا تقوم بترميز مخطط معين هنا.
سحب USDC
products/perps/fees). ينجز التحويل على السلسلة في غضون 1-2 دقيقة في ظروف عادية؛ توقع وقتًا أطول أثناء الازدحام.
الأخطاء الشائعة
- لا تعيد استخدام مفتاح التداول عبر البيئات. مفتاح Orderly للتداول المسجل الفردي مقابل محفظتك مرتبط بحساب Solana mainnet واحد. إذا كنت تحتاج أيضًا إلى devnet أو staging، قم بإنشاء مفتاح منفصل لكل منهما.
- مزامنة الوقت. تحمل ساعة Orderly تفاوتًا قريبًا (±5 ثانية). على الخدمات طويلة التشغيل، سيؤدي انجراف NTP في النهاية إلى تعطيل التوقيع. أعد المزامنة بشكل دوري.
- إعادة اتصالات WebSocket. تحذف WS العامة أحيانًا الاتصالات أثناء ترقيات Orderly. قم بتنفيذ backoff أسي وأعد الاشتراك عند إعادة الفتح.
- حدود المعدل. يتم تحديد استدعاءات REST بمعدل تدرج لكل حساب. ألغِ بشكل مجموعي عبر
cancel_allبدلاً من حلقةcancel-by-id عندما يكون لديك > 5 طلبات للإلغاء. - اتجاه المركز ضمني. أمر
BUYعلىPERP_SOL_USDCيفتح أو يمدد صفقة شراء طويلة؛SELLيفتح أو يمدد صفقة بيع قصيرة — لكن إذا كنت طويلاً بالفعل، فإنSELLيقلل (وقد يقلب) المركز لأن Raydium Perps في نمط اتجاه واحد. تحقق دائمًا من المركز الحالي قبل وضع أمر إذا كان الاتجاه مهمًا. - التمويل والتصفيات منفصلة عن تدفق الطلبات. تظهر مدفوعات التمويل والتصفيات كتدفقات أحداث منفصلة؛ إنها ليست “طلبات”. اشترك في مواضيع WS الخاصة ذات الصلة إذا كنت بحاجة إلى ملاحظتها.
ما يجب فعله بعد ذلك
products/perps/trading-basics— الكتيب المفاهيمي على ميكانيكا العقود الأبدية.products/perps/order-types— معاني كل نوع طلب وعلم.products/perps/collateral— أصول الضمان المدعومة وحدود كل سلسلة.products/perps/fees— جداول maker/taker ورسم السحب.
- توثيق مطور Orderly Network — المرجع المعتمد لسطح الواجهة البرمجية المستخدم أعلاه. يستهلك Raydium Perps هذا مباشرة.
- Orderly TypeScript SDK — يغلف نفس طبقة REST/WebSocket بمساعدات مكتوبة؛ مفيد إذا كنت تريد تخطي كتابة طبقة التوقيع بنفسك.

