Ya, lewat API publik
Ya: Hyperliquid menerbitkan seluruh antarmuka tradingnya sebagai API HTTP publik, yang sama dengan yang dipakai antarmuka webnya. Pembacaan tidak perlu kunci, penulisan perlu tindakan bertanda tangan, dan sebuah akun bisa menyetujui dompet API untuk menandatanganinya alih-alih kuncinya sendiri.
| Untuk apa | Di mana |
|---|---|
| Pembacaan: harga tengah, order book L2, candle, riwayat funding, keadaan sebuah akun. Tanpa kunci, tanpa tanda tangan. | POST https://api.hyperliquid.xyz/info |
Penulisan: order, cancel, modify, updateLeverage, approveAgent, withdraw3 dan sisanya, masing-masing bertanda tangan. | POST https://api.hyperliquid.xyz/exchange |
Aliran langsung (allMids, l2Book, trades, candle, userFills), dan satu alternatif pengiriman lewat HTTP. | wss://api.hyperliquid.xyz/ws |
| Tiga jalur yang sama di bursa uji. | api.hyperliquid-testnet.xyz |
Tiga alamat yang penting ada di bawah, dan tiap angka di halaman ini adalah angka dokumentasi pada 5 Oktober 2026.
SDK yang didaftar dokumentasinya
Anda tidak harus merakit tindakan bertanda tangan dengan tangan. Dokumentasinya menyebut satu SDK Python resmi, hyperliquid-dex/hyperliquid-python-sdk, satu SDK Rust komunitas, dua SDK TypeScript komunitas (nktkas/hyperliquid dan nomeida/hyperliquid), dan CCXT.
Penandatanganan adalah bagian yang lebih baik dipinjam daripada ditulis ulang. Sebuah tindakan diserialkan dan ditandatangani dalam bentuk yang persis, dan bentuk yang salah satu bidang akan ditolak: order itu tidak pernah sampai ke order book.
Dompet API dan nonce
Sebuah akun induk bisa menyetujui dompet API untuk menandatangani atas nama akun induk itu atau salah satu subakunnya. Mereka hanya menandatangani: untuk menanyakan data sebuah akun Anda harus memasukkan alamat asli akun tersebut, dan memakai dompet agen menghasilkan hasil kosong.
Nonce lebih ketat daripada kelihatannya. Hyperliquid menyimpan 100 nonce tertinggi per alamat, dan sebuah tindakan baru perlu nonce yang lebih besar daripada yang terkecil dalam himpunan itu, belum pernah dipakai, dan berada dalam jendela (T kurang 2 hari, T lebih 1 hari), dengan T adalah cap waktu milidetik unix dari blok itu.
Sebuah dompet API dipangkas ketika dompet tanpa nama yang baru didaftarkan, ketika dompet bernama yang baru mengambil nama yang sudah ada, ketika masa berlakunya habis, atau ketika akun yang mendaftarkannya tidak lagi punya dana. Dokumentasinya memperingatkan bahwa keadaan nonce agen yang pendaftarannya dicabut bisa ikut dipangkas, jadi tindakan yang sudah ditandatangani sebelumnya bisa diulangi: buatlah dompet agen baru alih-alih menghidupkan yang lama.
Batas laju, seperti yang terdokumentasi
- Per IP. Permintaan REST berbagi satu batas bobot gabungan sebesar 1200 per menit. Satu tindakan exchange berbobot
1 + floor(batch_length / 40), jadi sebuah batch hampir gratis; sebagian besar permintaan info berbobot 20, segelintir berbobot 2, danuserRoleberbobot 60. - Per alamat. 1 permintaan untuk tiap 1 USDC yang ditradingkan secara kumulatif, setelah cadangan awal 10.000 permintaan, lalu satu permintaan tiap 10 detik. Pembatalan mendapat kelonggaran lebih lebar.
- Websocket. Paling banyak 10 sambungan, 30 sambungan baru per menit, 1000 langganan, 2000 pesan dikirim per menit dan 100 pesan post yang sedang jalan bersamaan.
- Order terbuka. Batas bawaan 1000, ditambah satu lagi untuk tiap 5M USDC volume, berhenti pada total 5000.
Batas per alamat mengejutkan program baru: kelonggarannya didapat dengan melakukan trading, dan sebuah loop yang mencoba ulang tanpa melihat menghabiskannya untuk nol hasil.
Sebuah skrip, sebuah bot, sebuah asisten
| Apa itu | Apa yang memutuskan | Apa yang dibutuhkannya dari Anda |
|---|---|---|
| Sebuah skrip | Anda, waktu Anda menulisnya. Ia menjalankan sebuah urutan dan tidak memilih apa pun. | Dibaca sebelum dijalankan. Batasnya adalah baris-baris yang Anda ketik. |
| Sebuah bot | Sebuah aturan yang Anda tulis, kapan pun syaratnya terpenuhi, tanpa ditonton. | Batas di luar aturan itu, dan satu cara menghentikannya dengan satu perintah. |
| Sebuah asisten (sebuah agen AI) | Sebuah model mengusulkan; kode memeriksa usulan itu terhadap angka. | Batas yang tak bisa dilebarkannya, dan kunci yang tak bisa menarik dana. |
API tidak bisa membedakan siapa di antara ketiganya yang memanggil, dan menerapkan aturan yang sama pada ketiganya. Perbedaannya ada pada di mana keputusan diambil dan pada apa yang terjadi ketika keputusan itu salah: skrip yang salah salah sekali, bot salah sepanjang malam.
Locker Protocol Agentic adalah jenis ketiga: lpa untuk seorang manusia atau sebuah agen AI, sebuah server MCP dengan perintah yang sama sebagai alat, sebuah kebijakan lokal yang diperiksa dua kali sebelum order apa pun, dan sebuah mandat yang ditandatangani oleh dompet Anda sendiri. Ia tidak menjanjikan hasil.