Cách trở thành Nhà môi giới WEEX: Đăng ký, thiết lập API và triển khai hoạt động

Để trở thành Nhà môi giới WEEX, hãy gửi biểu mẫu đăng ký liên kết từ trang nhà môi giới của WEEX, vượt qua quy trình thẩm định và nhận mã nhà môi giới có định dạng WEEX theo sau là sáu chữ số. Sau đó, công việc chuyển sang phần kỹ thuật: liên kết người dùng thông qua OAuth hoặc khóa API riêng của họ, thêm mã nhà môi giới vào đầu mỗi lệnh và đối soát hoa hồng qua các endpoint hoàn phí. WEEX cho biết thời gian xét duyệt là một ngày làm việc và cần bốn đến năm ngày làm việc để triển khai. Các phần dưới đây trình bày theo trình tự đó, liệt kê những thứ cần chuẩn bị và đề cập đến các biện pháp bảo mật cần thiết khi lưu giữ khóa của người khác. Thông tin được cập nhật đến ngày 7 tháng 10 năm 2026.

Ai có thể đăng ký và WEEX yêu cầu những gì

Cá nhân, nhóm và công ty đều có thể đăng ký, đồng thời không yêu cầu nạp tiền. FAQ trên trang Nhà môi giới WEEX cho biết các nhóm định lượng, tổ chức tài chính và KOL trong cộng đồng đều được hoan nghênh đăng ký, đồng thời mô tả quy trình xét duyệt là thẩm định tiêu chuẩn.

Điền biểu mẫu là phần dễ nhất. Bước đăng ký OAuth tiếp theo yêu cầu nhiều thông tin hơn, vì vậy thu thập trước sẽ giúp tiết kiệm vài ngày:

• Tên nền tảng bằng tiếng Anh
• UID WEEX sẽ liên kết với danh tính nhà môi giới
• URL chính sách quyền riêng tư và điều khoản dịch vụ
• Logo nền tảng
• Người liên hệ và địa chỉ email
• Một hoặc nhiều URL callback
• Địa chỉ IP công khai mà máy chủ của bạn dùng để gửi yêu cầu

Có hai điểm thường khiến các nhóm gặp khó khăn. Bạn cần có tài khoản WEEX trước khi đăng ký vì UID là một phần của thông tin đăng ký. Ngoài ra, chính sách quyền riêng tư và điều khoản phải là các trang đã được đăng tải.

Thời gian đăng ký Nhà môi giới WEEX: Từ biểu mẫu đến mã nhà môi giới

1. Gửi biểu mẫu. Nút «Đăng ký ngay» trên trang nhà môi giới sẽ mở biểu mẫu.
2. Chờ xét duyệt. Trang nhà môi giới cam kết liên hệ trong vòng 24 giờ và «phê duyệt trong 1 ngày làm việc». Phần giới thiệu API dành cho nhà môi giới cho biết đội ngũ phát triển kinh doanh sẽ xét duyệt trong vòng ba ngày làm việc. Hãy dự trù theo mốc thời gian dài hơn.
3. Nhận email phê duyệt. Email này có mã nhà môi giới, chẳng hạn WEEX123456, cấu hình tỷ lệ hoa hồng ban đầu của bạn và quyền truy cập vào nhóm hỗ trợ kỹ thuật.
4. Nhận thông tin xác thực OAuth. Sau khi WEEX đăng ký URL callback và địa chỉ IP của bạn, bạn sẽ nhận được clientId và khóa secret.
5. Tích hợp và ra mắt. Thông báo 07/2026 của WEEX lên lịch tích hợp kỹ thuật vào ngày thứ hai đến thứ tư và ra mắt vào ngày thứ năm.

Trên thực tế, tiến độ thường phụ thuộc ít hơn vào khâu xét duyệt của WEEX mà phụ thuộc nhiều hơn vào tốc độ bên bạn cung cấp URL callback ổn định và IP gửi đi cố định.

Liên kết người dùng: Quy trình OAuth của WEEX gồm bảy bước

OAuth cho phép người dùng cấp quyền cho nền tảng của bạn ngay trên trang WEEX, sau đó trả về khóa API đã sẵn sàng cho backend của bạn. Hướng dẫn tích hợp OAuth mô tả quy trình như sau.

1. Trên backend, tạo một giá trị state chỉ sử dụng một lần, dài từ 22 đến 128 ký tự, cùng với PKCE code_verifier có độ dài ít nhất 43. Tính challenge theo công thức Base64URL(SHA256(code_verifier)). S256 là phương thức duy nhất được chấp nhận.
2. Chuyển hướng người dùng đến https://www.weex.com/vi/oauth cùng với clientId, responseType=code, scope=create:apikey, state, redirectUri của bạn và code challenge.
3. Người dùng xem xét và phê duyệt trên WEEX.
4. WEEX chuyển hướng về callback của bạn kèm code và state. Hãy xác minh state khớp với giá trị bạn đã cấp.
5. Từ backend, gửi yêu cầu POST đến https://gateway.weex.com/v1/oauth/token cùng với code, redirectUri và code verifier. Yêu cầu có các header Client-Id, Sign, Timestamp và Nonce; trong đó Sign là HMAC-SHA256 được mã hóa Base64 từ timestamp, nonce, method, path và body, với client secret của bạn làm khóa.
6. Nhận access token có hiệu lực trong 3,600 giây và refresh token có hiệu lực trong 36,000 giây. Làm mới token sẽ khiến access token trước đó mất hiệu lực.
7. Gửi POST đến https://gateway.weex.com/v1/oauth/resource/create-api cùng với bearer token. Phản hồi chứa apiKey, secret và passphrase của người dùng, và các thông tin này chỉ được trả về một lần.

Có ba ràng buộc ảnh hưởng đến thiết kế. Người dùng chỉ có thể giữ một khóa API được liên kết với một nền tảng bên thứ ba nhất định; lần thử thứ hai sẽ trả về lỗi 81001, «api key already bound». Các yêu cầu từ địa chỉ IP chưa đăng ký sẽ bị chặn. Ngoài ra, nếu trạng thái API của người dùng không bình thường, khóa mới có thể chưa hoạt động ngay, vì vậy giao diện của bạn cần có trạng thái đang chờ.

OAuth là tùy chọn. Nền tảng có thể chấp nhận khóa do người dùng tự tạo rồi nhập vào. Quy tắc gắn thẻ lệnh bên dưới được áp dụng trong cả hai trường hợp.

Gắn thẻ lệnh và kiểm tra điều kiện nhận hoa hồng

Mọi lệnh đều phải có mã nhà môi giới ở đầu client order ID: newClientOrderId phải bắt đầu bằng b-{brokerId}, chẳng hạn b-WEEX123456-20260319001. Quy tắc này áp dụng cho cả giao dịch spot lẫn futures.

Có hai chi tiết dễ bị bỏ sót. Trên endpoint đặt lệnh spot, client order ID là tùy chọn và WEEX sẽ tự gán ID nếu bạn không điền. Lệnh được gửi theo cách đó sẽ không có tiền tố nhà môi giới, vì vậy hãy đặt trường này trong mọi yêu cầu. Ngoài ra, giới hạn độ dài không thống nhất: phần giới thiệu dành cho nhà môi giới cho phép 64 ký tự, trong khi endpoint đặt lệnh futures quy định từ 1 đến 36 ký tự. Tiền tố b-WEEX123456- dài 13 ký tự. Thiết kế phần ID còn lại để vừa trong 23 ký tự sẽ đáp ứng được cả hai cách hiểu.

Sau đó, hãy sử dụng ba endpoint trong API hoàn phí dành cho nhà môi giới:

• Điều kiện đủ. GET /api/v3/apiReferral/checkUserEligibility nhận UID WEEX và trả về thông tin người dùng có đủ điều kiện hay không, lý do và tài khoản đã được liên kết với mã giới thiệu khác hay chưa. Hãy gọi endpoint này khi người dùng liên kết tài khoản, lưu kết quả và loại người dùng không đủ điều kiện khỏi dự báo hoa hồng.
• Tỷ lệ. GET /api/v3/apiReferral/rebateRatio trả về cấp của bạn (BRONZE, SILVER hoặc GOLD) và sáu tỷ lệ: spot và futures dành cho người được mời trực tiếp, người dùng không có mã giới thiệu và lượt giới thiệu qua «Mời bạn bè».
• Bản ghi. GET /api/v3/apiReferral/rebate/recentRecord trả về bản ghi hoa hồng theo mã giao dịch và coin hoa hồng, mặc định là SPOT hoặc có thể chọn FUTURES. Khoảng truy vấn tối đa là 90 ngày và kích thước trang tối đa là 100.

Bản ghi được trả về theo mã giao dịch và kỳ thanh toán, với các trường về khối lượng giao dịch, phí, khoản khấu trừ phí, tỷ lệ hoàn phí và hoa hồng. Bản ghi không bao gồm user ID hoặc order ID. Chẳng hạn, nếu muốn chia hoa hồng theo người dùng để chia sẻ doanh thu với tác giả chiến lược, hãy duy trì sổ theo dõi lệnh riêng, dùng client order ID làm khóa. Trang nhà môi giới cho biết hoa hồng được thanh toán hằng ngày.

Bảo mật khóa API cho nhà môi giới: Lưu giữ khóa của người khác

Khi người dùng đầu tiên liên kết tài khoản, cơ sở dữ liệu của bạn sẽ lưu thông tin xác thực có thể dùng để giao dịch bằng tiền thật. Tài liệu của WEEX đưa ra các yêu cầu tối thiểu, còn một nhà môi giới cẩn trọng sẽ áp dụng biện pháp nghiêm ngặt hơn.

• Giữ secret ở backend. Hướng dẫn OAuth nêu rõ client secret, code verifier, secret key và passphrase của từng người dùng tuyệt đối không được xuất hiện trong mã frontend. FAQ dành cho nhà môi giới cũng nói rằng không được truyền key, secret và passphrase qua tham số URL. Sau callback, hãy chuyển hướng đến một trang sạch rồi để frontend lấy trạng thái.
• Mã hóa khóa đã lưu và che chúng trong nhật ký. Nhật ký gỡ lỗi chứa secret đầy đủ là nguyên nhân phổ biến nhất khiến khóa bị rò rỉ khỏi các hệ thống vốn được thiết kế tốt.
• Cố định IP gửi đi. WEEX chặn yêu cầu từ các địa chỉ chưa đăng ký. Thay đổi khu vực đám mây hoặc thêm proxy mà không cập nhật thông tin đăng ký sẽ khiến tất cả người dùng mất kết nối cùng lúc.
• Chuẩn bị cho việc chỉ trả về một lần. Nếu thao tác ghi vào bộ nhớ thất bại sau khi create-api chạy thành công, secret sẽ mất và người dùng phải xóa khóa rồi liên kết lại. Hãy thực hiện bước này theo cơ chế giao dịch.
• Chỉ yêu cầu quyền hạn tối thiểu. Với phương án tài khoản phụ, mọi khóa có quyền cao hơn chỉ đọc đều cần danh sách cho phép IP gồm tối đa 10 mục. Chỉ yêu cầu TRANSFER hoặc WITHDRAW nếu sản phẩm có chức năng chuyển tiền.
• Tuân thủ giới hạn. Các lệnh gọi REST dùng chung hạn mức 500 weight mỗi 10 giây. Hãy giảm tốc độ khi nhận HTTP 429 và cảnh báo khi có nhiều lỗi xác thực trong thời gian ngắn, vì đây có thể là dấu hiệu thông tin xác thực bị rò rỉ và đang bị thử sử dụng.

Danh sách kiểm tra trước khi người dùng thật đầu tiên tham gia

• Chạy thử toàn bộ quy trình bằng tài khoản kiểm thử: liên kết, xác nhận điều kiện đủ trả về true, lệnh đã gắn thẻ được khớp và giao dịch xuất hiện trong bản ghi hoa hồng sau kỳ thanh toán tiếp theo.
• Xác nhận cấp và tỷ lệ của bạn từ endpoint tỷ lệ thay vì mặc định dựa trên con số được quảng bá.
• Kiểm tra định dạng client order ID trên cả spot lẫn futures.
• Thử gửi lại giá trị state cũ và mã ủy quyền đã sử dụng. Cả hai trường hợp đều phải thất bại.
• Thử gửi yêu cầu từ IP chưa đăng ký. Yêu cầu phải bị chặn.
• Sử dụng các endpoint demo trong đường dẫn /sim/, được đề cập trong FAQ API futures của WEEX, để kiểm thử logic đặt lệnh mà không dùng tiền thật.
• Soạn tài liệu hướng dẫn xử lý sự cố cho đội hỗ trợ. Tài liệu của WEEX liệt kê support@weex.com và cộng đồng Telegram, đồng thời khi được phê duyệt, bạn sẽ có quyền tham gia nhóm hỗ trợ kỹ thuật.

Trở thành Nhà môi giới WEEX cần điền biểu mẫu và trải qua một quy trình xét duyệt ngắn. Để trở thành nhà môi giới nhận hoa hồng chính xác, bạn cần gắn thẻ lệnh có kỷ luật, kiểm tra điều kiện đủ cho từng người dùng và chạy công việc đối soát hằng ngày. Hãy bắt đầu đăng ký trên trang Nhà môi giới WEEX.

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

1. WEEX xét duyệt đăng ký nhà môi giới trong bao lâu?

Trang nhà môi giới của WEEX cam kết liên hệ trong vòng 24 giờ và phê duyệt trong một ngày làm việc. Tài liệu API cho biết đội ngũ phát triển kinh doanh xét duyệt hồ sơ trong vòng ba ngày làm việc. Theo thông báo 07/2026 của WEEX, quá trình tích hợp kỹ thuật sau đó mất khoảng bốn đến năm ngày làm việc.

2. Trở thành Nhà môi giới WEEX có mất phí không?

Không. Trang nhà môi giới nêu rõ rằng không yêu cầu nạp tiền và bạn có thể bắt đầu miễn phí. Người đăng ký trải qua quy trình thẩm định tiêu chuẩn; nhà môi giới được phê duyệt sẽ được miễn phí truy cập vào backend dành cho nhà môi giới và bảng điều khiển dữ liệu.

3. Mã nhà môi giới WEEX có dạng như thế nào?

Mã này gồm từ WEEX theo sau là sáu chữ số, chẳng hạn WEEX123456, và được gửi trong email phê duyệt. Mọi lệnh nền tảng gửi đi đều phải có client order ID bắt đầu bằng b- theo sau là mã đó.

4. Nền tảng có thể tích hợp với Nhà môi giới WEEX mà không dùng OAuth không?

Có. Người dùng có thể tạo khóa API trên WEEX rồi nhập thủ công vào nền tảng. OAuth loại bỏ bước nhập thủ công này; quy tắc gắn thẻ lệnh và các endpoint hoa hồng hoạt động giống nhau trong cả hai trường hợp.