כן, דרך ה-API הציבורי
כן: Hyperliquid מפרסמת את כל ממשק המסחר שלה כ-API ציבורי מעל 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 בסך הכול.
המגבלה לכל כתובת מפתיעה תוכנה חדשה: ההרשאה שלה נצברת במסחר, ולולאה שמנסה שוב בעיניים עצומות מבזבזת אותה על כלום.
סקריפט, בוט, עוזר
| מה זה | מה מחליט | מה הוא דורש ממך |
|---|---|---|
| סקריפט | אתה החלטת, כשכתבת אותו. הוא מריץ רצף ולא בוחר כלום. | לקרוא אותו לפני ההרצה. הגבולות שלו הם השורות שהקלדת. |
| בוט | כלל שאתה כתבת, בכל פעם שהתנאים שלו מתקיימים, בלי שמישהו מסתכל. | גבולות מחוץ לכלל, ודרך לעצור אותו בפקודה אחת. |
| עוזר (סוכן AI) | מודל מציע; קוד בודק את ההצעה מול מספרים. | גבולות שהוא לא יכול להרחיב, ומפתח שלא יכול למשוך. |
ה-API לא יכול לדעת מי מהשלושה קורא, והוא מחיל על שלושתם את אותם כללים. הם נבדלים במקום שבו ההחלטה מתקבלת ובמה שקורה כשהיא שגויה: סקריפט שטועה טועה פעם אחת, בוט טועה כל הלילה.
Locker Protocol Agentic הוא מהסוג השלישי: lpa לאדם או לסוכן AI, שרת MCP עם אותן פקודות ככלים, מדיניות מקומית שנבדקת פעמיים לפני כל פקודה, וייפוי כוח שנחתם עם הארנק שלך. הוא לא מבטיח תוצאה.