Hyperliquid API: Botlar ve Quant Traderlar İçin 2026 Rehberi

Hyperliquid API, Hyperliquid perpetual borsasının herkese açık, programatik arayüzüdür. Hyperliquid tamamen zincir üstünde çalışan bir DEX olduğundan, işlem ekranı üzerinden yapabildiğiniz her şeyi — fiyatları okumak, emir göndermek, pozisyon yönetmek — istekleri imzalayıp göndererek koddan da yapabilirsiniz. Bu, botları, quant stratejilerini ve özel panelleri bir geçici çözüm değil, birinci sınıf bir kullanım senaryosu yapar (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

API, istekler için düz HTTP üzerinden JSON’dur ve akış için ayrı bir WebSocket’e sahiptir; bu yüzden her dilden erişilebilir. Python geliştiricileri için ise tüm bunları sarmalayan resmi bir SDK vardır. Bu rehber, üç yüzeyi, kimlik doğrulamanın agent cüzdanları üzerinden nasıl çalıştığını, SDK ile rate limitleri ve nasıl başlanacağını adım adım anlatır.

API, her biri net bir göreve sahip üç yüzeye ayrılmıştır (Hyperliquid Docs — API (Info, Exchange & WebSocket)):

• Info uç noktası (okuma). Piyasa meta verilerini, emir defterlerini, mum çubuklarını, fonlamayı (funding), açık pozisyonlarınızı, bakiyelerinizi ve geçmiş işlemlerinizi döndürür. Çoğu Info isteği imza gerektirmez — bir bot, herhangi bir karar vermeden önce dünyayı bunlarla görür.
• Exchange uç noktası (işlem). Durum değişikliklerinin gerçekleştiği yer: emir gönderme, değiştirme ve iptal etme, kaldıraç ile marjin modunu ayarlama ve kendi hesabınız içinde fon taşıma. Her Exchange isteği, cüzdanınız veya yetkilendirilmiş bir agent cüzdanı tarafından kriptografik olarak imzalanmalıdır.
• WebSocket (gerçek zamanlı). Canlı fiyat, emir defteri, işlem ve hesap güncelleme akışlarına abone olun; böylece bir bot sürekli sorgulamak (polling) yerine anında tepki verebilir. Gecikmeye duyarlı her şey için etrafında yapı kurduğunuz yüzey WebSocket’tir.

Tipik bir döngü şöyle görünür: durumu Info’dan (veya bir WebSocket aboneliğinden) okuyun, strateji mantığınızı uygulayın ve ardından Exchange uç noktası üzerinden eyleme geçin. Bu Info-karar ver-Exchange döngüsü, neredeyse her Hyperliquid ticaret botunun bel kemiğidir.

Hyperliquid’de API ticaretini gerçekten güvenli kılan parça agent cüzdanıdır (API cüzdanı da denir). Botunuza ana özel anahtarınızı vermek yerine, emir gönderip iptal edebilen ancak fonlarınızı çekemeyen ya da transfer edemeyen ayrı bir anahtarı yetkilendirirsiniz (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

• Non-custodial kalır. USDC’niz ve pozisyonlarınız kendi Hyperliquid hesabınızda kalır. Agent anahtarı bunlar üzerinde işlem eylemlerini imzalar; onları asla tutmaz.
• Ele geçirilme sınırlandırılmıştır. Sızdırılmış bir agent anahtarı, bir saldırganın hesabınızda işlem yapmasına izin verir ama hesabınızı boşaltmasına izin vermez — para çekme yetkisi olan sızdırılmış bir merkezi borsa API anahtarına kıyasla çok daha küçük bir etki alanı.
• Kaç tane tutabileceğinize dair limitler vardır. Bir hesap sınırlı sayıda agent cüzdanı onaylayabilir ve onaylar sona erebilir — güncel sayıları dokümanlardan doğrulayın (Hyperliquid Docs — Rate limits and user limits).

Başlamanın en hızlı yolu, Info, Exchange ve WebSocket yüzeylerini sarmalayan, istek imzalamayı yöneten ve bir emir gönderme ya da bir akışa abone olma gibi yaygın görevler için örnek scriptler içeren Hyperliquid’in resmi açık kaynaklı Python SDK’sıdır (Hyperliquid — official Python SDK (GitHub)). Bu bir kolaylık katmanıdır — arka planda JavaScript, Rust ya da Go’dan çağırabileceğiniz aynı JSON/HTTP API’dir.

Üretim botları rate limitlere uymak zorundadır. Hyperliquid, hem IP başına istek limitlerini hem de işlem etkinliğinizle ölçeklenen adres tabanlı limitleri, ayrıca ağır istekleri daha “maliyetli” kılan ağırlık tabanlı maliyetleri belgeler (Hyperliquid Docs — Rate limits and user limits). Pratikteki sonuçları:

• Polling yerine WebSocket’i tercih edin. Bir akışa abone olmak, Info uç noktasını bir döngü içinde sürekli zorlamaktan çok daha ucuzdur.
• Gruplayın ve backoff yapın. API’nin izin verdiği yerlerde istekleri gruplayın ve bir ani yük artışının sizi kısıtlatmaması (throttle) için üstel backoff ekleyin.
• Tam sayıları doğrulayın. Limitler zamanla değişir; bu yüzden ikincil bir bloga güvenmek yerine geliştirme anında bunları resmi rate-limit sayfasından okuyun (Hyperliquid Docs — Rate limits and user limits).

Sıfırdan canlı, kendi custodial (self-custodial) bir bota giden gerçekçi bir ilk yol:

1. Bir Hyperliquid hesabını fonlayın. Borsadaki kendi cüzdanınızda zincir üstü USDC’ye ihtiyacınız var — bu, API’nin okuyacağı ve üzerinde işlem yapacağı hesaptır.
2. Bir agent cüzdanı onaylayın. Kodunuzun asla para çekme yetkisi tutmadan Exchange isteklerini imzalayabilmesi için bir API/agent anahtarı oluşturun ve yetkilendirin.
3. Info / WebSocket ile okuyun. Veri akışı sağlam olana kadar — hiçbir para riske atılmadan — piyasa verilerini ve pozisyonlarınızı çekerek başlayın.
4. Exchange üzerinden test emirleri gönderin. İmzalama, fill ve iptallerin beklendiği gibi çalıştığını doğrulamak için küçük boyutlar (veya post-only / orta fiyattan uzak limit emirler) kullanın.
5. Ölçeklemeden önce risk kontrolleri ekleyin. Pozisyon üst limitleri, maksimum kaldıraç, kill-switch’ler ve drawdown limitleri, ilk kötü günden sonra değil, daha birinci günden koda dahil edilmelidir.

Buradan sonra zor olan kısım altyapı değil, stratejidir. Strateji aileleri (market making, arbitraj, grid, trend, ortalamaya dönüş) için kriptoda algoritmik ticaret ve bir fikri çalıştırmaya değer bir şeye dönüştüren araştırmadan-canlıya iş akışı için kriptoda quant ticaret sayfalarına bakın. Bot dünyasını uçtan uca görmek için kripto ticaret botları sayfasına göz atın.

Hyperliquid API, geliştiricilere eksiksiz, non-custodial bir ticaret yüzeyi sunar: okumak için bir Info uç noktası, işlem yapmak için bir Exchange uç noktası, gerçek zamanlı veri için bir WebSocket, işlem yapan ama asla para çekemeyen agent cüzdanları, resmi bir Python SDK ve belgelenmiş rate limitler. İşte bu kombinasyon, Hyperliquid’de kendi custodial botları ve quant stratejilerini pratik kılan şeydir.

Yalnızca eğitim amaçlı içerik — yatırım tavsiyesi değildir. Otomatik ticaret risk taşır ve botlar para kaybedebilir; geçmiş veya backtest edilmiş performans gelecekteki sonuçları öngörmez. API uç noktaları, rate limitler, agent-cüzdan limitleri ve SDK gereksinimleri değişir — geliştirmeden veya işlem yapmadan önce her şeyi resmi Hyperliquid dokümantasyonundan doğrulayın. Facts verified 2026-06-30.