Hyperliquid Python SDK ile başlangıç

Gerçekte neyi kuruyorsunuz

Üç şey ve terminale dokunmadan önce onları adlandırmaya değer, çünkü aralarındaki karışıklık zorluğun tamamıdır.

Ana cüzdanınız hesaptır. Parayı tutar ve her şeyin karşısına kaydedildiği adrestir.

API cüzdanı, onun yetkilendirdiği bir agent’tır. Emirleri imzalar. Para çekemez.

SDK, imzalı HTTP arayüzünün etrafındaki bir Python sarmalayıcısıdır. requests ve bir imzalama kütüphanesiyle yapamayacağınız hiçbir şeyi yapmaz; yalnızca imza şemasını uygulamaktan kurtarır.

Kurulum ve yapılandırma

1. Paketi kurun

   pip install hyperliquid-python-sdk. GitHub’daki hyperliquid-dex organizasyonunda bakımı yapılan referans uygulamadır.

   Görmeniz gereken ortamınızda kullanılabilir hyperliquid-python-sdk

2. Uygulamada bir API cüzdanı üretin

   Ana özel anahtarınızı bir dosyaya koymak yerine bunu yapın. Agent işlem yapabilir ve para çekemez, dolayısıyla dosya sızarsa en kötü durum sınırlıdır.

   Agent’ı onaylamak, ilk bağlandığınızdaki Establish Connection adımı gibi, ana cüzdanınızca imzalanan zincir üstü bir eylemdir.

   Görmeniz gereken hesabınızda yetkilendirilmiş bir agent'ın özel anahtarı

3. Yapılandırmayı iki farklı adresle doldurun

   secret_key, API cüzdanının özel anahtarıdır. account_address ise ana cüzdanınızın açık anahtarıdır.

   Bu asimetri, ilk denemelerdeki en yaygın tek arızadır ve README de aynı sebeple bunu açıkça belirtir.

   Görmeniz gereken SDK'nın hem imzalayabildiği hem sorgulayabildiği bir yapılandırma

4. Bir şey yazmadan önce bir şey okuyun

   Info kurun ve orta fiyatları ya da bir defteri sorgulayın. Bu hiç imza istemez, dolayısıyla çalışıyorsa ağ yolunuz ve uç nokta seçiminiz doğrudur ve sonraki her arıza bağlantı değil imzalama sorunudur.

   Görmeniz gereken info uç noktasından yazdırılmış canlı piyasa verisi

5. Exchange ile küçük bir emir verin

   Ulaştığını doğrulamak için gerçek uygulamayı kullanın. Kendi programınızın verdiği emri arayüzde görmek, kurulumun gerçekten doğrulandığı andır.

   Görmeniz gereken uygulamanın açık emirler panelinde görünen bir emir

İki sınıf

Info okuma tarafıdır. Piyasa meta verisi, orta fiyatlar, defterler, mumlar, bir adresin pozisyonları ve gerçekleşmeleri. Anahtar istemez. Bir API URL’si ve WebSocket istemiyorsanız skip_ws=True ile kurulur.

Exchange yazma tarafıdır. Emirler, iptaller, kaldıraç değişiklikleri, transferler. Her isteği yapılandırdığınız anahtarla imzalar.

Bunları kendi kodunuzda ayrı tutmak, API’nin onları ayırmasıyla aynı sebeple iyi bir alışkanlıktır: okuma yolu zararsızdır, yazma yolu değildir ve ilkindeki bir hata asla ikincisinde bir eyleme dönüşememelidir.

İlk denemede ne bozulur

Her sorgudan boş veri. account_address ana cüzdanın değil API cüzdanının adresidir. Ana adresle sorgulayın; agent ile imzalayın.

Emirlerin büyüklük yüzünden reddedilmesi. $10.00 asgari büyüklüğün altında ya da piyasanın tick ve lot adımlarına hizalanmamış. İkisi de küresel değil, piyasa meta verisinden gelir.

Hızla hız sınırına takılmak. Genellikle defter üzerinde bir yoklama döngüsü. Onun yerine WebSocket’ten abone olun. Limitler ve neden öyle şekillendikleri.

Nonce hataları. Eylemler agent başına nonce ile sıralanır. Aynı agent ile imzalayan iki süreç çakışır ve çözüm akıllı yeniden deneme mantığı değil, süreç başına bir agent’tır.

Her şey çalışır, sonra bir yeniden dağıtımın ardından durur. Adresini yeniden kullandığınız, kaydı silinmiş bir agent. Yenisini üretin — belgeler, temizlenen nonce durumunun yeniden kullanımı bir tekrar oynatma riski yaptığı konusunda uyarıyor.

Çalışan koddan çalışan stratejiye

SDK sizi bir öğleden sonrada verilmiş bir emre götürür. Oradan çalıştırmaya değer bir şeye kadar olan mesafenin çoğu kod değildir.

Emir türü disiplini. Maker olmayı kastettiğinizde post-only, her çıkışta reduce-only kullanın. İkisi de bütün pahalı kaza kategorilerini önler ve ikisi de tek bir bayraktır. Tam liste.

Bakiyenize göre değil deftere göre boyutlandırın. Derinliği yok sayan bir strateji, optimize ettiği ücret farkını gölgede bırakan kayma öder.

Süreç öldüğünde ne olacağına karar verin. Bekleyen emirler siz olmadan çalışmaya devam eder. Bu ya bir özelliktir ya bir tehlike ve bir karar olmalıdır.

Bot çalıştırmak ve önce nelerin düşünüleceği o listenin geri kalanını anlatıyor.

Sırada nereye

API’nin kendisi — uç noktalar, agent modeli ve hız limitleri — ve üzerinden göndereceğiniz emir türleri.