نعم، عبر واجهة API العامة
نعم: تنشر Hyperliquid واجهة تداولها كلها واجهة HTTP عامة، وهي نفسها التي تستعملها الواجهة على الويب. فالقراءة لا تحتاج مفتاحًا، والكتابة تحتاج فعلًا موقَّعًا، والحساب يستطيع الموافقة على محفظة API توقّعها بدل مفتاحه هو.
| لماذا تُستعمل | أين |
|---|---|
| القراءة: الأسعار الوسطى، ودفتر L2، والشموع، وتاريخ التمويل، وحالة الحساب. بلا مفتاح وبلا توقيع. | POST https://api.hyperliquid.xyz/info |
الكتابة: order وcancel وmodify وupdateLeverage وapproveAgent وwithdraw3 وغيرها، وكلها موقَّعة. | POST https://api.hyperliquid.xyz/exchange |
البثّ الحيّ (allMids وl2Book وtrades وcandle وuserFills)، وبديل عن الإرسال فوق HTTP. | wss://api.hyperliquid.xyz/ws |
| المسارات الثلاثة نفسها على منصة الاختبار. | api.hyperliquid-testnet.xyz |
ثلاثة عناوين تهمّ، وهي أدناه، وكل رقم في هذه الصفحة هو رقم الوثائق في 5 أكتوبر 2026.
حِزم SDK التي تسمّيها الوثائق
لا يلزمك تركيب الأفعال الموقَّعة بيدك. فالوثائق تسمّي حزمة Python رسمية، hyperliquid-dex/hyperliquid-python-sdk، وحزمة Rust من المجتمع، وحزمتي TypeScript من المجتمع (nktkas/hyperliquid وnomeida/hyperliquid)، وCCXT.
والتوقيع هو الجزء الذي يستحق أن يُستعار بدل أن يُعاد كتابته. فالفعل يُسلسَل ويُوقَّع على شكل دقيق، والشكل الخاطئ بحقل واحد يُرفض: ولا يصل الأمر إلى الدفتر أبدًا.
محافظ API وأرقام nonce
الحساب الرئيسي يستطيع الموافقة على محافظ API توقّع عنه أو عن أي من حساباته الفرعية. وهي توقّع فقط: فللاستعلام عن بيانات حساب يجب تمرير عنوان ذلك الحساب الفعلي، واستعمال محفظة الوكيل يعطي نتيجة فارغة.
وأرقام nonce أشدّ مما تبدو. فتحفظ Hyperliquid أعلى 100 رقم لكل عنوان، والفعل الجديد يحتاج رقمًا أكبر من أصغر أرقام تلك المجموعة، لم يُستعمل من قبل، وداخل نافذة (T ناقص يومين، T زائد يوم)، حيث T هو طابع زمن الكتلة بالمللي ثانية unix.
تُشذَّب محفظة API حين تُسجَّل محفظة جديدة بلا اسم، أو حين تأخذ محفظة جديدة باسم اسمًا قائمًا، أو حين تنتهي مدتها، أو حين لا يبقى للحساب الذي سجّلها مال. وتحذّر الوثائق من أن الوكيل المحذوف من السجل قد تُشذَّب حالة أرقامه، فتصير الأفعال الموقَّعة سابقًا قابلة للإعادة: فأنشئ محفظة وكيل جديدة بدل إحياء قديمة.
حدود المعدل، كما هي موثّقة
- لكل IP. طلبات REST تتقاسم سقف وزن مجموعًا قدره 1200 في الدقيقة. ووزن فعل exchange هو
1 + floor(batch_length / 40)، فالدفعة شبه مجانية؛ وأكثر طلبات info وزنها 20، وقليل منها 2، وuserRoleوزنه 60. - لكل عنوان. طلب واحد لكل 1 USDC متداول تراكميًا، بعد رصيد ابتدائي قدره 10000 طلب، ثم طلب كل 10 ثوانٍ. وللإلغاءات سماح أوسع.
- Websocket. 10 اتصالات على الأكثر، و30 اتصالًا جديدًا في الدقيقة، و1000 اشتراك، و2000 رسالة مُرسلة في الدقيقة، و100 رسالة post في الطريق في وقت واحد.
- الأوامر المفتوحة. سقف افتراضي قدره 1000، وواحد إضافي لكل 5 ملايين USDC من حجم التداول، بحدّ أقصى 5000 في المجموع.
حدّ كل عنوان يفاجئ البرنامج الجديد: فسماحه يُكتسب بالتداول، والحلقة التي تعيد المحاولة بلا بصيرة تصرفه على لا شيء.
سكربت، وبوت، ومساعد
| ما هو | ما الذي يقرّر | ما يطلبه منك |
|---|---|---|
| سكربت | أنت قرّرت، حين كتبته. يشغّل تسلسلًا ولا يختار شيئًا. | أن تقرأه قبل تشغيله. فحدوده هي السطور التي كتبتها. |
| بوت | قاعدة كتبتها، كلما تحققت شروطها، وبلا من يراقب. | حدودًا خارج القاعدة، وطريقة لإيقافه بأمر واحد. |
| مساعد (وكيل ذكاء اصطناعي) | النموذج يقترح، والكود يراجع الاقتراح على الأرقام. | حدودًا لا يستطيع توسيعها، ومفتاحًا لا يستطيع السحب. |
لا تستطيع واجهة API أن تعرف أيَّ الثلاثة ينادي، وتطبّق القواعد نفسها على الثلاثة. وهي تختلف في مكان اتخاذ القرار وفي ما يحدث حين يكون خاطئًا: فالسكربت الخاطئ يخطئ مرة، والبوت يخطئ الليل كله.
وLocker Protocol Agentic من النوع الثالث: lpa لإنسان أو لوكيل ذكاء اصطناعي، وخادم MCP بالأوامر نفسها أدوات، وسياسة محلية تُراجَع مرتين قبل أي أمر، وتفويض موقَّع بمحفظتك أنت. وهو لا يَعِد بنتيجة.