Kết nối API sàn giao dịch

Tạo một API key chỉ đọc trên sàn rồi dán vào Blave để xem số dư và vị thế trên các sàn trong cùng một trang. Blave không thể giao dịch hay rút tiền bằng key này.

Kết nối API sàn giao dịch là trao cho Blave một API key chỉ đọc do bạn tạo trên sàn, để Studio đọc được số dư và vị thế của bạn. Hiện hỗ trợ 6 sàn: Binance, OKX, BingX, Bitget, Bitunix và Bybit. Key chỉ cần quyền đọc — với key này, Blave không thể đặt lệnh hay rút tiền. Tạo key trên sàn, rồi dán vào trang API của Blave là xong.

Kết nối xong bạn xem được gì?

• Trang Danh mục: gộp mọi sàn đã kết nối — biến động giá trị tài khoản, hiệu suất, tỷ lệ phân bổ, cùng số dư và mức rủi ro của từng coin theo sàn và ví.
• Cửa sổ chọn mã trên biểu đồ Studio có thêm thẻ "Danh mục" liệt kê các coin bạn đang nắm giữ, đổi biểu đồ không cần tìm kiếm lại.
• Các tài khoản Blave đọc: Binance gồm Spot, hợp đồng tương lai USDⓈ-M và Simple Earn linh hoạt; OKX là tài khoản giao dịch; BingX gồm Spot và hợp đồng vĩnh cửu; Bitget gồm Spot và hợp đồng tương lai trên tài khoản cổ điển; Bitunix gồm Spot và hợp đồng tương lai; Bybit là Tài khoản giao dịch hợp nhất. Cả sáu sàn đều không đọc tài khoản Funding — coin để trong tài khoản Funding sẽ không hiện trên trang Danh mục.

Đưa API key cho Blave có an toàn không?

• Chỉ cấp quyền đọc. Quyền được sàn gắn vào chính key: ai giữ key chỉ đọc cũng chỉ xem được tài khoản, không thể đặt lệnh, chuyển hay rút tiền.
• Blave dùng key này để định kỳ đọc số dư và vị thế của bạn, tạo dữ liệu cho trang Danh mục.
• Hộp thoại kết nối có kèm Chính sách kết nối API: Blave thu thập và phân tích dữ liệu của tài khoản đã kết nối dưới dạng ẩn danh để cải thiện sản phẩm. Khi không muốn Blave đọc nữa, hãy gỡ key theo các bước xóa.

Tạo API key chỉ đọc trên từng sàn như thế nào?

Quy trình ở các sàn gần như giống nhau: vào trang quản lý API của tài khoản, tạo key mới, chỉ cấp quyền đọc, hoàn tất xác minh bảo mật và sao chép key. Hai quy tắc áp dụng cho mọi sàn:

• Để trống danh sách IP cho phép. Nếu gắn IP của bạn, máy chủ của Blave không nằm trong danh sách và không đọc được dữ liệu.
• Chỉ đọc. Không bật quyền giao dịch, chuyển tiền hay rút tiền.

Binance｜OKX｜BingX｜Bitget｜Bitunix｜Bybit

Tên nút và trường bên dưới theo trang web tiếng Anh của từng sàn; ở ngôn ngữ khác hoặc sau khi sàn đổi giao diện, tên có thể khác.

Binance

Trước khi tạo key, Binance yêu cầu bật 2FA, nạp một khoản bất kỳ vào Ví Spot và xác minh danh tính. Hãy dùng key do hệ thống tạo (HMAC); key RSA/Ed25519 tự tạo sẽ không kết nối được. Khi kết nối, Blave kiểm tra tài khoản hợp đồng tương lai USDⓈ-M, nên tài khoản chưa mở hợp đồng tương lai sẽ không kết nối được.

1. Đăng nhập Binance trên web, nhấp biểu tượng hồ sơ → "Account" → "API Management", rồi nhấp "Create API". Trên app: "More" → "Other" → "API Management".
2. Chọn "System-generated", nhập nhãn Blave và hoàn tất 2FA.
3. Kiểm tra quyền chỉ có "Enable Reading" (mặc định). Không tick quyền nào khác và không đặt giới hạn IP.
4. Sao chép API Key và Secret Key.

Hướng dẫn chính thức của Binance

OKX

1. Đăng nhập OKX trên web, vào "Profile" → "API and connections", rồi nhấp "Create API key".
2. Nhập tên API key (ví dụ Blave) và ở mục "Account" chọn tài khoản cho Blave đọc.
3. Ở "Permissions" chỉ tick "Read". Để trống danh sách địa chỉ IP cho phép.
4. Đặt Passphrase và ghi lại. OKX sẽ không hiển thị lại — nếu quên, bạn phải xóa key và tạo key mới. Bạn cần nó khi kết nối trên Blave.
5. Hoàn tất xác minh bảo mật, rồi sao chép API Key và Secret Key.

Hướng dẫn chính thức của OKX

BingX

Khi kết nối, Blave kiểm tra tài khoản hợp đồng vĩnh cửu, nên tài khoản chưa mở hợp đồng tương lai sẽ không kết nối được.

1. Đăng nhập BingX trên web, mở "API Management" trong trung tâm người dùng, rồi nhấp "Create API".
2. Nhập tên dễ nhận biết (ví dụ Blave) và hoàn tất xác minh bảo mật.
3. Chỉ giữ quyền đọc: tắt giao dịch spot, giao dịch hợp đồng tương lai, chuyển tiền đa năng, quản lý tài khoản phụ và rút tiền; để trống IP. BingX không xóa key chỉ đọc vì không hoạt động.
4. Sao chép API Key và Secret Key.

Mở trang quản lý API của BingX

Bitget

Hiện chỉ hỗ trợ tài khoản cổ điển. Key của Tài khoản giao dịch hợp nhất (UTA) sẽ báo "Invalid API." khi kết nối.

1. Đăng nhập Bitget trên web, mở "API Management" trong trung tâm cá nhân, rồi nhấp "Create New API".
2. Nhập Blave ở "Notes" và đặt API Passphrase. Ghi lại — bạn cần nó khi kết nối trên Blave.
3. Chọn quyền "Read-only" và không gắn IP.
4. Nhập mã xác minh email, SMS và Google, rồi sao chép API Key và Secret Key.

Hướng dẫn chính thức của Bitget

Bitunix

Khi kết nối, Blave kiểm tra tài khoản hợp đồng tương lai, nên tài khoản chưa mở hợp đồng tương lai sẽ không kết nối được.

1. Đăng nhập Bitunix, nhấp biểu tượng hồ sơ → "API Management", rồi nhấp "Create API".
2. Nhập Blave ở "Note" và chọn "Purpose" là "Bind Third-Party App" — quyền sẽ tự chuyển sang "Read-only". Nếu giao diện khác, điều quan trọng là chỉ cấp quyền đọc.
3. Hoàn tất xác minh bảo mật. API Key và Secret Key hiện trên màn hình — sao chép và lưu lại ngay.

Mở trang quản lý API của Bitunix

Bybit

Tài khoản mới có thể chưa tạo được key trong 48 giờ đầu. Hãy dùng key do hệ thống tạo (HMAC); key RSA/Ed25519 tự tạo sẽ không kết nối được. Key Bybit không gắn IP hết hạn sau 90 ngày — xem khi kết nối thất bại để gia hạn.

1. Mở trang web Bybit trên máy tính (không tạo được API key trên app), nhấp biểu tượng hồ sơ → "API" để vào trang "API Management".
2. Nhấp "Create New Key" và chọn "System-generated API Keys".
3. Chọn mục đích sử dụng theo màn hình và nhập tên Blave.
4. Chọn quyền "Read-Only" và chọn "No IP restriction".
5. Nhập mã Google 2FA, rồi sao chép API Key và Secret Key.

Hướng dẫn chính thức của Bybit

Dán key vào Blave

Kết nối thất bại thì làm gì?

• Hiện "Invalid API.": Blave không đọc được tài khoản bằng key này. Kiểm tra lần lượt: key sao chép thiếu hoặc thừa khoảng trắng; chọn nhầm sàn; Passphrase của OKX, Bitget bị thiếu hoặc sai; key Binance, Bybit là key RSA/Ed25519 tự tạo; tài khoản hợp đồng tương lai trên Binance, BingX, Bitunix chưa được mở.
• Key Bitget luôn báo "Invalid API.": nếu tài khoản Bitget của bạn là Tài khoản giao dịch hợp nhất (UTA), hiện chưa thể kết nối — Blave chỉ hỗ trợ tài khoản cổ điển.
• Hiện "The API has already been connected.": tài khoản sàn này đã được kết nối với một tài khoản Blave, có thể là một tài khoản khác của bạn. Xóa ở trang API của tài khoản đó trước, rồi kết nối lại.
• Bybit đang chạy bình thường rồi ngừng có dữ liệu: key Bybit không gắn IP hết hạn sau 90 ngày. Trên trang API Management của Bybit, nhấp chỉnh sửa ở cột "IP Address Added" của key, chọn "No IP restriction", gửi và xác minh — key giữ nguyên và được thêm 90 ngày tính từ lúc đó (FAQ chính thức của Bybit).

Xóa key như thế nào?

1. Trước tiên, ở thẻ "Sàn giao dịch" trên trang API của Blave, nhấp "Xóa" cạnh key và xác nhận.
2. Sau đó xóa cùng key đó trên trang quản lý API của sàn.

Giữ đúng thứ tự này. Nếu xóa trên sàn trước, bản ghi trên Blave sẽ không tự động bị gỡ.