हाँ, सार्वजनिक API के ज़रिए
हाँ: Hyperliquid अपना पूरा ट्रेडिंग इंटरफ़ेस एक सार्वजनिक HTTP API के रूप में प्रकाशित करता है, वही जो उसका वेब इंटरफ़ेस बरतता है। पढ़ने के लिए कोई कुंजी नहीं चाहिए, लिखने के लिए साइन की गई कार्रवाई चाहिए, और अकाउंट किसी 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 SDK, hyperliquid-dex/hyperliquid-python-sdk, एक कम्यूनिटी Rust SDK, दो कम्यूनिटी TypeScript SDK (nktkas/hyperliquid और nomeida/hyperliquid), और CCXT गिनाता है।
साइन करना ही वह हिस्सा है जिसे दोबारा लिखने की जगह उधार लेना बेहतर है। कार्रवाई एक ठीक-ठीक शकल में क्रमबद्ध और साइन होती है, और एक फ़ील्ड से ग़लत शकल मना कर दी जाती है: ऑर्डर बुक तक कभी पहुँचता ही नहीं।
API वॉलेट और नॉन्स
मास्टर अकाउंट API वॉलेट को मंज़ूरी दे सकता है कि वे मास्टर अकाउंट या उसके किसी भी सब-अकाउंट की तरफ़ से साइन करें। वे सिर्फ़ साइन करते हैं: किसी अकाउंट का डेटा पूछने के लिए आपको उस अकाउंट का असली पता देना होगा, और एजेंट वॉलेट बरतने पर नतीजा ख़ाली आता है।
नॉन्स दिखने से ज़्यादा सख़्त हैं। Hyperliquid हर पते के 100 सबसे बड़े नॉन्स रखता है, और नई कार्रवाई को ऐसा नॉन्स चाहिए जो उस सेट के सबसे छोटे से बड़ा हो, पहले कभी बरता न गया हो, और (T घटा 2 दिन, T जमा 1 दिन) की खिड़की के भीतर हो, जहाँ T ब्लॉक की यूनिक्स मिलीसेकंड मुहर है।
API वॉलेट तब छाँट दिया जाता है जब कोई नया बिना नाम का वॉलेट पंजीकृत होता है, जब कोई नया नामवाला वॉलेट मौजूदा नाम ले लेता है, जब उसकी अवधि बीत जाती है, या जब उसे पंजीकृत करने वाले अकाउंट में पैसा नहीं बचता। डॉक्यूमेंटेशन चेताता है कि पंजीकरण हटे एजेंट की नॉन्स हालत छाँटी जा सकती है, इसलिए पहले साइन की गई कार्रवाइयाँ दोबारा चलाई जा सकती हैं: पुराने एजेंट वॉलेट को जिलाने की जगह नया बनाएँ।
दर-सीमाएँ, जैसी दर्ज हैं
- हर IP पर। REST अनुरोध मिलकर प्रति मिनट 1200 भार की सीमा बाँटते हैं। exchange की कार्रवाई का भार
1 + floor(batch_length / 40)है, इसलिए बैच लगभग मुफ़्त है; info के ज़्यादातर अनुरोधों का भार 20 है, कुछ का 2, औरuserRoleका 60। - हर पते पर। कुल मिलाकर ट्रेड किए हर 1 USDC पर 1 अनुरोध, 10,000 अनुरोधों की शुरुआती गुंजाइश के बाद, फिर हर 10 सेकंड में एक अनुरोध। रद्द करने को ज़्यादा छूट मिलती है।
- वेबसॉकेट। आगे से आगे 10 कनेक्शन, प्रति मिनट 30 नए कनेक्शन, 1000 सब्सक्रिप्शन, प्रति मिनट 2000 संदेश भेजे जाना और एक साथ 100 बीच-रास्ता post संदेश।
- खुले ऑर्डर। डिफ़ॉल्ट सीमा 1000, और हर 5M USDC वॉल्यूम पर एक और, कुल 5000 पर रुककर।
हर पते की सीमा नए प्रोग्राम को चौंकाती है: उसकी गुंजाइश ट्रेड करके कमाई जाती है, और जो चक्कर आँख बंद कर दोबारा कोशिश करता है वह उसे बेकार में ख़र्च देता है।
एक स्क्रिप्ट, एक बॉट, एक असिस्टेंट
| वह क्या है | कौन तय करता है | उसे आपसे क्या चाहिए |
|---|---|---|
| एक स्क्रिप्ट | आपने तय किया, जब आपने उसे लिखा। वह एक क्रम चलाती है और कुछ नहीं चुनती। | चलाने से पहले उसे पढ़ना। उसकी सीमाएँ वही पंक्तियाँ हैं जो आपने टाइप कीं। |
| एक बॉट | आपका लिखा एक नियम, जब भी उसकी शर्तें पूरी हों, बिना देखरेख। | नियम के बाहर की सीमाएँ, और एक ही कमांड से उसे रोकने का रास्ता। |
| एक असिस्टेंट (एक AI एजेंट) | मॉडल सुझाव देता है; कोड उस सुझाव को अंकों के सामने जाँचता है। | वे सीमाएँ जिन्हें वह चौड़ा न कर सके, और एक कुंजी जो निकासी न कर सके। |
API यह नहीं बता सकता कि तीनों में से कौन बुला रहा है, और तीनों पर वही नियम लगाता है। उनमें फ़र्क़ इस बात का है कि फ़ैसला कहाँ होता है और ग़लत होने पर क्या होता है: ग़लत स्क्रिप्ट एक बार ग़लत होती है, बॉट पूरी रात।
Locker Protocol Agentic तीसरी क़िस्म है: इंसान या AI एजेंट के लिए lpa, वही कमांड औज़ारों के रूप में देने वाला एक MCP सर्वर, किसी भी ऑर्डर से पहले दो बार जाँची गई एक लोकल पॉलिसी, और आपके अपने वॉलेट से साइन किया एक मैंडेट। वह किसी नतीजे का वादा नहीं करता।