Hyperliquid API'si: ne yapar ve erişim nasıl işler

İki uç nokta, çok farklı iki şey

info herkese açıktır. Fiyatlar, emir defterleri, fonlama oranları, piyasa meta verisi, herhangi bir adresin pozisyonları ve gerçekleşmeleri. Anahtar yok, hesap yok, imza yok — bu sitenin kendi rakamlarını canlı tutmak için okuduğu verinin aynısı.

exchange eylemlerin gerçekleştiği yerdir: emir verme ve iptal, transferler, kaldıraç değişiklikleri. Her istek imzalanır.

Bu ayrımı içselleştirmeye değer, çünkü “API anahtarı var mı?” sorusunun neden tatmin etmeyen bir cevabı olduğunu açıklar. Ayarlar sayfasında üretilecek bir anahtar yoktur. Bir imza vardır ve imzalayan ya cüzdanınızdır ya da yetkilendirdiğiniz bir agent.

Agent cüzdanı modeli

Bu, her merkezi borsadan ayrılan kısımdır ve gerçekten daha iyi bir tasarımdır.

Ana hesabınız ya da alt hesapları adına imza atan bir API cüzdanını — bir agent’ı — onaylarsınız. O agent emir verebilir ve iptal edebilir. Para çekemez.

Yani sızan bir bot anahtarı kötü bir gündür, felaket değil. Biri hesabınızı zarara sokacak işlemler yapabilir. Bakiyenizi hiçbir yere gönderemez, çünkü parayı borsadan çıkarmak ana cüzdanın imzasını gerektirir.

İlk gün insanları yakalayan bir pratik not daha: bir hesabı sorgulamak için agent’ın değil, gerçek ana ya da alt hesap adresini geçirirsiniz. Agent adresiyle sorgulamak boş veri döndürür ve hata gibi görünür.

Limitler

Aynı anda iki sistem uygulanır ve farklı şeyleri kısıtlarlar.

IP başına

Ağırlık istek başına bir değildir. info isteklerinin çoğu 20, birkaç yaygın olanı 2 ve exchange istekleri 1 artı yığın uzunluğunun bir kesri kadardır. Yani bütçe, veri yoklamaktansa emir vermekte çok daha uzağa gider — bu da WebSocket’e doğru bilinçli bir yönlendirmedir.

Adres başına

REST mi WebSocket mi

Sürekli olan her şey için WebSocket. Orta fiyatlar, defter güncellemeleri, kendi gerçekleşmeleriniz. Bunları REST üzerinden yoklamak, size bedavaya gönderilecek veriyi almak için ağırlık yakar.

Eylemler ve tek seferlikler için REST. Emir vermek, iptal etmek, kaldıraç değiştirmek, bir kez geçmiş anlık görüntüsü çekmek.

İlk bottaki en yaygın acemi hatası l2Book’u döngüde yoklamaktır. Bir süre çalışır, sonra hız sınırlayıcı gelir ve çözüm daha uzun bir bekleme değil bir aboneliktir.

Maliyeti nedir

Kullanması bedava ve üzerinden işlem yapmak fazladan hiçbir şeye mal olmaz. API ek ücreti ve ayrı bir ücret kademesi yoktur: bir botun verdiği emir, elle verilen emirle tam olarak aynısını öder; giriş kademesinde 0.045% taker ya da 0.015% maker.

Bu, sık çalışan her şey için önemlidir, çünkü maker ile taker arasındaki fark otomatik bir stratejide elle işlemden çok daha hızlı birikir. Tasarrufun gerçekte nerede olduğu.

Geliştirmeye başlamadan önce

Önce emir türlerini okuyun. Post-only, reduce-only, IOC ve tetik türlerinin hepsi API üzerinden kullanılabilir ve doğru bayrağı kullanmak bütün hata kategorilerini önler. Tam liste.

Gerçek platformda küçük büyüklükle test edin. Testnet size kodunuzun derlendiğini söyler. İnce bir defterin mantığınıza karşı nasıl davrandığını söylemez.

Süreciniz öldüğünde ne olacağına karar verin. Defterde bekleyen emirlerle duran bir bot, o emirleri çalışır hâlde bırakır. Bunun istediğiniz şey olup olmadığına bilerek karar verin ve stratejinizin kendi bağlantı kesildiğinde iptal disiplinine ihtiyacı olup olmadığını düşünün.

Defterin herkese açık olduğunu varsayın. Botunuzun yaptığı her gerçekleşme, pozisyonlarınızla birlikte anında herkese görünürdür. Bunun gerçekte ne kadar açık olduğu.

Sırada nereye

Hiçlikten verilmiş bir emre giden en kısa yol olan Python SDK ile başlangıç ve bir bot çalıştırmadan önce neleri düşünmek gerektiği.