Kết nối Bybit với Freya

Bybit là sàn giao dịch duy nhất nơi Freya có thể tự thiết lập kết nối cho bạn. Freya là một broker Bybit đã đăng ký, nghĩa là Bybit sẽ tự tạo API key ở phía họ, gắn đúng các quyền, và chuyển thẳng cho Freya — bạn không bao giờ nhìn thấy key, không bao giờ sao chép secret, và không bao giờ phải whitelist địa chỉ IP.

Con đường đó được gọi là Kết nối nhanh. Con đường cũ hơn, nơi bạn tự tạo key trên Bybit, vẫn tồn tại và vẫn hoạt động. Hướng dẫn này bao gồm cả hai, cộng thêm phải làm gì khi bạn cần thay key hoặc khi một kết nối thất bại.

Key Takeaways

Kết nối nhanh chỉ là một cú nhấp: bạn phê duyệt Freya trên Bybit, và cả key Spot lẫn Futures của bạn được thêm tự động.
Kết nối nhanh không cần whitelist IP — Bybit tự ràng buộc key với máy chủ của Freya, đó cũng là lý do key không hết hạn.
Kết nối thủ công vẫn hoạt động và là con đường duy nhất trên Binance và OKX.
Dù bạn dùng con đường nào, key không bao giờ có quyền rút tiền. Freya không thể di chuyển tiền của bạn.
Kết nối lần thứ hai không tạo bản trùng lặp — Bybit chỉ cấp một key cho mỗi nền tảng trên mỗi tài khoản, nên nó làm mới key bạn đang có.

Trước Khi Bắt đầu

Hai điều đáng kiểm tra trước.

Nạp tiền vào tài khoản bạn sắp kết nối. Một bot không thể mở vị thế trên số dư trống, và Freya vẫn sẽ vui vẻ kết nối một key chẳng có gì để trade. Nếu bạn dự định chạy bot futures, hãy đảm bảo tiền nằm trong tài khoản mà các bot của bạn sẽ sử dụng.

Dùng trình duyệt. Cả hai con đường đều hoạt động trên trình duyệt desktop và di động. Tự tạo API key bằng tay là việc chỉ làm được trên trình duyệt ở phía Bybit — ứng dụng di động của họ không có màn hình API key.

Kết nối nhanh

Đây là con đường chúng tôi khuyên dùng. Nó mất khoảng mười lăm giây nếu bạn đã đăng nhập sẵn vào Bybit.

Trong Freya, mở Cài đặt → API Keys và chọn Thêm API Key.
Chọn Bybit làm sàn. Tab Kết nối nhanh đã được chọn sẵn.
Chọn Kết nối với Bybit. Một tab Bybit sẽ mở ra.
Đăng nhập vào Bybit. Nếu bạn chưa có tài khoản, bạn có thể tạo ngay tại đó rồi quay lại — kết nối sẽ chờ bạn.
Xem lại và phê duyệt. Bybit cho bạn thấy chính xác Freya đang yêu cầu gì. Phê duyệt là bước duy nhất cấp bất kỳ quyền nào.
Tab tự đóng lại và các key của bạn xuất hiện trong Freya, sẵn sàng sử dụng.

Một lần phê duyệt bao gồm cả Spot và Futures. Bạn không phải lặp lại cho từng thị trường.

Điều Gì Diễn ra Phía Sau

Khi bạn phê duyệt, Bybit tạo một API key gắn với đăng ký broker của Freya và gửi thẳng đến máy chủ của Freya. Vì nó đến theo cách đó, nó không bao giờ đi qua trình duyệt, clipboard, hay ảnh chụp màn hình của bạn — vốn là những nơi API key thường bị rò rỉ nhất.

Bybit cũng tự ràng buộc key đó với máy chủ của Freya. Hai hệ quả mà bạn hưởng lợi:

Không cần whitelist IP. Không có gì để bạn sao chép hay dán vào cài đặt của Bybit.
Key không hết hạn. Một key bạn tự tạo bằng tay có thể hết hạn; key ràng buộc theo broker thì không.

Nếu Bạn Đổi Ý

Từ chối trên màn hình của Bybit là hoàn toàn an toàn. Không có gì được tạo trên Bybit và không có gì thay đổi trong Freya — bạn chỉ đơn giản thấy rằng việc ủy quyền chưa hoàn tất, và bạn có thể thử lại bất cứ khi nào muốn.

Đóng tab Bybit mà không quyết định cũng có tác dụng tương tự.

Thay thế một Key Bybit

Đôi khi bạn cần một key mới — bạn đã thu hồi key cũ trên Bybit, bạn chuyển sang một tài khoản Bybit khác, hoặc bộ phận hỗ trợ yêu cầu bạn kết nối lại.

Với Kết nối nhanh, chỉ cần kết nối lại. Mở Cài đặt → API Keys → Thêm API Key, chọn Bybit, và chọn Kết nối với Bybit như trước. Bybit chỉ cấp một key cho mỗi nền tảng trên mỗi tài khoản, nên việc kết nối lại làm mới key bạn đang có thay vì chồng thêm bản thứ hai. Các bot hiện có của bạn tiếp tục chạy trên credential đã được làm mới.

Nếu bạn đã xóa key ở phía Bybit trước, kết nối lại cũng chính là cách khắc phục — Bybit sẽ cấp một key mới khi bạn phê duyệt.

⚠️ Đừng xóa key Freya của bạn khi các bot đang chạy trừ khi bạn có ý định dừng chúng. Một bot đang chạy mà không có credential hoạt động sẽ không thể quản lý vị thế nó đã mở. Hãy dừng hoặc đóng các bot trước, rồi mới kết nối lại.

Kết nối thủ công

Dùng cách này nếu bạn muốn tự tạo key, hoặc nếu bạn đang kết nối một tài khoản phụ (sub-account) của Bybit.

Tạo Key trên Bybit

Đăng nhập Bybit trên trình duyệt và mở mục API của tài khoản.
Tạo một System-generated API key (key do hệ thống tạo).
Chọn API Transaction làm loại sử dụng — không phải chỉ đọc (read-only).
Cấp quyền Contract Trade và Spot Trade, cộng thêm quyền đọc.
Không bao giờ cấp quyền Rút tiền (Withdrawal). Freya không cần nó và không thể sử dụng nó.
Giới hạn key theo IP và nhập địa chỉ của Freya — modal sẽ hiển thị và cho bạn sao chép địa chỉ này.

⚠️ Bybit chỉ hiển thị secret key của bạn đúng một lần. Hãy sao chép nó trước khi đóng màn hình đó. Nếu bạn làm mất, key không thể khôi phục — bạn phải tạo một cái mới.

Thêm Key vào Freya

Trong Freya, mở Cài đặt → API Keys → Thêm API Key và chọn Bybit.
Chuyển sang tab Kết nối thủ công.
Dán API key và secret, và đặt cho key một cái tên bạn sẽ nhận ra sau này.
Chọn Thêm API Key. Freya xác thực kết nối và các quyền ngay lập tức.

Nếu xác thực thất bại, Freya cho bạn biết chính xác phần nào thất bại thay vì một lỗi chung chung. Xem Không Kết nối Được? Giải thích các Lỗi API Key của Sàn để biết từng thông báo và cách khắc phục.

Các Câu hỏi Thường gặp

Tôi nên dùng con đường nào?

Kết nối nhanh, trừ khi bạn có lý do cụ thể để không dùng. Nó ít bước hơn, không thể sai vì lỗi gõ nhầm, và loại bỏ hoàn toàn việc whitelist IP. Kết nối thủ công tồn tại cho những người muốn tự tạo và tự kiểm soát key, và cho các tài khoản phụ.

Kết nối nhanh có cấp cho Freya nhiều quyền truy cập hơn một key thủ công không?

Không. Cả hai con đường đều tạo ra một key trading với cùng phạm vi: đọc và trade, không bao giờ rút tiền. Khác biệt nằm ở ai thực hiện việc thiết lập, không phải key có thể làm gì.

Tôi có cần whitelist địa chỉ IP không?

Chỉ với Kết nối thủ công. Với Kết nối nhanh, Bybit tự động ràng buộc key với máy chủ của Freya, đó cũng là lý do key đó không hết hạn.

Tôi có thể kết nối Bybit Spot và Futures riêng biệt không?

Với Kết nối nhanh bạn không cần phải làm vậy — một lần phê duyệt thiết lập cả hai. Với Kết nối thủ công, bạn có thể thêm các key riêng nếu muốn tách biệt hai thị trường.

Điều gì xảy ra nếu tôi kết nối hai lần?

Không có gì hỏng và không có gì bị trùng lặp. Bybit chỉ cấp một key cho mỗi nền tảng trên mỗi tài khoản, nên lần kết nối thứ hai làm mới key hiện có.

Tôi có thể dùng Kết nối nhanh với tài khoản phụ của Bybit không?

Hãy dùng Kết nối thủ công cho các tài khoản phụ. Kết nối nhanh được thiết kế cho tài khoản Bybit chính của bạn.

Key của tôi có an toàn không khi đã nằm trong Freya?

Nó được mã hóa ngay khoảnh khắc nó đến nơi và không bao giờ được hiển thị lại — không cho bạn, không cho bộ phận hỗ trợ. Xóa nó trong Freya sẽ gỡ bỏ credential được lưu trữ, và thu hồi nó trên Bybit sẽ cắt quyền truy cập từ phía bên kia. Để có bức tranh đầy đủ, xem Tiền của Tôi Có An toàn trên Freya Finance Không?.

Freya báo key của tôi không hợp lệ ngay sau khi kết nối. Tại sao?

Thường gặp nhất là key được tạo mà không có quyền trading, hoặc nó bị giới hạn vào một IP không phải của Freya. Với Kết nối nhanh, cả hai điều này đều không thể xảy ra, nên kết nối lại qua con đường đó thường là cách khắc phục nhanh nhất.