نرم‌افزار معاملات API: ابتدا محدودیت‌های صرافی را بررسی کنید

بیشتر افراد نرم‌افزار معاملات API را به ترتیب اشتباهی انتخاب می‌کنند. آن‌ها Freqtrade را با یک ربات گرید میزبانی‌شده مقایسه می‌کنند، بر سر اینکه کدام‌یک قالب‌های استراتژی بیشتری دارد بحث می‌کنند و تنها پس از نوشتن کد، مستندات صرافی را باز می‌کنند؛ در این مرحله متوجه می‌شوند که محدودیت نرخ (rate limit) نقطه پایانی سفارش، توانایی جذب فرکانس سیگنال آن‌ها را ندارد.

این روند را معکوس کنید. مشخص کنید که API صرافی واقعاً چه چیزی را مجاز می‌داند — مجوزهای کلید، نحوه شمارش محدودیت‌های نرخ، وجود محیط دمو — و انتخاب نرم‌افزار تا حد زیادی خودبه‌خود مشخص می‌شود.

این مطلب سه موضوع را پوشش می‌دهد: سه دسته‌بندی نرم‌افزارهای معاملات API و اینکه هر کدام برای چه کسی مناسب است، پارامترهای سمت صرافی که بدون توجه به کیفیت استراتژی، آن را متوقف می‌کنند، و مسیر کامل اتصال به APIهای اسپات و فیوچرز WEEX. جزئیات رابط کاربری زیر از مستندات API WEEX، نسخه V3(BETA)، مورخ ۵ اوت ۲۰۲۶ استخراج شده است.

نرم‌افزار معاملات API واقعاً چه کاری انجام می‌دهد — و چه کاری انجام نمی‌دهد

نرم‌افزار معاملات API پول شما را نگهداری نمی‌کند و معاملات را تطبیق نمی‌دهد. این نرم‌افزار داده‌های بازار را دریافت می‌کند، سیگنالی را از قوانین شما محاسبه کرده و سفارش‌ها را از طریق نقاط پایانی REST یا WebSocket صرافی ارسال می‌کند. دارایی‌ها در حساب صرافی شما باقی می‌مانند. نرم‌افزار فقط یک کلید با مجوز محدود در اختیار دارد.

این تقسیم کار دو فیلتر سخت‌گیرانه به شما می‌دهد. اول، هر محصولی که از شما می‌خواهد وجوه را به یک "حساب پلتفرم" واریز کنید تا برای شما معامله کند، نرم‌افزار معاملات API نیست — این امانت‌داری است و پروفایل ریسک کاملاً متفاوت است. دوم، هیچ رباتی نمی‌تواند فراتر از آنچه صرافی ارائه می‌دهد عمل کند. اگر نقطه پایانی وجود نداشته باشد، آن ویژگی وجود ندارد.

WEEX رابط‌های خود را به پنج مسیر تقسیم می‌کند — اسپات، فیوچرز، شریک، بروکر و کپی تریدینگ. اسپات و فیوچرز دو موردی هستند که برای اکثر کاربران کوانت اهمیت دارند؛ صفحه نمای کلی API WEEX دسترسی برنامه‌نویسی به بیش از ۱۰۰ ارز دیجیتال را فهرست می‌کند.

متن‌باز، ربات ابری یا موتور سفارشی

هر گزینه در یکی از سه دسته قرار می‌گیرد. تفاوت اصلی تعداد استراتژی نیست — بلکه میزان مهندسی است که مایلید خودتان انجام دهید.

چند قانون کلی. برای استراتژی‌های روند یا گرید با فرکانس پایین، یک ربات ابری کافی است — زمانی که صرفه‌جویی می‌کنید ارزش بیشتری از اشتراکی که می‌پردازید دارد. برای کارهای چند دارایی، چند بازه زمانی یا شاخص‌های سفارشی، متن‌باز از نظر اقتصادی برنده است و بزرگی جوامع Freqtrade و Hummingbot به این معنی است که اکثر حالت‌های شکست قبلاً مستند شده‌اند. ساخت موتور شخصی تنها زمانی توجیه دارد که تأخیر خود منبع بازده باشد: بازارگردانی با فرکانس بالا، آربیتراژ بین صرافی‌ها.

یک نکته بیش از آنچه معمولاً به آن توجه می‌شود، اهمیت دارد. دادن کلید API به یک پلتفرم ابری به معنای واگذاری وجوه نیست، اما به معنای واگذاری اختیار سفارش است. در بدترین حالت، یک اپراتور مخرب یا هک‌شده می‌تواند با موجودی شما در یک جفت ارز کم‌حجم معامله کند. بنابراین: فقط مجوز معامله، لیست سفید IP فعال باشد و هرگز کل موجودی حساب را در معرض یک کلید شخص ثالث قرار ندهید.

محدودیت‌های نرخ تعیین می‌کنند که آیا استراتژی شما دوام می‌آورد

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

مستندات محدودیت‌های دسترسی اسپات WEEX صریح است:

جزئیاتی که ارزش دارد مستقیماً در کد خود بنویسید: وزن نقاط پایانی متفاوت است، با تماس‌های سنگین که هزینه بیشتری دارند؛ هر پاسخ دارای هدرهای سبک X-USED-WEIGHT-1M و X-REMAINING-WEIGHT-1M است تا بتوانید به جای حدس زدن، فضای خالی را اندازه‌گیری کنید؛ تجاوز از محدودیت، HTTP 429 و ممنوعیت 10s را برمی‌گرداند. درخواست‌های سفارش هدرهای X-ORDER-COUNT- و X-ORDER-REMAINING- مخصوص خود را دارند.

ده ثانیه ناچیز به نظر می‌رسد. برای استراتژی که سعی در ثبت حد ضرر دارد، ده ثانیه برای دو برابر کردن افت سرمایه کافی است. مشکل عمیق‌تر معمولاً خود ممنوعیت نیست، بلکه نرم‌افزاری است که 429 را به عنوان یک خطای عادی تلقی می‌کند، در بازه ممنوعیت دوباره تلاش می‌کند و آن را تمدید می‌کند. هر نرم‌افزار معاملات API که به سمت تولید می‌رود باید قبل از ثبت اولین سفارش زنده، هر دو گروه هدر را بخواند.

محدودیت‌های نرخ فیوچرز به طور جداگانه تحت API فیوچرز مستند شده‌اند — آن ارقام را در آنجا بررسی کنید به جای اینکه فرض کنید اعداد اسپات اعمال می‌شوند.

اتصال نرم‌افزار معاملات API به WEEX در پنج مرحله

1. ایجاد کلید. وارد شوید، Account → API Management را باز کنید، Create API Key را انتخاب کرده و تأیید امنیتی را تکمیل کنید. هر کاربر می‌تواند تا ۱۰ گروه کلید API داشته باشد.
2. تعیین محدوده مجوزها. کلیدهای جدید به طور پیش‌فرض Read Only هستند. معاملات برنامه‌نویسی نیاز به انتخاب دستی مجوز معامله مربوطه (اسپات) دارند. اگر فقط در حال بک‌تست یا نظارت هستید، آن را فقط خواندنی بگذارید — ارزان‌ترین بیمه موجود.
3. ذخیره سه راز. شما یک APIKey، یک SecretKey و یک Passphrase دریافت می‌کنید. عبارت عبور توسط کاربر تعریف می‌شود و قابل بازیابی نیست؛ گم کردن آن به معنای ایجاد یک کلید جدید است. نشت هر یک از این سه می‌تواند برای شما هزینه داشته باشد، بنابراین کلید در معرض خطر را فوراً حذف کنید.
4. اتصال IP. کلیدها می‌توانند هنگام ایجاد به آدرس‌های IP متصل شوند. یک کلید متصل‌نشده، پس از نشت، از هر جایی کار می‌کند. این کار پانزده ثانیه طول می‌کشد و بهترین بازده امنیتی را در این لیست دارد.
5. تنظیم دامنه و امضا. REST اسپات روی https://api-spot.weex.com و فیوچرز روی https://api-contract.weex.com اجرا می‌شود. هر درخواست شامل ACCESS-KEY، ACCESS-SIGN، ACCESS-PASSPHRASE و ACCESS-TIMESTAMP است. جریان کامل در راهنمای آماده‌سازی API اسپات موجود است.

جدول زیر برگه پارامترهایی است که ارزش کپی کردن قبل از ادغام را دارد. تأیید شده در ۵ اوت ۲۰۲۶ بر اساس مستندات API WEEX نسخه V3(BETA).

قبل از پول واقعی در نقاط پایانی دمو تست کنید

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

فیوچرز WEEX مجموعه‌ای از نقاط پایانی معاملات دمو را تحت /capi/v3/sim/ ارائه می‌دهد که موجودی، ثبت سفارش، موقعیت‌ها و تاریخچه سفارش را پوشش می‌دهد. همان احراز هویت، همان رفتار محدودیت نرخ، پول جعلی — موجودی دمو به صورت SUSDT به جای USDT برمی‌گردد.

با آن به عنوان یک دروازه CI قبل از راه‌اندازی رفتار کنید: پس از هر تغییر کد، یک روز معاملاتی کامل را در محیط دمو اجرا کنید و تأیید کنید که هیچ سفارش تکراری، هیچ 429 انباشته‌ای وجود ندارد و وضعیت موقعیت پس از اتصال مجدد اجباری با صرافی مطابقت دارد. زمانی که این کار برای دیباگ کردن ذخیره می‌کند معمولاً بیش از ارزش بهینه‌سازی استراتژی است.

چهار روشی که نرم‌افزار معاملات API پول را از دست می‌دهد

کلیدهای با محدوده بیش از حد. تیک زدن تمام مجوزها و نادیده گرفتن اتصال IP، چون سریع‌تر است. قانون ساده است: استراتژی فقط اسپات، مجوز فیوچرز دریافت نمی‌کند؛ اسکریپت نظارتی فقط خواندنی باقی می‌ماند.

تلقی 429 به عنوان خطای عادی. عدم خواندن هدرهای فضای خالی، سپس تلاش مجدد در طول ممنوعیت و تمدید آن. این اتفاق در طول حرکات شدید بازار به طور قابل اعتمادی رخ می‌دهد — دقیقاً زمانی که نیاز به ثبت سفارش دارید.

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

بک‌تست با پر شدن کامل. بک‌تست‌ها در قیمت بسته شدن پر می‌شوند؛ معاملات زنده هزینه اسپرد، لغزش (slippage) و عمق را می‌پردازند. هرچه استراتژی بیشتر به لبه‌های کوچک فرکانس بالا متکی باشد، آن نشت بزرگ‌تر به نظر می‌رسد — و در جفت ارزهای کم‌حجم آلتکوین می‌تواند کل لبه را از بین ببرد. استراتژی گریدی که در بک‌تست 80% سالانه نشان می‌دهد، قبل از اینکه بدانید چه چیزی باقی مانده، نیاز به تخصیص زنده کمی دارد.

قبل از انتخاب نرم‌افزار، سوالات رابط کاربری را حل کنید

بازگشت به نکته ابتدایی. سوالی که ابتدا باید پاسخ دهید این نیست که کدام نرم‌افزار معاملات API ویژگی‌های بیشتری دارد، بلکه سه سوال رابط کاربری است: آیا محدودیت نرخ سفارش این صرافی می‌تواند فرکانس سیگنال من را جذب کند، آیا مجوزهای کلید می‌توانند به حداقل کاهش یابند، و آیا محیط دمویی برای اعتبارسنجی قبل از رفتن به لایو وجود دارد؟ هنگامی که این موارد حل شدند، بقیه — متن‌باز یا میزبانی‌شده، پایتون یا غیره — مسئله ترجیح است.

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

سوالات متداول

1. آیا نرم‌افزار معاملات API به مهارت‌های برنامه‌نویسی نیاز دارد؟

لزوماً خیر. ربات‌های ابری SaaS از پیکربندی رابط کاربری بدون کد اجرا می‌شوند. گزینه‌های متن‌باز مانند Freqtrade و Hummingbot به پایتون نیاز دارند؛ یک موتور سفارشی به مهارت بیشتری نیاز دارد. مبادله آزادی است — بدون کد شما محدود به گرید پیش‌فرض پلتفرم، DCA و قالب‌های سیگنال هستید.

2. آیا نرم‌افزار معاملات شخص ثالث می‌تواند وجوه من را بردارد؟

تحت یک ادغام API استاندارد، وجوه در حساب صرافی شما باقی می‌ماند و شخص ثالث یک کلید با مجوز محدود دارد، نه حقوق برداشت. مواجهه، اختیار سفارش است: یک کلید سوءاستفاده‌شده می‌تواند برای معامله علیه شما استفاده شود. با اعطای حداقل مجوزها، اتصال لیست سفید IP، چرخاندن کلیدها و عدم قرار دادن کل موجودی در معرض یک کلید شخص ثالث، کاهش ریسک کنید.

3. یک حساب WEEX چند کلید API می‌تواند ایجاد کند؟

بر اساس مستندات API WEEX بررسی‌شده در ۵ اوت ۲۰۲۶، هر کاربر می‌تواند تا ۱۰ گروه کلید API ایجاد کند که هر کدام برای مجوزهای خواندن و/یا معامله قابل پیکربندی هستند. کلیدهای کپی تریدینگ از قوانین جداگانه‌ای پیروی می‌کنند، با یک کلید برای هر حساب معامله‌گر تأییدشده.

4. وقتی نقطه پایانی سفارش 429 را برمی‌گرداند، نرم‌افزار چه کاری باید انجام دهد؟

ارسال درخواست‌ها را متوقف کرده و منتظر پایان ممنوعیت بمانید — مستندات اسپات WEEX یک ممنوعیت ۱۰ ثانیه‌ای را مشخص می‌کند. طراحی صحیح، هدرهای وزن باقی‌مانده و تعداد سفارش باقی‌مانده را می‌خواند و به طور پیش‌گیرانه محدود می‌کند، به جای اینکه محدودیت را تنها پس از رد شدن کشف کند.

5. آیا راهی برای تست ادغام بدون ریسک کردن پول واقعی وجود دارد؟

بله. فیوچرز WEEX نقاط پایانی دمو را تحت /capi/v3/sim/ برای موجودی، ثبت سفارش، موقعیت‌ها و تاریخچه سفارش ارائه می‌دهد، با استفاده از همان احراز هویت تولید — مناسب برای اعتبارسنجی امضا، مدیریت محدودیت نرخ و منطق بازیابی.

هشدار ریسک

دارایی‌های کریپتو بسیار نوسانی هستند. خودکارسازی اجرا، ریسک بازار را کاهش نمی‌دهدی؛ بلکه آن را تسریع می‌کند، از جمله ضررها. نرم‌افزار معاملات API ریسک‌های اضافی خاصی را به همراه دارد: یک کلید لو رفته می‌تواند به شخص ثالث اجازه دهد حساب شما را معامله کند؛ خرابی‌های شبکه، کرش‌های فرآیند یا ممنوعیت‌های محدودیت نرخ می‌تواند از اجرای حد ضرر جلوگیری کند؛ موقعیت‌های فیوچرز اهرمی می‌تواند در بازارهای سریع لیکویید شود که منجر به ضرر جزئی یا کلی اصل سرمایه می‌شود؛ نرم‌افزار شخص ثالث ممکن است حاوی آسیب‌پذیری‌ها یا ریسک اپراتور باشد؛ و عملکرد بک‌تست نشان‌دهنده نتایج آینده نیست. فقط از سرمایه‌ای استفاده کنید که توانایی از دست دادن آن را دارید، لیست‌های سفید IP را متصل کنید و مجوزها را در هر کلید به حداقل برسانید و قبل از استقرار زنده، در محیط دمو اعتبارسنجی کنید. این مقاله فقط برای اطلاع‌رسانی است و توصیه سرمایه‌گذاری نیست.