Kết nối Bybit (tạo API key)

API key là cách AlphaSet đặt lệnh thay bạn trên tài khoản Bybit của bạn. Quan trọng: key này chỉ cho phép giao dịch, không bao giờ cho phép rút tiền.

Tiền của bạn luôn nằm trên sàn của bạn. AlphaSet không bao giờ giữ tài sản của bạn. Bạn có thể thu hồi key bất cứ lúc nào - Engine sẽ dừng ngay.

Trước khi bắt đầu

• Bạn cần một tài khoản Bybit đã xác minh (KYC), dùng Tài khoản giao dịch hợp nhất (Unified Trading Account).
• Vốn tối thiểu cho Alpha Crypto: $500 trong số dư giao dịch.
• Lưu ý: Engine quản lý toàn bộ số dư giao dịch của tài khoản kết nối, tới đúng hạn mức (cap) của gói - phần vượt cap nằm yên, không phí. Muốn giữ riêng một phần vốn, hãy để phần đó ở tài khoản Funding hoặc một tài khoản riêng.

Bước 1 - Mở trang API Keys trên Bybit

Đăng nhập Bybit → bấm icon Tài khoản ở góc trên bên phải → chọn API Keys. Bấm Create New Key → chọn loại System-generated API Keys. Đặt tên dễ nhớ, ví dụ "AlphaSet".

🖼️ [IMAGE PLACEHOLDER] Ảnh: menu Tài khoản trên Bybit, khoanh đỏ mục "API Keys" và nút "Create New Key". Marketing thay ảnh thật sau.

Bước 2 - Cấp quyền giao dịch, KHÔNG quyền rút

Cấu hình quyền cho key như sau:

• ✅ Chọn chế độ Read-Write.
• ✅ Bật Unified Trading - Orders, Positions, Trade (để Engine vào/thoát vị thế).
• ✅ Bật Assets - Convert, Exchange History (để Engine đọc và đối soát số dư).
• ❌ KHÔNG tích quyền rút tiền (Withdraw) và KHÔNG tích chuyển tiền (Transfer).

Đây là điểm quan trọng nhất. AlphaSet chỉ cần quyền đặt lệnh. Nếu key có quyền rút tiền, AlphaSet sẽ từ chối kết nối để bảo vệ bạn.

🖼️ [IMAGE PLACEHOLDER] Ảnh: trang tạo API key của Bybit, chọn Read-Write, tích Unified Trading (Orders/Positions/Trade) và Assets (Convert/Exchange History), ô Withdraw để trống. Khoanh đỏ ô Withdraw đang TẮT.

Bước 3 - (Khuyến nghị) Whitelist IP

Để tăng bảo mật, dán danh sách IP tin cậy của AlphaSet (hiển thị trong app khi bạn kết nối) vào ô "Only IPs with permissions granted are allowed to access the OpenAPI". Trên Bybit, các IP cách nhau bằng dấu phẩy. Khi đã whitelist, chỉ AlphaSet mới dùng được key này - kể cả khi key bị lộ, người khác cũng không dùng được.

🖼️ [IMAGE PLACEHOLDER] Ảnh: ô nhập Trusted IP trên Bybit với danh sách IP của AlphaSet, mỗi IP cách nhau bằng dấu phẩy.

Bước 4 - Lưu API Key và Secret Key

Bấm Submit. Bybit hiện API Key và Secret Key. Lưu ý: Secret Key chỉ hiện một lần - sao chép và giữ an toàn. Nếu mất, bạn phải xóa key cũ và tạo lại.

Bước 5 - Dán vào AlphaSet và Test Connection

Quay lại AlphaSet → màn hình Kết nối sàn → chọn Bybit → Nhập API key thủ công → dán API Key và Secret Key → nhấn Test Connection (Kiểm tra kết nối).

AlphaSet sẽ tự kiểm tra key đọc được số dư, có quyền giao dịch, và KHÔNG có quyền rút. Khi báo kết nối thành công, bạn xong bước này. API key được mã hóa AES-256 khi lưu, chỉ giải mã lúc thực thi lệnh.

🖼️ [IMAGE PLACEHOLDER] Ảnh: màn hình AlphaSet "Kết nối Bybit" với 2 ô nhập API Key / Secret Key và nút "Test Connection", trạng thái "Kết nối thành công" màu mint.

Mẹo nhanh

• Trên Bybit, gói Air kết nối 1 sàn × 1 Alpha, Plus tối đa 2 sàn × 2 Alpha. Pro/Max kết nối không giới hạn.
• Bybit tự vô hiệu hóa API key sau 3 tháng nếu bạn không gắn whitelist IP - whitelist giúp key sống lâu hơn.