Trước khi một bot có thể trade cho bạn, Freya cần một kết nối đến sàn giao dịch nơi tiền của bạn đang nằm — Binance, OKX, hoặc Bybit. Bạn không di chuyển tiền của mình và cũng không chia sẻ mật khẩu để làm điều này. Thay vào đó, bạn tạo một API key: một credential có giới hạn cho phép Freya đặt lệnh trade thay mặt bạn, trong khi tiền của bạn vẫn nằm trong chính tài khoản sàn của bạn.
Hướng dẫn này giải thích chính xác những quyền nào cần cấp (và những quyền nào tuyệt đối không được cấp), cách thêm key vào Freya, và phải làm gì nếu kết nối không xác thực được. Nếu bạn muốn hiểu bức tranh lớn hơn về lý do điều này an toàn, hãy đọc Tiền của Tôi Có An toàn trên Freya Finance Không? trước.
Điểm chính
- Bạn kết nối một sàn giao dịch bằng API key — một credential có giới hạn — chứ không phải bằng cách di chuyển tiền hay chia sẻ mật khẩu sàn của bạn.
- Key cần quyền Đọc (Reading) và quyền trading Spot và/hoặc Futures. Nó KHÔNG BAO GIỜ được có quyền rút tiền.
- Key của OKX yêu cầu một passphrase mà bạn tự đặt khi tạo key; Binance và Bybit thì không.
- Thêm key trong Freya tại Cài đặt → API Keys → Thêm API Key, và Freya sẽ xác thực 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 lý do — key không hợp lệ, IP chưa được whitelist, hoặc thiếu một quyền — và mỗi lỗi đều có cách khắc phục đơn giản.
Tổng quan Nhanh về các Bước
- Tạo một API key trên sàn của bạn với quyền đọc và trading, nhưng không có quyền rút tiền.
- Sao chép các credential — API key, secret, và (đối với OKX) passphrase.
- Thêm key vào Freya tại Cài đặt → API Keys → Thêm API Key, và chọn sàn của bạn.
- Để Freya xác thực nó — Freya kiểm tra kết nối và các quyền ngay lập tức.
- Khắc phục mọi lỗi mà Freya báo — Freya cho bạn biết chính xác điều gì sai nếu xác thực thất bại.
API Key Là Gì — và Freya Cần Những Quyền Nào
API key là một cặp credential (một key và một secret) cho phép một ứng dụng giao tiếp với tài khoản sàn của bạn theo cách có giới hạn. Bạn quyết định key đó được phép làm gì. Đối với Freya, chỉ bật:
- Đọc (Reading) — để Freya có thể xem số dư, vị thế, và trạng thái lệnh của bạn.
- Trading Spot và/hoặc Trading Futures — để bot của bạn có thể đặt các lệnh cần thiết. Hãy bật loại phù hợp với các bot bạn dự định chạy.
Freya đặt lệnh trade; nó không bao giờ cần di chuyển tiền ra khỏi tài khoản của bạn. Luôn để quyền rút tiền tắt trên key mà bạn kết nối. Đây là một quyền mà bạn kiểm soát trên sàn — với nó tắt, cả Freya lẫn bất kỳ ai có thể lấy được key đều không thể rút tiền của bạn. Đây là thói quen quan trọng nhất khi kết nối bất kỳ nền tảng bot nào.
Bước 1: Tạo một API Key trên Sàn của Bạn
Trong mục quản lý API của sàn, hãy tạo một API key mới:
- Binance — tạo key trong API Management, bật quyền đọc và trading Spot và/hoặc Futures, và để quyền rút tiền tắt.
- OKX — tạo key và đặt một passphrase (bạn sẽ cần nó trong Freya); bật quyền đọc và trading, không bật rút tiền.
- Bybit — tạo key với quyền đọc và trading cho các sản phẩm bạn sẽ sử dụng, và để quyền rút tiền tắt.
Nếu sàn của bạn cung cấp whitelist IP, đó là một thói quen tốt để giới hạn key vào các địa chỉ IP của Freya. Nếu bạn làm vậy, hãy đảm bảo whitelist các IP của Freya, nếu không kết nối sẽ bị từ chối (xem bảng lỗi bên dưới).
Khi bạn tạo key, sàn sẽ hiển thị secret một lần duy nhất. Hãy sao chép nó ngay lập tức và giữ an toàn. Nếu bạn làm mất nó, bạn không thể khôi phục — bạn sẽ phải xóa key và tạo một cái mới.
Bước 2: Thêm Key vào Freya
Trong Freya, vào Cài đặt → API Keys và chọn Thêm API Key. Sau đó:
- Chọn sàn của bạn (Binance, OKX, hoặc Bybit).
- Dán API key và secret. Đối với OKX, hãy nhập thêm passphrase bạn đã đặt.
- Đặt tên cho key để bạn có thể nhận ra nó sau này.
Bạn có thể kết nối nhiều hơn một sàn, và quản lý hoặc xóa các key của mình từ chính trang này bất cứ lúc nào.
Bước 3: Freya Xác thực Key của Bạn
Ngay khi bạn thêm key, Freya kiểm tra kết nối và các quyền — không cần đoán mò. Nếu mọi thứ đều chính xác, key được xác minh và sẵn sàng sử dụng. Nếu có điều gì đó sai, Freya hiển thị một thông báo rõ ràng giải thích chính xác cần khắc phục điều gì.
Hiểu về các Lỗi Xác thực
Nếu xác thực thất bại, hãy đối chiếu thông báo mà Freya hiển thị với cách khắc phục bên dưới:
| Freya hiển thị gì | Nó có nghĩa là gì | Cách khắc phục |
|---|---|---|
| API Key không hợp lệ | Key đã bị sao chép sai hoặc bị xóa trên sàn | Sao chép lại API key chính xác, hoặc tạo một cái mới |
| Secret Key không hợp lệ | Secret không khớp với key | Sao chép lại secret; nếu bạn làm mất nó, hãy tạo một key mới |
| Địa chỉ IP chưa được Whitelist | Key bị giới hạn theo IP và địa chỉ của Freya không được cho phép | Whitelist các IP của Freya trên key, hoặc gỡ bỏ giới hạn IP |
| Thiếu Quyền | Key thiếu quyền đọc hoặc trading | Bật quyền đọc và trading Spot/Futures trên key |
| Quyền Đọc đã bị Vô hiệu hóa | Freya không thể đọc tài khoản của bạn | Bật quyền đọc/xem trên key |
| Quyền Spot/Futures đã bị Vô hiệu hóa | Key không thể đặt các lệnh mà bot của bạn cần | Bật loại trading (Spot hoặc Futures) phù hợp với bot của bạn |
| Kết nối Thất bại | Một sự cố tạm thời về mạng hoặc sàn | Chờ một lát và thử thêm key lại |
Freya cũng sẽ đánh dấu một key đang ở chế độ "Không giới hạn" (Unrestricted) — nghĩa là nó không có giới hạn IP. Vì sự an toàn của bạn, Freya yêu cầu bạn bật giới hạn IP và thêm địa chỉ mà nó hiển thị trước khi key có thể được lưu. Chỉ bật quyền đọc và trading (không bao giờ rút tiền), và giới hạn key vào IP của Freya. (Tìm hiểu thêm về các lỗi kết nối tại Không Kết nối Được Sàn của Bạn?.)
Một Lưu ý về Bảo mật
Kết nối này an toàn theo thiết kế, nhưng một vài thói quen sẽ giữ cho nó luôn như vậy:
- Rút tiền luôn tắt — Freya không bao giờ cần nó.
- Sử dụng whitelist IP khi sàn của bạn hỗ trợ.
- Một key, một mục đích — và xóa các key bạn không còn dùng nữa.
Để hiểu đầy đủ về cách tiền và key của bạn được bảo vệ, hãy xem Tiền của Tôi Có An toàn trên Freya Finance Không? và Bảo mật API Sàn Giao dịch & Giảm thiểu Rủi ro.
Các Câu hỏi Thường gặp
Freya cần những quyền nào trên API key của tôi?
Quyền đọc (để xem số dư, vị thế, và lệnh của bạn) và trading Spot và/hoặc Futures (để đặt lệnh cho bot của bạn). Hãy bật loại trading phù hợp với các bot bạn sẽ chạy. Freya không bao giờ cần quyền rút tiền, vì vậy hãy luôn để quyền đó tắt.
Freya có cần quyền để rút tiền của tôi không?
Không. Freya chỉ đặt và quản lý các lệnh trade; nó không thể và không nên có khả năng di chuyển tiền ra khỏi sàn của bạn. Luôn để quyền rút tiền tắt trên key mà bạn kết nối — đó là một quyền mà bạn kiểm soát trên sàn.
Tại sao Freya lại báo "Địa chỉ IP chưa được Whitelist"?
API key của bạn bị giới hạn vào các địa chỉ IP cụ thể, và địa chỉ của Freya không nằm trong danh sách. Hoặc thêm các địa chỉ IP của Freya vào whitelist của key trên sàn của bạn, hoặc gỡ bỏ giới hạn IP khỏi key. Sau khi cập nhật, hãy thêm key vào Freya lại.
Tại sao lại báo "API Key không hợp lệ" hoặc "Secret Key không hợp lệ"?
Thường thì key hoặc secret đã bị sao chép sai, hoặc key đã bị xóa hoặc tạo lại trên sàn. Hãy sao chép lại chính xác cả hai giá trị. Vì secret chỉ được hiển thị một lần duy nhất khi bạn tạo key, nếu bạn không còn nó nữa, hãy xóa key trên sàn và tạo một cái mới.
Passphrase là gì, và tại sao OKX lại yêu cầu nó?
API key của OKX bao gồm một passphrase mà bạn tự đặt khi tạo key — đó là một credential bổ sung đi kèm với key và secret. Hãy nhập cùng một passphrase đó trong Freya khi thêm một key OKX. Binance và Bybit không sử dụng passphrase.
Tôi có thể kết nối nhiều hơn một sàn không?
Có. Bạn có thể thêm API key cho Binance, OKX, và Bybit, và quản lý hoặc xóa chúng bất cứ lúc nào từ Cài đặt → API Keys.
Đưa API key cho Freya có an toàn không?
Có, khi key được thiết lập đúng cách — chỉ đọc và trading, không rút tiền, và whitelist IP ở nơi có thể. Tiền của bạn vẫn nằm trong chính sàn của bạn, và key bạn chia sẻ không thể di chuyển chúng. Để hiểu đầy đủ, hãy xem Tiền của Tôi Có An toàn trên Freya Finance Không?.
Freya hỗ trợ những sàn nào?
Freya hiện kết nối với Binance, OKX, và Bybit (spot và futures). Nhiều sàn hơn có thể được thêm vào theo thời gian. Bạn trade trên bất kỳ sàn nào trong số này mà bạn kết nối — tiền của bạn và các thị trường có sẵn vẫn nằm trên sàn đó.
Tôi có thể trade những coin hoặc trading pair nào?
Các pair có sẵn đến từ chính danh sách niêm yết của sàn bạn kết nối, không phải một danh sách riêng của Freya — vì vậy nếu sàn của bạn niêm yết một pair (ví dụ, BTC/USDT, ETH/USDT), bạn có thể xây dựng một bot trên nó. Hầu hết việc trading đều lấy USDT làm đồng tiền định giá (quote currency). Nếu một sàn hủy niêm yết một pair, nó sẽ ngừng có thể trade được ở đó.