چگونه بروکر WEEX شوید: درخواست، راه‌اندازی API و آغاز به کار

برای تبدیل‌شدن به بروکر WEEX، فرم آغاز همکاری را که از صفحه بروکر WEEX پیوند داده شده ارسال کنید، بررسی‌های لازم را بگذرانید و شناسه بروکر با قالب WEEX به‌علاوه شش رقم دریافت کنید. پس از آن، کار فنی آغاز می‌شود: کاربران را از طریق OAuth یا کلیدهای API خودشان متصل کنید، شناسه بروکر را به ابتدای هر سفارش اضافه کنید و کمیسیون‌ها را از طریق endpointهای ریبیت تطبیق دهید. WEEX برای تأیید یک روز کاری و برای راه‌اندازی چهار تا پنج روز کاری زمان اعلام می‌کند. بخش‌های زیر این توالی را دنبال می‌کنند، مواردی را که باید آماده کنید فهرست می‌کنند و کارهای امنیتی مربوط به نگهداری کلیدهای دیگران را پوشش می‌دهند. اطلاعات تا 7 اکتبر 2026 به‌روز هستند.

چه کسانی می‌توانند درخواست دهند و WEEX چه اطلاعاتی می‌خواهد

افراد، تیم‌ها و شرکت‌ها همگی می‌توانند درخواست دهند و نیازی به واریز وجه نیست. بخش پرسش‌های متداول در صفحه بروکر WEEX از تیم‌های کوانت، مؤسسات مالی و KOLهای جامعه به‌عنوان متقاضیان خوش‌آمد یاد می‌کند و بررسی را راستی‌آزمایی استاندارد توصیف می‌کند.

پرکردن فرم بخش آسان کار است. ثبت‌نام OAuth که پس از آن انجام می‌شود اطلاعات بیشتری می‌خواهد و جمع‌آوری زودهنگام آن‌ها می‌تواند چند روز در زمان صرفه‌جویی کند:

• نام پلتفرم به انگلیسی
• شناسه WEEX (UID) که به هویت بروکر پیوند داده می‌شود
• نشانی‌های اینترنتی سیاست حفظ حریم خصوصی و شرایط استفاده
• لوگوی پلتفرم
• فرد مسئول تماس و نشانی ایمیل
• یک یا چند نشانی URL برای callback
• نشانی‌های IP عمومی که سرورهای شما از آن‌ها درخواست می‌فرستند

دو مورد معمولاً از چشم تیم‌ها دور می‌ماند. پیش از درخواست باید حساب WEEX داشته باشید، چون UID بخشی از فرایند ثبت‌نام است. همچنین سیاست حفظ حریم خصوصی و شرایط استفاده باید در صفحات فعال و قابل‌دسترسی باشند.

زمان‌بندی درخواست بروکر WEEX: از فرم تا شناسه بروکر

1. فرم را ارسال کنید. دکمه «Apply now» در صفحه بروکر، فرم را باز می‌کند.
2. منتظر بررسی بمانید. صفحه بروکر وعده می‌دهد که ظرف 24 ساعت با شما تماس گرفته شود و تأیید «در یک روز کاری» انجام شود. معرفی Broker API می‌گوید تیم توسعه کسب‌وکار درخواست‌ها را ظرف سه روز کاری بررسی می‌کند. بر اساس زمان طولانی‌تر برنامه‌ریزی کنید.
3. ایمیل تأیید را دریافت کنید. این ایمیل شناسه بروکری مانند WEEX123456، پیکربندی اولیه نرخ کمیسیون و دسترسی به گروه پشتیبانی فنی را در بر دارد.
4. اطلاعات OAuth را دریافت کنید. پس از ثبت نشانی‌های callback و IP شما توسط WEEX، یک clientId و یک کلید محرمانه دریافت می‌کنید.
5. یکپارچه‌سازی و راه‌اندازی کنید. اطلاعیه ⁦07/2026⁩ WEEX، یکپارچه‌سازی فنی را برای روزهای دوم تا چهارم و راه‌اندازی را برای روز پنجم برنامه‌ریزی می‌کند.

در عمل، زمان‌بندی بیشتر از آن‌که به بررسی WEEX وابسته باشد، به این بستگی دارد که تیم شما با چه سرعتی می‌تواند نشانی‌های callback پایدار و IPهای خروجی ثابت فراهم کند.

پیوند کاربران: فرایند OAuth در WEEX طی هفت مرحله

OAuth به کاربر امکان می‌دهد پلتفرم شما را در صفحه خود WEEX تأیید کند و یک کلید API آماده را به backend شما برمی‌گرداند. راهنمای یکپارچه‌سازی OAuth این فرایند را به شکل زیر تعریف می‌کند.

1. در backend خود، یک مقدار یک‌بارمصرف state با طول 22 تا 128 نویسه و یک code_verifier برای PKCE با طول حداقل ⁦43⁩ ایجاد کنید. چالش را به‌صورت Base64URL(SHA256(code_verifier)) محاسبه کنید. تنها روش پذیرفته‌شده S256 است.
2. کاربر را با clientId، responseType=code، scope=create:apikey، مقدار state، redirectUri و چالش کد خود به https://www.weex.com/fa-IR/oauth هدایت کنید.
3. کاربر درخواست را در WEEX بررسی و تأیید می‌کند.
4. WEEX کاربر را با code و state به نشانی callback شما برمی‌گرداند. بررسی کنید که state با مقداری که صادر کرده‌اید مطابقت داشته باشد.
5. از backend، یک درخواست POST با code، redirectUri و code verifier به https://gateway.weex.com/v1/oauth/token بفرستید. درخواست شامل headerهای Client-Id، Sign، Timestamp و Nonce است؛ Sign مقدار HMAC-SHA256 کدگذاری‌شده با Base64 از timestamp، nonce، method، path و body است و با client secret شما کلیدگذاری می‌شود.
6. یک access token با اعتبار 3,600 ثانیه و یک refresh token با اعتبار 36,000 ثانیه دریافت کنید. با نوسازی، access token قبلی بی‌اعتبار می‌شود.
7. با bearer token به https://gateway.weex.com/v1/oauth/resource/create-api درخواست POST بفرستید. پاسخ شامل apiKey، secret و passphrase کاربر است و این اطلاعات فقط یک بار برگردانده می‌شوند.

سه محدودیت بر طراحی اثر می‌گذارند. هر کاربر فقط می‌تواند یک کلید API پیوندخورده به یک پلتفرم شخص ثالث مشخص داشته باشد و تلاش دوم با خطای 81001، «api key already bound.»، روبه‌رو می‌شود. درخواست‌هایی که از نشانی‌های IP ثبت‌نشده شما ارسال شوند مسدود می‌شوند. همچنین اگر وضعیت API کاربر عادی نباشد، ممکن است کلید جدید بلافاصله کار نکند؛ بنابراین رابط شما باید وضعیت «در انتظار» داشته باشد.

استفاده از OAuth اختیاری است. پلتفرم می‌تواند کلیدهایی را بپذیرد که کاربران خودشان ایجاد و وارد می‌کنند. برچسب‌گذاری سفارش که در ادامه توضیح داده می‌شود، در هر دو روش الزامی است.

برچسب‌گذاری سفارش‌ها و بررسی واجد شرایط بودن برای کمیسیون

شناسه بروکر باید در ابتدای شناسه سفارش کاربر برای هر سفارش قرار بگیرد: newClientOrderId باید با b-{brokerId} شروع شود؛ برای مثال b-WEEX123456-20260319001. این قانون برای معاملات اسپات و فیوچرز اعمال می‌شود.

دو نکته به‌راحتی از قلم می‌افتند. در endpoint سفارش اسپات، شناسه سفارش کاربر اختیاری است و اگر آن را وارد نکنید WEEX خودش شناسه‌ای تعیین می‌کند. سفارشی که به این شکل ارسال شود پیشوند بروکر ندارد؛ بنابراین این فیلد را در هر درخواست تنظیم کنید. همچنین محدودیت‌های طول با هم تفاوت دارند: معرفی بروکر حداکثر 64 نویسه را مجاز می‌داند، درحالی‌که endpoint سفارش فیوچرز بازه 1 تا 36 را مشخص می‌کند. پیشوند b-WEEX123456- از 13 نویسه تشکیل شده است. اگر باقی شناسه را در 23 نویسه جای دهید، با هر دو محدودیت سازگار خواهد بود.

سپس از سه endpoint موجود در Broker rebate API استفاده کنید:

• واجد شرایط بودن. GET /api/v3/apiReferral/checkUserEligibility یک WEEX UID می‌گیرد و مشخص می‌کند کاربر واجد شرایط است یا نه، دلیل را برمی‌گرداند و می‌گوید آیا حساب از قبل به کد ارجاع دیگری پیوند خورده است یا خیر. هنگام پیوند کاربر این endpoint را فراخوانی کنید، نتیجه را ذخیره کنید و کاربران فاقد شرایط را از پیش‌بینی‌های کمیسیون کنار بگذارید.
• نرخ‌ها. GET /api/v3/apiReferral/rebateRatio سطح شما (BRONZE، SILVER یا GOLD) و شش نسبت را برمی‌گرداند: نرخ اسپات و فیوچرز برای دعوت‌شدگان مستقیم، کاربران فاقد کد ارجاع و ارجاع‌های «Invite Friends».
• سوابق. GET /api/v3/apiReferral/rebate/recentRecord سوابق کمیسیون را به تفکیک نماد و رمزارز کمیسیون برمی‌گرداند؛ نوع پیش‌فرض SPOT است و FUTURES نیز قابل انتخاب است. حداکثر بازه جست‌وجو 90 روز و حداکثر اندازه صفحه 100 است.

سوابق به تفکیک نماد و دوره تسویه برگردانده می‌شوند و شامل فیلدهای مبلغ معامله‌شده، کارمزد، کسر کارمزد، نرخ ریبیت و کمیسیون هستند. این سوابق شناسه کاربر یا شناسه سفارش ندارند. برای تقسیم کمیسیون به تفکیک کاربر، مثلاً برای تقسیم درآمد با نویسندگان استراتژی، دفترکل سفارش‌های خود را بر اساس شناسه سفارش کاربر نگهداری کنید. صفحه بروکر می‌گوید کمیسیون‌ها روزانه تسویه می‌شوند.

امنیت کلید API برای بروکرها: نگهداری کلیدهای دیگران

به‌محض آن‌که نخستین کاربر حسابی را پیوند دهد، پایگاه داده شما اطلاعات دسترسی‌ای را نگهداری می‌کند که امکان معامله با پول واقعی را می‌دهد. مستندات WEEX حداقل‌های لازم را مشخص می‌کنند و بروکر محتاط فراتر از آن‌ها عمل می‌کند.

• اطلاعات محرمانه را در backend نگه دارید. راهنمای OAuth می‌گوید client secret، code verifier و کلید محرمانه و passphrase هر کاربر هرگز نباید در کد frontend قرار بگیرند. پرسش‌های متداول بروکر اضافه می‌کند که کلیدها، اطلاعات محرمانه و passphraseها هرگز نباید در پارامترهای URL فرستاده شوند. پس از callback، کاربر را به صفحه‌ای پاک و بدون اطلاعات حساس هدایت کنید و اجازه دهید frontend وضعیت را دریافت کند.
• کلیدهای ذخیره‌شده را رمزنگاری و در گزارش‌ها پنهان کنید. گزارش اشکال‌زدایی که کلید محرمانه کامل در آن ثبت شده باشد، رایج‌ترین راه نشت کلید از سامانه‌هایی است که در غیر این صورت ایمن هستند.
• IPهای خروجی خود را ثابت نگه دارید. WEEX درخواست‌های نشانی‌های ثبت‌نشده را مسدود می‌کند. تغییر منطقه ابری یا افزودن پراکسی بدون به‌روزرسانی ثبت، دسترسی همه کاربران را هم‌زمان قطع می‌کند.
• برای بازگرداندن یک‌باره اطلاعات برنامه‌ریزی کنید. اگر پس از موفقیت create-api، نوشتن اطلاعات در فضای ذخیره‌سازی ناموفق شود، secret از دست می‌رود و کاربر باید کلید را حذف و دوباره پیوند ایجاد کند. این مرحله را به‌صورت تراکنشی پیاده‌سازی کنید.
• کمترین سطح دسترسی لازم را درخواست کنید. در روش زیرحساب، هر کلیدی که فقط‌خواندنی نباشد به فهرست مجاز IP با حداکثر 10 ورودی نیاز دارد. فقط در صورتی TRANSFER یا WITHDRAW را درخواست کنید که محصول شما وجه جابه‌جا می‌کند.
• محدودیت‌ها را رعایت کنید. فراخوانی‌های REST در هر 10 ثانیه، وزن 500 را به‌صورت مشترک مصرف می‌کنند. در پاسخ HTTP 429 سرعت درخواست‌ها را کاهش دهید و در صورت افزایش ناگهانی خطاهای مجوزدهی هشدار بفرستید؛ این وضعیت می‌تواند نشان دهد فردی در حال آزمایش اطلاعات دسترسی افشاشده است.

فهرست بررسی پیش از راه‌اندازی برای نخستین کاربر واقعی

• یک مسیر کامل را با حساب آزمایشی اجرا کنید: حساب را پیوند دهید، واجد شرایط بودن تأیید شود، یک سفارش برچسب‌گذاری‌شده انجام شود و پس از تسویه بعدی، معامله در سابقه کمیسیون ظاهر شود.
• سطح و نسبت‌های خود را از endpoint نرخ بررسی کنید و رقم اعلام‌شده در عنوان را مفروض نگیرید.
• قالب شناسه سفارش کاربر را هم در اسپات و هم در فیوچرز آزمایش کنید.
• یک مقدار قدیمی state و یک کد مجوزدهی استفاده‌شده را دوباره ارسال کنید. هر دو باید ناموفق باشند.
• درخواستی را از یک IP ثبت‌نشده امتحان کنید. باید مسدود شود.
• برای آزمایش منطق سفارش بدون استفاده از پول واقعی، از endpointهای آزمایشی در مسیر /sim/ استفاده کنید که در پرسش‌های متداول API فیوچرز WEEX توضیح داده شده‌اند.
• راهنمای عملیات پشتیبانی را بنویسید. مستندات WEEX نشانی [email protected] و یک جامعه تلگرامی را معرفی می‌کند و پس از تأیید، یک گروه پشتیبانی فنی در اختیار شما قرار می‌گیرد.

بروکر WEEX شدن به ارسال یک فرم و گذراندن یک بررسی کوتاه نیاز دارد. اما برای آن‌که کمیسیون‌ها درست پرداخت شوند، باید سفارش‌ها را با دقت برچسب‌گذاری کنید، صلاحیت هر کاربر را بررسی کنید و هر روز کار تطبیق را اجرا کنید. درخواست را از صفحه بروکر WEEX آغاز کنید.

پرسش‌های متداول

1. تأیید بروکر WEEX چقدر طول می‌کشد؟

صفحه بروکر WEEX وعده می‌دهد ظرف 24 ساعت با شما تماس گرفته شود و تأیید طی یک روز کاری انجام شود. مستندات API آن می‌گوید تیم توسعه کسب‌وکار درخواست‌ها را ظرف سه روز کاری بررسی می‌کند. طبق اطلاعیه ⁦07/2026⁩ WEEX، یکپارچه‌سازی فنی پس از آن حدود چهار تا پنج روز کاری زمان می‌برد.

2. آیا بروکر WEEX شدن هزینه‌ای دارد؟

خیر. صفحه بروکر اعلام می‌کند که نیازی به واریز وجه نیست و شروع کار هزینه‌ای ندارد. متقاضیان فرایند استاندارد راستی‌آزمایی را می‌گذرانند و بروکرهای تأییدشده به‌صورت رایگان به بخش پشتیبان بروکر و داشبورد داده‌ها دسترسی پیدا می‌کنند.

3. شناسه بروکر WEEX چه شکلی است؟

این شناسه از واژه WEEX و پس از آن شش رقم تشکیل می‌شود؛ برای مثال WEEX123456. شناسه در ایمیل تأیید ارسال می‌شود. شناسه سفارش کاربر برای هر سفارشی که پلتفرم می‌فرستد باید با b- و سپس همان شناسه آغاز شود.

4. آیا پلتفرم می‌تواند بدون OAuth با بروکر WEEX یکپارچه شود؟

بله. کاربران می‌توانند در WEEX کلیدهای API ایجاد و آن‌ها را به‌صورت دستی در پلتفرم وارد کنند. OAuth این مرحله دستی را حذف می‌کند و برچسب‌گذاری سفارش‌ها و endpointهای کمیسیون در هر دو روش یکسان عمل می‌کنند.