Hyperliquid platformu, sürekli vadeli işlemler için yüksek performanslı, merkeziyetsiz bir borsa olarak öne çıkıyor; geliştiricilere düşük gecikmeli ticaret ve gelişmiş özellikler sunuyor. Geliştiriciler, işlemleri otomatikleştirmek, piyasaları izlemek ve özel uygulamalar oluşturmak için sıklıkla Hyperliquid API'sine başvuruyor.
Hyperliquid API'sinin temel bileşenlerini anlayarak başlarsınız. API, temel kategorilere ayrılır: piyasa verilerini sorgulamak için Bilgi API'si, ticaret işlemleri için Borsa API'si ve gerçek zamanlı güncellemeler için WebSocket. Ayrıca, Python ve Node.js gibi dillerdeki SDK'lar etkileşimleri basitleştirir. İlerledikçe, istek parametrelerindeki küçük ayarlamaların yürütme verimliliğinde önemli iyileşmelere yol açtığını göreceksiniz.
Hyperliquid API Nedir?
Hyperliquid API'si, Hyperliquid'in merkeziyetsiz sürekli vadeli işlem borsasına programatik erişim sağlar. Hem ana ağ (mainnet) hem de test ağı (testnet) ortamlarında işlemleri destekler. Ana ağa ve test ağına bağlanırsınız. API, istekler ve yanıtlar için JSON kullanır, çoğu işlem için HTTP POST'a ve abonelikler için WebSocket'e güvenir.
Bazı durumlarda geleneksel API anahtarları yerine özel anahtarlar kullanarak kimlik doğrulaması yaparsınız, ancak Hyperliquid güvenli yetkilendirme için API cüzdanları da sunar. Bu cüzdanlar, ana hesabınız adına para çekme izni olmadan hareket ederek otomatik ticaret için güvenliği artırır. Örneğin, Hyperliquid uygulaması aracılığıyla bir API cüzdanı oluşturur, yetkilendirir ve özel anahtarını komut dosyalarınızda kullanırsınız.
Ardından, veri türlerini göz önünde bulundurun. API, belirli yapılar ve numaralandırmalar kullanır. Varlıklar, evren listesindeki indekslerle tanımlanır, emir tarafları boole değerleri kullanır (almak için true, satmak için false) ve geçerlilik süresi seçenekleri arasında 'Gtc' (iptal edilene kadar geçerli) bulunur. İsteklerinizde doğruluğu sağlamak için bu ayrıntıları meta veri uç noktalarından alırsınız.
Bu temelle birlikte, geliştirme ortamınızı kurmaya geçersiniz. Doğru yapılandırma, yaygın hataları önler ve yineleme hızını artırır.
Hyperliquid API İçin Ortamınızı Kurma
Kuruluma programlama dilinizi seçerek ve ilgili SDK'yı yükleyerek başlarsınız. Python kullanıcıları için hyperliquid-python-sdk sağlam bir başlangıç noktası sunar. `pip install hyperliquid-python-sdk` komutuyla pip aracılığıyla yükleyin. Bu SDK, bağlantıları, kimlik doğrulamayı ve yaygın işlemleri yönetir.
Ardından kimlik bilgilerinizi yapılandırırsınız. Hesap adresiniz (genel anahtar) ve gizli anahtarınız (özel anahtar) ile bir config.json dosyası oluşturun. Güvenlik için özel bir API cüzdanı oluşturursunuz. Hyperliquid uygulamasına gidin, "Daha Fazla > API"yi seçin, anahtar için bir ad girin, cüzdan adresinizi yapıştırın ve "Oluştur"a tıklayın. API cüzdanını yetkilendirin ve özel anahtarını yapılandırmanıza kopyalayın.
SDK, test için `constants.TESTNET_API_URL` gibi URL'ler için sabitleri içe aktarır. İstemcileri şöyle başlatırsınız:
from hyperliquid.info import Info
from hyperliquid.utils import constants
info = Info(constants.TESTNET_API_URL, skip_ws=True)
Bu kurulum başlangıçta WebSocket'i atlayarak HTTP'ye odaklanır. Kullanıcı durumunu sorgulayarak bağlantıyı test edersiniz:
user_state = info.user_state("your_account_address")
print(user_state)
Yanıt hesap bilgilerinizi gösteriyorsa, ortamınız doğru çalışıyor demektir. Ancak, hatalarla karşılaşırsanız, özel anahtarınızı ve ağ seçiminizi kontrol edin.
Node.js için @nktkas/hyperliquid paketini kullanırsınız. npm ile yükleyin, ardından cüzdan yönetimi için ethers kullanarak taşıyıcıları ve istemcileri kurun. Geliştirme sırasında gerçek fonları kullanmamak için `isTestnet: true` belirtirsiniz.
Apidog gibi araçlar bu kurulumu tamamlar. Hyperliquid API özelliklerini Apidog'a aktarır, anahtarlarınızla kimlik doğrulaması yapar ve istekleri simüle edersiniz. Bu yaklaşım, yanıt yapılarını hızla ortaya çıkararak manuel kodlama süresinden tasarruf sağlar.
Yapılandırıldıktan sonra, kimlik doğrulama yöntemlerine geçersiniz. Doğru kimlik doğrulama, eylemlerinizin güvenli bir şekilde yürütülmesini sağlar.
Hyperliquid API ile Kimlik Doğrulama
Hyperliquid blok zinciri tabanlı bir sistemde çalıştığı için öncelikli olarak özel anahtar imzalaması yoluyla kimlik doğrulaması yaparsınız. Bir cüzdan örneği sağladığınızda SDK'lar imzalamayı otomatik olarak halleder.
SDK'lar olmadan doğrudan API çağrıları için, özel anahtarınızı kullanarak yükleri imzalarsınız. İstek gövdesi, tekrar oynatma koruması için bir nonce içerir ve /exchange veya /info uç noktalarına POST yaparsınız.
API cüzdanları esneklik katar. Bir cüzdanı adlandırarak, ana cüzdan adresinize bağlayarak, anahtarı oluşturarak ve yetkilendirerek bir tane oluşturursunuz. Bu cüzdan ticaret yapar ancak para çekemez, bu da botlar için riski azaltır. Kodda, ana hesap adresini belirtirken API cüzdanının özel anahtarını kullanırsınız.
Basit bir bilgi isteği göndererek kimlik doğrulamayı test edersiniz. Yetkilendirilmemişse, API "Kullanıcı veya API Cüzdanı mevcut değil" gibi bir hata döndürür. Bunu düzeltmek için, cüzdanınızın sürekli vadeli işlemler için USDC gibi minimum teminat tuttuğundan emin olun.
Güvenlik her şeyden önemlidir. Anahtarları ortam değişkenlerinde veya güvenli kasalarda saklar, periyodik olarak döndürür ve olağandışı etkinlikleri izlersiniz. Kimlik doğrulama sağlandıktan sonra, Bilgi API uç noktalarını keşfedersiniz.
Bilgi API Uç Noktalarını Keşfetme
Bilgi API'si, piyasa ve hesap verilerine salt okunur erişim sağlar. Genel veriler için kimlik doğrulaması yapmadan meta verileri, fiyatları, emirleri ve daha fazlasını almak için kullanırsınız.
Varlık evrenini ve bağlamlarını döndüren meta uç noktasıyla başlarsınız. Node.js'de:
const [meta] = await infoClient.metaAndAssetCtxs();
Bu, adları, indeksleri ve maksimum kaldıraç gibi özellikleriyle bir varlık dizisi verir. Ticaret isteklerinde varlık indeksini kullanırsınız.
Ardından, tüm çiftler için mevcut orta noktaları döndüren allMids ile orta fiyatları sorgularsınız. Açık emirler, adresinizi gerektiren openOrders'tan gelir.
Diğer uç noktalar şunları içerir:
- userState: Pozisyonları, marjları ve bakiyeleri alır.
- fundingHistory: Zaman içindeki fonlama oranlarını gösterir.
- l2Book: Bir coin için seviye 2 emir defterini sağlar.
`{"type": "meta"}` gibi JSON gövdeleriyle POST isteklerini /info'ya gönderirsiniz. Yanıtlar, sonuçları içeren "data" ile tutarlı yapılar kullanır.
Apidog burada yardımcı olur; Bilgi API'si için bir koleksiyon kurar, her tür için istekler ekler ve coinleri veya adresleri parametrelendirirsiniz. Bu görselleştirme, veri akışını anlamanıza yardımcı olur.
Verileri toplarken, işlemleri gerçekleştirmek için Borsa API'sine geçersiniz.
Ticaret İçin Borsa API Uç Noktalarını Kullanma
Borsa API'si, emir verme, iptal etme ve değiştirme gibi eylemleri yönetir. Tüm istekleri imzalı yüklerle kimlik doğrulamasından geçirirsiniz.
Emirleri, varlık indeksi, taraf, fiyat, boyut, sadece azaltma bayrağı ve tür (limit veya piyasa) gibi parametreleri tanımlayarak verirsiniz. Bir limitli satış için:
Elixir'de (SDK belgelerinden):
Hyperliquid.Api.Exchange.place_order(order)
Burada order, a: varlık, b: false (satış), p: "100", s: "0.1", r: false, t: {limit: {tif: "Gtc"}} içeren bir haritadır.
Yanıt, başarılı olursa durumu ve emir kimliğini içerir.
Varlık ve oid (emir kimliği) kullanarak emirleri iptal edersiniz:
Hyperliquid.Api.Exchange.cancel_order(asset, oid)
Toplu işlemler için, bir liste ile cancel_orders kullanırsınız.
Değişiklikler de benzer şekilde yapılır: oid ve yeni parametreleri belirtin.
Diğer eylemler arasında kaldıraç güncelleme bulunur:
Hyperliquid.Api.Exchange.update_leverage(asset, is_cross, leverage)
Ve hesaplar arasında fon taşımak için spot_perp_transfer gibi transferler.
Hataları, yanıt durumunu kontrol ederek ele alırsınız—başarı için "ok", aksi takdirde yetersiz marj gibi ayrıntılar.
Örnekler pratik kullanımı gösterir. Örneğin, fiyat kontrolleri için bilgi ve yerleştirme için borsa kullanarak, fiyat belirli bir eşiğin altına düştüğünde bir alış emri veren bir bot oluşturursunuz.
Ayrıca, duyarlılığı artırmak için gerçek zamanlı güncellemeler için WebSocket'i entegre edersiniz.
Gerçek Zamanlı Veriler İçin WebSocket Entegrasyonu
Canlı yayınlar için WebSocket'e bağlanırsınız. Ana ağ için wss://api.hyperliquid.xyz/ws veya test ağı eşdeğerini kullanın.
`{"method": "subscribe", "subscription": {"type": "trades", "coin": "SOL"}}` şeklinde JSON göndererek abone olursunuz.
Sunucu onay ile yanıt verir, ardından yeni işlemler gibi güncellemeleri gönderir.
Emir defteri, kullanıcı olayları ve bildirimler gibi konuları ele alırsınız. Python SDK'sında, etkinleştirmek için skip_ws=False olarak ayarlayın.
Bu gerçek zamanlı yetenek, piyasa değişikliklerine anında tepki vermenizi sağlar, örneğin dolgularda emirleri ayarlamak gibi.
Uç noktalar kapsandığında, Python SDK'sını derinlemesine incelersiniz.
Hyperliquid Python SDK'sından Yararlanma
Python SDK'sı, API çağrılarını sınıflara soyutlar. Sorgular için Info'yu ve eylemler için Exchange'i içe aktarırsınız.
Temel bir emri şöyle verirsiniz (örneklerden):
İlk olarak, yapılandırmayı yükleyin:
import json
def address_and_private_key():
with open("examples/config.json") as f:
config = json.load(f)
return config["account_address"], config["secret_key"]
Ardından, Exchange'i başlatın:
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
address, private = address_and_private_key()
exchange = Exchange(address, private, base_url=constants.TESTNET_API_URL)
Emir verin:
order_result = exchange.order("BTC", True, 0.02, 30000, {"limit": {"tif": "Gtc"}})
print(order_result)
Bu, 0.02 BTC'yi 30.000 dolarlık limit fiyattan alır.
Bunu, toplu emirler veya iptaller gibi gelişmiş özellikler için genişletirsiniz.
SDK ayrıca yönetilen hesaplar için kasa adreslerini de destekler.
Depodaki örnekler basic_order, user_state ve daha fazlasını kapsayarak tam iş akışlarını gösterir.
Geliştirme yaparken, performansı optimize etmek için en iyi uygulamaları dahil edersiniz.
Hyperliquid API Kullanımı İçin En İyi Uygulamalar
Kısıtlamayı önlemek için oran limitlerini izlersiniz—Hyperliquid IP başına ve hesap başına limitler uygular.
Mali kaybı önlemek için tüm geliştirmelerde test ağını kullanırsınız.
Hata işleme, ayrıntıları günlüğe kaydetmeyi ve geçici hataları geri çekilmeyle yeniden denemeyi içerir.
Ölçeklenebilirlik için, mümkün olduğunca istekleri toplu olarak gönderirsiniz, örneğin birden fazla iptal gibi.
Güvenlik, API cüzdanlarını ve en az ayrıcalık ilkelerini kullanmaya kadar uzanır.
Hyperliquid anlamsal sürümlemeyi takip ettiği için kodunuzu SDK güncellemeleriyle birlikte sürümlersiniz.
Apidog gibi araçlar, birim testleri için yanıtları taklit etmeye yardımcı olur.
Sorunlar ortaya çıktığında sorun giderme sıradadır.
Yaygın Hyperliquid API Sorunlarını Giderme
Teminat düşük olduğunda "Yetersiz marj" hatasıyla karşılaşırsınız—çözmek için USDC yatırın.
"Varlık bulunamadı" ise, meta verilerden indeksleri doğrulayın.
Kimlik doğrulama hataları geçersiz anahtarlardan kaynaklanır—API cüzdanlarını yeniden oluşturun ve yetkilendirin.
Ağ sorunları, URL'leri kontrol etmeyi ve gerekirse proxy kullanmayı gerektirir.
Apidog ile başarısız istekleri yeniden oynatarak hata ayıklarsınız.
SDK'lardan gelen günlükler, analiz için zaman damgaları ve yükler sağlar.
Bu ipuçlarıyla güvenilir entegrasyonları sürdürürsünüz.
Hyperliquid API ile Gelişmiş Kullanım Durumları
l2Book'u izleyen ve dengesizlikler üzerine emir veren ticaret botları oluşturursunuz.
Stratejiler, geçmişten fonlama oranlarını arbitraj fırsatlarına kadar içerir.
Alt hesaplar ayrılmış ticareti mümkün kılar: adla oluşturun, fonları transfer edin ve ayrı ayrı ticaret yapın.
Kasa transferleri paylaşılan likidite havuzlarını destekler.
Geri test yapmak için API'den alınan geçmiş verilerle simülasyon yaparsınız.
Apidog ile entegrasyon, ekiplerde işbirliğine dayalı hata ayıklamayı sağlar.
Son olarak, gelecekteki geliştirmeleri göz önünde bulundurarak bitirirsiniz.
Sonuç: Merkeziyetsiz Ticaret İçin Hyperliquid API'sında Uzmanlaşma
Artık Hyperliquid API'sini etkili bir şekilde kullanma bilgisine sahipsiniz. Kurulum ve kimlik doğrulamadan uç noktalara ve SDK'lara kadar bu kılavuz, gelişmiş uygulamalar oluşturmanız için sizi donatıyor. Unutmayın, kodunuzdaki kademeli iyileştirmeler önemli performans artışları sağlar. Test ağında deney yapın, Apidog gibi araçlardan yararlanın ve Hyperliquid'in belgeleriyle güncel kalın. Platform geliştikçe, becerileriniz sizi yeni özelliklerden yararlanmaya hazırlar.