Nền tảng Hyperliquid nổi bật là một sàn giao dịch phi tập trung hiệu suất cao dành cho hợp đồng tương lai vĩnh cửu, cung cấp giao dịch độ trễ thấp và các tính năng nâng cao cho nhà phát triển. Các nhà phát triển thường sử dụng API Hyperliquid để tự động hóa giao dịch, giám sát thị trường và xây dựng các ứng dụng tùy chỉnh.
Bạn bắt đầu bằng cách hiểu các thành phần cốt lõi của API Hyperliquid. API được chia thành các danh mục chính: API Thông tin để truy vấn dữ liệu thị trường, API Giao dịch cho các hành động giao dịch và WebSocket để cập nhật theo thời gian thực. Hơn nữa, các SDK bằng các ngôn ngữ như Python và Node.js đơn giản hóa các tương tác. Khi bạn tiếp tục, bạn sẽ thấy cách điều chỉnh nhỏ trong các tham số yêu cầu dẫn đến những cải thiện đáng kể về hiệu quả thực thi.
API Hyperliquid là gì?
API Hyperliquid cho phép truy cập có lập trình vào sàn giao dịch hợp đồng vĩnh cửu phi tập trung của Hyperliquid. Nó hỗ trợ các hoạt động trên cả môi trường mainnet và testnet. Bạn kết nối với mainnet và testnet z. API sử dụng JSON cho các yêu cầu và phản hồi, dựa vào HTTP POST cho hầu hết các hành động và WebSocket cho các đăng ký.
Bạn xác thực bằng khóa riêng thay vì khóa API truyền thống trong một số trường hợp, nhưng Hyperliquid cũng cung cấp ví API để ủy quyền an toàn. Các ví này hoạt động thay mặt cho tài khoản chính của bạn mà không có quyền rút tiền, tăng cường bảo mật cho giao dịch tự động. Ví dụ, bạn tạo một ví API thông qua ứng dụng Hyperliquid, ủy quyền cho nó và sử dụng khóa riêng của nó trong các tập lệnh của bạn.
Tiếp theo, hãy xem xét các loại dữ liệu. API sử dụng các cấu trúc và enum cụ thể. Tài sản được xác định bằng các chỉ số từ danh sách vũ trụ, các phía lệnh sử dụng giá trị boolean (true cho mua, false cho bán) và các tùy chọn thời gian hiệu lực bao gồm 'Gtc' cho good 'til canceled. Bạn truy xuất các chi tiết này từ các điểm cuối siêu dữ liệu để đảm bảo độ chính xác trong các yêu cầu của bạn.
Với nền tảng này, bạn chuyển sang thiết lập môi trường phát triển của mình. Cấu hình đúng cách giúp ngăn ngừa các lỗi phổ biến và tăng tốc độ lặp lại.
Thiết lập môi trường của bạn cho API Hyperliquid
Bạn bắt đầu thiết lập bằng cách chọn ngôn ngữ lập trình và cài đặt SDK có liên quan. Đối với người dùng Python, hyperliquid-python-sdk cung cấp một điểm khởi đầu mạnh mẽ. Cài đặt nó thông qua pip với lệnh pip install hyperliquid-python-sdk. SDK này xử lý các kết nối, xác thực và các hoạt động chung.
Sau đó, bạn cấu hình thông tin xác thực của mình. Tạo một tệp config.json với địa chỉ tài khoản (khóa công khai) và khóa bí mật (khóa riêng tư) của bạn. Để bảo mật, bạn tạo một ví API chuyên dụng. Điều hướng đến ứng dụng Hyperliquid, chọn "Thêm > API", nhập tên cho khóa, dán địa chỉ ví của bạn và nhấp vào "Tạo". Ủy quyền ví API và sao chép khóa riêng tư của nó vào cấu hình của bạn.
SDK nhập các hằng số cho URL, chẳng hạn như constants.TESTNET_API_URL để thử nghiệm. Bạn khởi tạo các máy khách như sau:
from hyperliquid.info import Info
from hyperliquid.utils import constants
info = Info(constants.TESTNET_API_URL, skip_ws=True)
Thiết lập này bỏ qua WebSocket ban đầu, tập trung vào HTTP. Bạn kiểm tra kết nối bằng cách truy vấn trạng thái người dùng:
user_state = info.user_state("your_account_address")
print(user_state)
Nếu phản hồi hiển thị chi tiết tài khoản của bạn, môi trường của bạn hoạt động chính xác. Tuy nhiên, nếu bạn gặp lỗi, hãy kiểm tra khóa riêng tư và lựa chọn mạng của bạn.
Đối với Node.js, bạn sử dụng gói @nktkas/hyperliquid. Cài đặt nó bằng npm, sau đó thiết lập các transport và máy khách bằng ethers để quản lý ví. Bạn chỉ định isTestnet: true để tránh sử dụng tiền thật trong quá trình phát triển.
Các công cụ như Apidog bổ sung cho thiết lập này. Bạn nhập thông số kỹ thuật API Hyperliquid vào Apidog, xác thực bằng khóa của mình và mô phỏng các yêu cầu. Cách tiếp cận này tiết lộ cấu trúc phản hồi nhanh chóng, tiết kiệm thời gian viết mã thủ công.
Sau khi cấu hình, bạn tiến tới các phương pháp xác thực. Xác thực đúng cách đảm bảo các hành động của bạn được thực thi an toàn.
Xác thực với API Hyperliquid
Bạn xác thực chủ yếu thông qua ký khóa riêng, vì Hyperliquid hoạt động trên một hệ thống dựa trên blockchain. Các SDK xử lý việc ký tự động khi bạn cung cấp một phiên bản ví.
Đối với các cuộc gọi API trực tiếp mà không có SDK, bạn ký các payload bằng khóa riêng của mình. Phần thân yêu cầu bao gồm một nonce để bảo vệ khỏi việc phát lại, và bạn gửi đến các điểm cuối /exchange hoặc /info.
Ví API bổ sung tính linh hoạt. Bạn tạo một ví bằng cách đặt tên cho nó, liên kết nó với địa chỉ ví chính của bạn, tạo khóa và ủy quyền cho nó. Ví này thực hiện các giao dịch nhưng không thể rút tiền, giảm rủi ro cho các bot. Trong mã, bạn sử dụng khóa riêng của ví API trong khi chỉ định địa chỉ tài khoản chính.
Bạn kiểm tra xác thực bằng cách gửi một yêu cầu thông tin đơn giản. Nếu không được ủy quyền, API sẽ trả về lỗi như "Người dùng hoặc Ví API không tồn tại." Để khắc phục điều này, hãy đảm bảo ví của bạn giữ đủ tài sản thế chấp tối thiểu, chẳng hạn như USDC cho các hợp đồng vĩnh cửu.
Bảo mật vẫn là tối quan trọng. Bạn lưu trữ khóa trong các biến môi trường hoặc kho lưu trữ an toàn, xoay vòng chúng định kỳ và giám sát hoạt động bất thường. Với xác thực đã được thiết lập, bạn khám phá các điểm cuối của API Thông tin.
Khám phá các điểm cuối API Thông tin
API Thông tin cung cấp quyền truy cập chỉ đọc vào dữ liệu thị trường và tài khoản. Bạn sử dụng nó để lấy siêu dữ liệu, giá cả, lệnh và nhiều thứ khác, mà không cần xác thực đối với dữ liệu công khai.
Bạn bắt đầu với điểm cuối meta, trả về vũ trụ tài sản và ngữ cảnh. Trong Node.js:
const [meta] = await infoClient.metaAndAssetCtxs();
Điều này tạo ra một mảng các tài sản với tên, chỉ số và thông số kỹ thuật như đòn bẩy tối đa. Bạn sử dụng chỉ số tài sản trong các yêu cầu giao dịch.
Tiếp theo, bạn truy vấn giá giữa với allMids, trả về các điểm giữa hiện tại cho tất cả các cặp. Các lệnh mở đến từ openOrders, yêu cầu địa chỉ của bạn.
Các điểm cuối khác bao gồm:
- userState: Truy xuất vị thế, ký quỹ và số dư.
- fundingHistory: Hiển thị tỷ lệ tài trợ theo thời gian.
- l2Book: Cung cấp sổ lệnh cấp 2 cho một đồng tiền.
Bạn gửi các yêu cầu POST với phần thân JSON như {"type": "meta"} đến /info. Các phản hồi sử dụng cấu trúc nhất quán, với "data" chứa kết quả.
Apidog giúp ích ở đây—bạn thiết lập một bộ sưu tập cho API Thông tin, thêm các yêu cầu cho từng loại và tham số hóa các đồng tiền hoặc địa chỉ. Việc trực quan hóa này hỗ trợ hiểu luồng dữ liệu.
Khi bạn thu thập dữ liệu, bạn chuyển sang API Giao dịch để thực hiện các giao dịch.
Sử dụng các điểm cuối API Giao dịch để giao dịch
API Giao dịch xử lý các hành động như đặt lệnh, hủy lệnh và sửa đổi. Bạn xác thực tất cả các yêu cầu bằng các payload đã ký.
Bạn đặt lệnh bằng cách xác định các tham số: chỉ số tài sản, phía, giá, kích thước, cờ chỉ giảm, và loại (giới hạn hoặc thị trường). Đối với lệnh bán giới hạn:
Trong Elixir (từ tài liệu SDK):
Hyperliquid.Api.Exchange.place_order(order)
Trong đó order là một bản đồ với a: tài sản, b: false (bán), p: "100", s: "0.1", r: false, t: {limit: {tif: "Gtc"}}.
Phản hồi bao gồm trạng thái và ID lệnh nếu thành công.
Bạn hủy lệnh bằng cách sử dụng tài sản và oid (ID lệnh):
Hyperliquid.Api.Exchange.cancel_order(asset, oid)
Đối với các lô, bạn sử dụng cancel_orders với một danh sách.
Các sửa đổi cũng tương tự: chỉ định oid và các tham số mới.
Các hành động khác bao gồm cập nhật đòn bẩy:
Hyperliquid.Api.Exchange.update_leverage(asset, is_cross, leverage)
Và các chuyển khoản, như spot_perp_transfer để chuyển tiền giữa các tài khoản.
Bạn xử lý lỗi bằng cách kiểm tra trạng thái phản hồi— "ok" cho thành công, nếu không thì chi tiết như không đủ ký quỹ.
Các ví dụ minh họa cách sử dụng thực tế. Chẳng hạn, bạn xây dựng một bot đặt lệnh mua khi giá giảm xuống dưới ngưỡng, sử dụng thông tin để kiểm tra giá và giao dịch để đặt lệnh.
Hơn nữa, bạn tích hợp WebSocket để cập nhật theo thời gian thực nhằm nâng cao khả năng phản hồi.
Tích hợp WebSocket để lấy dữ liệu thời gian thực
Bạn kết nối với WebSocket để nhận các luồng dữ liệu trực tiếp. Sử dụng wss://api.hyperliquid.xyz/ws cho mainnet hoặc tương đương testnet.
Bạn đăng ký bằng cách gửi JSON: {"method": "subscribe", "subscription": {"type": "trades", "coin": "SOL"}}.
Máy chủ phản hồi bằng xác nhận, sau đó đẩy các bản cập nhật như giao dịch mới.
Bạn xử lý các chủ đề như sổ lệnh, sự kiện người dùng và thông báo. Trong Python SDK, đặt skip_ws=False để bật.
Khả năng thời gian thực này cho phép bạn phản ứng ngay lập tức với những thay đổi của thị trường, chẳng hạn như điều chỉnh lệnh khi khớp.
Với các điểm cuối đã được đề cập, bạn sẽ xem xét sâu hơn về Python SDK.
Tận dụng Hyperliquid Python SDK
Python SDK trừu tượng hóa các cuộc gọi API thành các lớp. Bạn nhập Info cho các truy vấn và Exchange cho các hành động.
Bạn đặt một lệnh cơ bản như thế này (từ các ví dụ):
Đầu tiên, tải cấu hình:
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"]
Sau đó, khởi tạo Exchange:
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)
Đặt lệnh:
order_result = exchange.order("BTC", True, 0.02, 30000, {"limit": {"tif": "Gtc"}})
print(order_result)
Điều này mua 0.02 BTC với giá giới hạn 30.000 USD.
Bạn mở rộng điều này cho các tính năng nâng cao, như đặt lệnh theo lô hoặc hủy lệnh.
SDK cũng hỗ trợ các địa chỉ kho tiền cho các tài khoản được quản lý.
Các ví dụ trong kho lưu trữ bao gồm basic_order, user_state, và nhiều hơn nữa, minh họa các quy trình làm việc đầy đủ.
Khi bạn xây dựng, bạn kết hợp các phương pháp hay nhất để tối ưu hóa hiệu suất.
Các phương pháp hay nhất để sử dụng API Hyperliquid
Bạn giám sát giới hạn tốc độ để tránh bị điều tiết—Hyperliquid áp dụng giới hạn cho mỗi IP và mỗi tài khoản.
Bạn sử dụng testnet cho tất cả các hoạt động phát triển để ngăn ngừa tổn thất tài chính.
Xử lý lỗi bao gồm ghi nhật ký chi tiết và thử lại các lỗi tạm thời với độ trễ.
Để mở rộng quy mô, bạn nhóm các yêu cầu lại với nhau khi có thể, chẳng hạn như nhiều lần hủy.
Bảo mật mở rộng đến việc sử dụng ví API và các nguyên tắc đặc quyền tối thiểu.
Bạn cũng lập phiên bản mã của mình với các bản cập nhật SDK, vì Hyperliquid tuân theo quy ước lập phiên bản ngữ nghĩa.
Các công cụ như Apidog hỗ trợ tạo phản hồi giả cho các bài kiểm tra đơn vị.
Khắc phục sự cố sẽ đến tiếp theo khi các vấn đề phát sinh.
Khắc phục các sự cố API Hyperliquid phổ biến
Bạn gặp "Ký quỹ không đủ" khi tài sản thế chấp thấp—hãy gửi USDC để giải quyết.
Nếu "Không tìm thấy tài sản", hãy xác minh các chỉ số từ meta.
Lỗi xác thực xuất phát từ khóa không hợp lệ—hãy tạo lại và ủy quyền ví API.
Các vấn đề về mạng yêu cầu kiểm tra URL và sử dụng proxy nếu cần.
Bạn gỡ lỗi bằng Apidog bằng cách phát lại các yêu cầu không thành công.
Nhật ký từ SDK cung cấp dấu thời gian và payload để phân tích.
Với những mẹo này, bạn duy trì các tích hợp đáng tin cậy.
Các trường hợp sử dụng nâng cao với API Hyperliquid
Bạn xây dựng các bot giao dịch giám sát l2Book và đặt lệnh khi có sự mất cân bằng.
Các chiến lược liên quan đến tỷ lệ tài trợ từ lịch sử để tìm cơ hội chênh lệch giá.
Tài khoản phụ cho phép giao dịch riêng biệt: tạo bằng tên, chuyển tiền và giao dịch riêng.
Chuyển khoản kho tiền hỗ trợ các nhóm thanh khoản được chia sẻ.
Bạn mô phỏng bằng dữ liệu lịch sử từ API để kiểm tra ngược.
Tích hợp với Apidog cho phép gỡ lỗi cộng tác trong các nhóm.
Cuối cùng, bạn kết thúc bằng cách xem xét các cải tiến trong tương lai.
Kết luận: Nắm vững API Hyperliquid để giao dịch phi tập trung
Giờ đây bạn đã có kiến thức để sử dụng API Hyperliquid một cách hiệu quả. Từ thiết lập và xác thực đến các điểm cuối và SDK, hướng dẫn này trang bị cho bạn để xây dựng các ứng dụng tinh vi. Hãy nhớ rằng, những cải tiến nhỏ trong mã của bạn sẽ mang lại những cải thiện đáng kể về hiệu suất. Thử nghiệm trên testnet, tận dụng các công cụ như Apidog và luôn cập nhật tài liệu của Hyperliquid. Khi nền tảng phát triển, các kỹ năng của bạn sẽ giúp bạn tận dụng các tính năng mới.