Kết nối sàn HYPERLIQUID

Hyperliquid là sàn giao dịch on-chain: bạn đăng nhập bằng ví crypto hoặc email, và tài khoản gắn với một địa chỉ ví. Bybot giao dịch trên tài khoản Hyperliquid của bạn thông qua API Wallet — một khóa riêng có thể đặt và hủy lệnh thay cho ví của bạn. Tiền vẫn nằm trong tài khoản Hyperliquid của bạn, và API Wallet không thể rút hay chuyển tiền. Việc thiết lập mất khoảng 10 phút.

Trong Bybot, bạn thêm hai thông tin: địa chỉ ví chính và khóa riêng tư của API Wallet. Không bao giờ dán khóa riêng tư hay cụm từ khôi phục (seed phrase) của ví chính — Bybot không cần chúng và sẽ từ chối khóa đó.

1. Đăng nhập Hyperliquid

Mở app.hyperliquid.xyz và bấm “Connect”. Đăng nhập bằng ví crypto hoặc bằng email. Nếu dùng ví, sau đó bấm “Enable Trading” và ký yêu cầu trong ví — không mất phí gas.

2. Nạp USDC

Bấm “Deposit”, chọn USDC trên Arbitrum và làm theo hướng dẫn trên màn hình.

3. Đưa USDC sang dùng cho spot

Bybot giao dịch trên thị trường spot của Hyperliquid. Hãy làm một trong hai cách:

• chuyển tài khoản sang chế độ Unified account — khi đó một số dư USDC dùng chung cho spot và hợp đồng vĩnh cửu, không cần chuyển tiền;
• hoặc ở chế độ tiêu chuẩn, chuyển USDC từ Perps sang Spot: ở chế độ này tiền nạp vào số dư Perps.

Chế độ Portfolio margin không được hỗ trợ: ở chế độ này Hyperliquid tự động vay khi thiếu số dư, nên bot có thể mua bằng tiền vay. Bybot sẽ từ chối làm việc với tài khoản như vậy.

4. Mở trang API

Trên menu trên cùng, mở “More” và chọn “API”.

5. Tạo API Wallet có tên

1. Nhập tên cho API Wallet, ví dụ bybot, rồi bấm “Generate”.
2. Bấm “Authorize API Wallet”.

3. Trong cửa sổ “Authorize API Wallet”, bấm “MAX” ở ô “Days Valid” — API Wallet sẽ có hiệu lực lâu nhất, tối đa 180 ngày.
4. Sao chép Private Key bằng nút sao chép và lưu ở nơi an toàn.
5. Bấm “Authorize”. Nếu bạn đăng nhập bằng ví, hãy xác nhận trong ví.

6. Sao chép địa chỉ ví

Bấm nút tài khoản ở góc trên bên phải và sao chép địa chỉ bằng nút sao chép. Đây là địa chỉ ví chính — địa chỉ Bybot cần. Đừng dùng địa chỉ API Wallet ở bước 5.

7. Thêm khóa vào Bybot

Trong Bybot, mở Cài đặt (“Settings”) → Khóa API (“API Keys”) và bấm Thêm khóa (“Add key”). Chọn HYPERLIQUID và điền hai trường:

Bấm Lưu (“Save”). Bybot kiểm tra khóa qua dữ liệu công khai của Hyperliquid: API Wallet phải thuộc ví này và có tên, còn chế độ tài khoản phải được hỗ trợ.

8. Kiểm tra khóa

Trong danh sách khóa, bấm ”⋯” trên thẻ Hyperliquid và chọn Kiểm tra khóa (“Check key”). Bybot xác nhận API Wallet vẫn còn kết nối với ví của bạn. Cột Hạn API Wallet (“API Wallet expiry”) cho biết khi nào nó hết hạn.

9. Trước khi tạo bot

• Bybot giao dịch 5 cặp với USDC: BTC, ETH, SOL, ZEC và HYPE. Trên Hyperliquid, BTC, ETH, SOL và ZEC là các đồng coin bọc của Unit (UBTC, UETH, USOL, UZEC).
• Trên Hyperliquid, bạn có thể chạy một bot DCA cho mỗi cặp.
• Lệnh tối thiểu là 10 USDC.

Sau đó làm theo hướng dẫn Tạo bot.

Thời hạn của API Wallet

Bạn tự chọn thời hạn API Wallet khi tạo, tối đa 180 ngày. Bybot sẽ nhắc trước khi hết hạn. Khi hết hạn, bot ngừng giao dịch. Để tiếp tục, hãy tạo API Wallet có tên mới trên Hyperliquid, xóa khóa cũ trong Bybot và thêm khóa mới.

Giới hạn thao tác của Hyperliquid

Hyperliquid giới hạn số thao tác (đặt và hủy lệnh) trên mỗi ví: 10.000 lúc đầu, cộng thêm 1 thao tác cho mỗi $1 khối lượng giao dịch của ví. Khi hết giới hạn, giao dịch không dừng nhưng chậm lại.

Bybot không thể mua thêm thao tác: Hyperliquid chỉ chấp nhận giao dịch mua này khi có chữ ký của ví chính và trừ phí từ ví chính. Nếu hết giới hạn, hãy chờ khối lượng giao dịch tăng hoặc tự mua thêm thao tác từ ví chính.

Phí và số dư lẻ

• Phí spot của Hyperliquid là 0.07% cho lệnh taker và 0.04% cho lệnh maker ở cấp cơ bản.
• Khi mua, phí được trừ bằng đồng coin bạn mua (với BTC là UBTC); khi bán, phí trừ bằng USDC. Vì vậy số coin bạn nhận được ít hơn một chút so với lượng đã mua.
• Số dư lẻ có giá trị dưới lệnh tối thiểu 10 USDC không thể bán và nằm lại trong tài khoản dưới dạng “bụi”.

Giao dịch thủ công từ cùng ví

Đừng giao dịch thủ công trên cặp mà bot đang chạy. Hyperliquid không cho một ví giao dịch với chính nó: khi lệnh thủ công của bạn khớp với lệnh của bot, sàn sẽ hủy lệnh đã nằm sẵn trong sổ lệnh — thường là lệnh của bot. Bot sẽ thấy đó là một lệnh bị hủy.

Bảo mật khóa

• Không thể rút tiền. API Wallet có thể đặt và hủy lệnh, nhưng không thể rút hay chuyển tiền — Hyperliquid từ chối các yêu cầu đó ngay cả khi khóa bị lộ.
• Không bao giờ dán khóa riêng tư hay seed phrase của ví chính. Bybot chỉ cần khóa API Wallet và sẽ không bao giờ hỏi seed phrase của bạn.
• Dùng ví riêng cho bot. API Wallet có thể giao dịch trên toàn bộ tài khoản Hyperliquid, kể cả hợp đồng vĩnh cửu.
• Một ví — một tài khoản Bybot. Một địa chỉ ví chỉ có thể kết nối với một tài khoản Bybot.
• Nếu bạn ngừng dùng bot, hãy dừng các bot Hyperliquid, xóa khóa trong Bybot, rồi thu hồi API Wallet trên app.hyperliquid.xyz → API. Cho đến khi thu hồi, API Wallet vẫn có thể giao dịch trên tài khoản của bạn.

Sự cố thường gặp

“Hyperliquid không xác nhận khóa”. Kiểm tra địa chỉ ví, khóa riêng tư của API Wallet và API Wallet chưa hết hạn.

“Đây là khóa riêng tư của ví chính”. Bạn đã dán khóa của ví chính. Hãy tạo API Wallet có tên (bước 5) và dán khóa riêng tư của nó.

“API Wallet phải có tên”. Tạo API Wallet có tên trên trang API và dán khóa của nó.

“Chế độ tài khoản Hyperliquid này không được hỗ trợ”. Tài khoản đang ở chế độ Portfolio margin. Hãy chuyển sang Unified account hoặc chế độ tiêu chuẩn.

“Ví Hyperliquid này đã kết nối với tài khoản khác”. Một ví chỉ có thể kết nối với một tài khoản Bybot.

Không xóa được khóa. Hãy dừng các bot Hyperliquid trước, rồi xóa khóa.

Bot không mua dù đã nạp USDC. Ở chế độ tiêu chuẩn tiền nạp vào số dư Perps. Hãy chuyển USDC sang Spot hoặc bật Unified account.

Bot chạy chậm. Có thể ví đã dùng hết giới hạn thao tác của Hyperliquid — xem mục “Giới hạn thao tác của Hyperliquid” ở trên.

Tài liệu chính thức của sàn: Hyperliquid Docs.