Thiết lập API Key WEEX: Cách kết nối an toàn với nền tảng bên thứ ba

Để kết nối nền tảng bên thứ ba với WEEX, hãy tạo API key WEEX trong mục Tài khoản, sau đó vào Quản lý API, chỉ cấp những quyền mà nền tảng cần, rồi nhập API key, secret key và passphrase vào nền tảng đó. Nếu nền tảng là nhà môi giới WEEX đã đăng ký, nút "Đăng nhập bằng WEEX" có thể thực hiện việc này mà bạn không cần trực tiếp xử lý key. Hướng dẫn này trình bày cả hai cách kết nối, cách đặt lệnh đầu tiên an toàn, những lỗi thường gặp và các cài đặt bảo mật quyết định mức độ thiệt hại nếu key bị lộ. Các bước và giới hạn được cập nhật đến ngày 7 tháng 10 năm 2026.

Kết nối nhanh hay tạo API Key WEEX thủ công: Nên chọn cách nào?

Hãy dùng Kết nối nhanh nếu nền tảng có hỗ trợ, còn lại hãy tạo key thủ công.

Kết nối nhanh là tính năng cấp quyền OAuth của WEEX, được công bố ngày 3 tháng 8 năm 2026. Bạn nhấp vào "Đăng nhập bằng WEEX" trên nền tảng đối tác, chuyển đến trang cấp quyền của WEEX, xem lại các quyền (giao dịch và quyền đọc được cài đặt sẵn), rồi xác nhận. Sau đó, WEEX tạo API key và gửi key đến hệ thống máy chủ của nền tảng. Bạn không bao giờ nhìn thấy hoặc sao chép key này. WEEX cho biết quá trình này mất dưới 10 giây.

Có hai điều cần lưu ý. Trang cấp quyền nằm trên www.weex.com, vì vậy hãy kiểm tra thanh địa chỉ trước khi chấp thuận bất kỳ thao tác nào. Ngoài ra, quy tắc OAuth của WEEX chỉ cho phép một key cho mỗi người dùng trên từng nền tảng bên thứ ba, nên muốn kết nối lại cùng một nền tảng, trước tiên bạn phải xóa key cũ.

Key tạo thủ công tương thích với mọi phần mềm hỗ trợ WEEX, bao gồm cả các công cụ không phải nhà môi giới, đồng thời cho phép bạn toàn quyền kiểm soát quyền hạn và cấu hình ràng buộc IP.

Cách tạo API Key WEEX từng bước

1. Đăng nhập WEEX trên web. Vào mục Tài khoản, sau đó chọn Quản lý API rồi nhấn Tạo API Key. Trang API WEEX cũng có nút Tạo API để mở cùng màn hình.
2. Đặt tên key theo tên nền tảng sẽ sử dụng key đó.
3. Tạo passphrase chỉ gồm chữ cái và chữ số. FAQ của WEEX cho biết hệ thống không chấp nhận ký tự đặc biệt. Bạn không thể khôi phục hoặc thay đổi passphrase sau này.
4. Chọn quyền. Key mới mặc định chỉ có quyền Đọc. Chỉ thêm quyền Spot hoặc Futures nếu nền tảng sẽ đặt lệnh trên thị trường đó. Hai quyền giao dịch này độc lập với nhau, vì vậy bot Futures không cần quyền truy cập Spot.
5. Ràng buộc địa chỉ IP nếu nền tảng công bố các địa chỉ mà nền tảng dùng để kết nối.
6. Hoàn tất xác minh bảo mật.
7. Sao chép API key, secret key và passphrase rồi lưu ở nơi an toàn. Hướng dẫn thiết lập của cả HaasOnline và KoinX đều cảnh báo rằng secret chỉ được hiển thị một lần.

Có ba giới hạn bạn nên biết. Theo hướng dẫn chuẩn bị tích hợp của WEEX, mỗi tài khoản có thể tạo tối đa 10 nhóm API key. Key mới tạo hoặc vừa chỉnh sửa cần khoảng 15 phút để có hiệu lực ở mọi nơi. Ngoài ra, hướng dẫn của KoinX cho biết WEEX có thể yêu cầu điền bảng câu hỏi kích hoạt API và gửi email xác nhận trước khi key hoạt động, vì vậy key gặp lỗi trong vài giờ đầu không nhất thiết là do cấu hình sai.

Ràng buộc key và đặt lệnh đầu tiên

Các nền tảng gọi ba giá trị này bằng những tên khác nhau. HaasOnline, nền tảng đã bổ sung WEEX ngày 22 tháng 8 năm 2026, là một ví dụ điển hình: mở Exchange Accounts, chọn WEEX Spot hoặc Futures, nhập API key vào ô public key và secret vào ô private key, thêm passphrase rồi nhấn nút kiểm tra key. "Access key" và "public key" đều có nghĩa là API key.

Trước khi để chiến lược giao dịch chạy, hãy đặt thử một lệnh thủ công thông qua nền tảng:

1. Chọn một cặp có thanh khoản tốt và nhập khối lượng nhỏ nhất mà nền tảng cho phép, dưới dạng lệnh giới hạn đặt cách xa mức giá hiện tại.
2. Kiểm tra xem lệnh có xuất hiện trong mục lệnh đang mở ngay trên WEEX hay không.
3. Hủy lệnh trên nền tảng rồi xác nhận lệnh đã biến mất trên WEEX.

Quy trình thử đi thử lại này xác nhận key, quyền và ánh xạ cặp giao dịch đều hoạt động, mà không tốn chi phí.

Nếu không thành công, nguyên nhân thường là một trong những trường hợp sau:

• Lỗi -1052, không đủ quyền. Key thiếu quyền Futures hoặc cặp giao dịch không được hỗ trợ.
• Lỗi quyền trên key vừa tạo. Hãy chờ đủ 15 phút.
• HTTP 429. Nền tảng đang gửi quá nhiều yêu cầu. Giới hạn REST của WEEX là 500 đơn vị trọng số trong 10 giây cho mỗi IP.
• Lỗi chữ ký hoặc passphrase. Một trong ba giá trị bị thiếu ký tự khi dán hoặc có thêm khoảng trắng.
• Yêu cầu bị từ chối khi bật ràng buộc IP. Nền tảng đang kết nối từ một địa chỉ không có trong danh sách của bạn.

FAQ API Futures của WEEX liệt kê đầy đủ các mã lỗi.

Bảo mật API Key WEEX: Sáu cài đặt giúp hạn chế thiệt hại

Key giao dịch không thể rút tiền, nhưng vẫn có thể khiến bạn thua lỗ. Hình thức lạm dụng thường thấy trên các sàn là kẻ tấn công dùng key chỉ có quyền giao dịch bị đánh cắp để mua một token kém thanh khoản với giá bị đẩy cao từ tài khoản do chúng kiểm soát. Sáu thói quen sau giúp giảm rủi ro đó.

1. Chỉ cấp quyền tối thiểu cần thiết. Các công cụ thuế và quản lý danh mục chỉ cần quyền Đọc. KoinX yêu cầu đúng quyền này. Key chỉ có quyền đọc không thể đặt lệnh.
2. Ràng buộc IP bất cứ khi nào nền tảng hỗ trợ. Tài liệu của WEEX cho biết các key không ràng buộc IP "tiềm ẩn rủi ro bảo mật". Một số dịch vụ không thể hoạt động với danh sách IP cố định. KoinX hướng dẫn người dùng tắt giới hạn IP. Nếu nền tảng cần key không giới hạn IP, hãy để key đó chỉ có quyền đọc.
3. Dùng một key riêng cho mỗi nền tảng. Với giới hạn tối đa 10 nhóm key, không có lý do gì để dùng chung. Key riêng giúp bạn ngắt quyền truy cập của một dịch vụ mà không làm gián đoạn các dịch vụ khác, đồng thời cho biết key nào đã bị lộ.
4. Xem passphrase là một bí mật riêng biệt thứ ba. Không đưa passphrase vào ảnh chụp màn hình, tin nhắn trò chuyện hay phiếu hỗ trợ. Hướng dẫn của WEEX rất rõ ràng: "Không bao giờ chia sẻ Passphrase của bạn."
5. Từ chối yêu cầu cấp quyền vượt quá giao dịch. Hướng dẫn tích hợp liệt kê Đọc, Spot và Futures là các quyền dành cho key do bạn tạo. Nền tảng yêu cầu mật khẩu đăng nhập WEEX hoặc quyền rút tiền đang đòi hỏi những thứ không cần thiết để giao dịch.
6. Xóa key ngay khi có nghi ngờ. WEEX khuyến nghị xóa ngay key bị xâm phạm. Hãy làm tương tự với mọi nền tảng bạn đã ngừng sử dụng.

Cách ngắt kết nối nền tảng khỏi WEEX

Xóa key trong nền tảng trước, sau đó xóa key trong mục Quản lý API của WEEX. Bước thứ hai mới thực sự có tác dụng, bởi key chỉ bị xóa khỏi cài đặt của nền tảng vẫn có thể được bất kỳ ai đang giữ bản sao sử dụng.

Key được tạo bằng Kết nối nhanh cũng áp dụng quy tắc tương tự. Hướng dẫn OAuth của WEEX cho biết phải xóa key hiện có trước khi có thể liên kết lại tài khoản với nền tảng đó.

Kết nối một nền tảng với WEEX chỉ mất vài phút, nhưng các lựa chọn trong khoảng thời gian đó sẽ quyết định mức độ rủi ro trong suốt thời gian key tồn tại: cấp quyền nào, cho phép những IP nào và có xóa key khi không còn dùng hay không. Bạn có thể tạo và quản lý key trên trang API WEEX.

Câu hỏi thường gặp

1. Tôi có thể tạo bao nhiêu API key trên WEEX?

Theo hướng dẫn chuẩn bị tích hợp của WEEX, mỗi tài khoản có thể tạo tối đa 10 nhóm API key. Số lượng này đủ để mỗi nền tảng được kết nối có key riêng, nhờ đó bạn có thể thu hồi quyền của một dịch vụ mà không ảnh hưởng đến các dịch vụ còn lại.

2. Tôi có thể đặt lại passphrase API WEEX bị mất không?

Không. Tài liệu của WEEX cho biết passphrase bị mất không thể khôi phục hoặc chỉnh sửa. Hãy xóa key, tạo key mới với passphrase mới rồi cập nhật nền tảng đang sử dụng key đó.

3. Tại sao API key WEEX mới của tôi báo lỗi quyền?

Ba nguyên nhân thường gặp là thiếu quyền giao dịch, cặp giao dịch nằm ngoài phạm vi thị trường của key và vấn đề thời gian. WEEX cho biết key mới hoặc vừa chỉnh sửa cần khoảng 15 phút để có hiệu lực, vì vậy hãy thử lại sau khoảng thời gian đó trước khi thay đổi cài đặt.

4. WEEX có hỗ trợ kết nối TradingView hoặc FIX không?

FAQ API Futures của WEEX liệt kê tích hợp TradingView và FIX API là các tính năng không được hỗ trợ. Kết nối được thực hiện thông qua giao diện REST và WebSocket, trực tiếp hoặc qua nền tảng đã tích hợp các giao diện này.