WEEX API چیست؟ ویژگی‌ها، ابزارهای معاملاتی و نحوه عملکرد آن

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

این API از معاملات اسپات و فیوچرز USDT-M پشتیبانی می‌کند و دسترسی از طریق REST API و WebSocket را فراهم می‌آورد. توسعه‌دهندگان می‌توانند قیمت‌ها، داده‌های کندل، عمق دفتر سفارش و معاملات لحظه‌ای را دریافت کنند، درحالی‌که رابط‌های احراز هویت‌شده از عملیات حساب و معاملات پشتیبانی می‌کنند. 

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

WEEX API چیست؟

WEEX API رابط فنی‌ای است که به برنامه‌های خارجی امکان می‌دهد با قابلیت‌های پشتیبانی‌شده صرافی WEEX ارتباط برقرار کنند.

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

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

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

با WEEX API چه کارهایی می‌توان انجام داد؟

از WEEX API هم برای رصد بازار و هم برای انجام عملیات معاملاتی می‌توان استفاده کرد.

برای داده‌های بازار، WEEX دسترسی به اطلاعاتی مانند قیمت‌های 24 ساعته، تغییرات قیمت، حجم معاملات، داده‌های کندل، عمق دفتر سفارش و معاملات لحظه‌ای را فراهم می‌کند. برنامه‌هایی که بازارها را رصد می‌کنند یا داده‌های ورودی سامانه‌های معاملاتی را فراهم می‌آورند، می‌توانند از این جریان‌های داده استفاده کنند. 

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

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

خود API استراتژی معاملاتی را ارائه نمی‌دهد. API ارتباط بین برنامه کاربر و قابلیت‌های پشتیبانی‌شده WEEX را فراهم می‌کند و کاربر قوانین و منطقی را که سامانه خارجی به کار می‌گیرد، تعیین می‌کند.

ویژگی‌های اصلی WEEX API چیست؟

یکی از ویژگی‌های اصلی WEEX API پشتیبانی آن از اتصال‌های REST API و WebSocket است.

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

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

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

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

کلیدهای API و مجوزهای WEEX چگونه کار می‌کنند؟

قابلیت‌های خصوصی API به احراز هویت از طریق یک API Key نیاز دارند. طبق مستندات فعلی WEEX Spot V3، مجوز یک API Key تازه‌ساخته‌شده به‌طور پیش‌فرض روی فقط‌خواندنی تنظیم شده است. این مجوز دسترسی مبتنی بر درخواست را فراهم می‌کند، اما امکان معامله اسپات را نمی‌دهد. کاربرانی که می‌خواهند برنامه‌ای سفارش‌های اسپات را ثبت یا لغو کند، باید مجوز معاملاتی اسپات مربوطه را فعال کنند.

فیوچرز WEEX از ساختار مجوز مشابهی استفاده می‌کند. دسترسی فقط‌خواندنی برای درخواست‌هایی مانند بررسی موجودی‌ها، موقعیت‌ها و تاریخچه معاملات قابل استفاده است، درحالی‌که مجوز فیوچرز عملیات معاملاتی پشتیبانی‌شده فیوچرز، از جمله باز و بسته کردن موقعیت‌ها و تعیین TP/SL را امکان‌پذیر می‌کند.

هنگام ایجاد یک API Key، کاربران سه مورد مهم را دریافت یا پیکربندی می‌کنند: APIKey, SecretKey و Passphrase. WEEX به کاربران هشدار می‌دهد که این اطلاعات را امن نگه دارند و در صورت به‌خطر افتادن یک API Key، آن را حذف کنند.

WEEX همچنین از اتصال IP برای API Keyها پشتیبانی می‌کند و برای افزایش امنیت، استفاده از فهرست مجاز IP را توصیه می‌کند.

بنابراین، مجوزهای اختصاص‌یافته به یک API Key تعیین می‌کنند که برنامه خارجی چه کارهایی می‌تواند انجام دهد. کاربران باید فقط مجوزهای موردنیاز برای فرایند API موردنظر خود را فعال کنند.

آیا می‌توان پیش از استفاده از دارایی‌های واقعی، WEEX API را آزمایش کرد؟

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

مستندات رسمی Futures API شامل نقاط پایانی شبیه‌سازی‌شده برای بررسی موجودی حساب، مشاهده موقعیت‌ها، ثبت سفارش و مرور تاریخچه سفارش‌هاست. سفارش‌های شبیه‌سازی‌شده پشتیبانی‌شده شامل سفارش بازار و سفارش محدود می‌شوند.

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

بااین‌حال، معاملات شبیه‌سازی‌شده همه جنبه‌های اجرای سفارش در بازار زنده را بازسازی نمی‌کنند. بنابراین، نباید نتایج محیط آزمایشی را تضمینی برای عملکرد معاملاتی آینده در بازار زنده دانست.

محدودیت نرخ درخواست WEEX API چقدر است؟

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

در Spot V3 API فعلی، پرسش‌های متداول رسمی محدودیت سفارش اسپات را 100 سفارش در هر 10 ثانیه اعلام می‌کند. لغو سفارش اسپات به 80 بار در هر 10 ثانیه یا 200 بار در دقیقه محدود است، درحالی‌که محدودیت وزن IP شبکه برای هر IP، 500 در هر 10 ثانیه است. 

در مورد Futures API، پرسش‌های متداول رسمی فعلی محدودیت ثبت سفارش را 300 بار در دقیقه، محدودیت REST را 500 وزن در هر 10 ثانیه برای هر IP و حداکثر تعداد اتصال‌های WebSocket را 20 اتصال برای هر IP اعلام می‌کند.

اگر یک درخواست REST از محدودیت نرخ مربوطه فراتر برود، WEEX ممکن است کد HTTP 429 را برگرداند. بنابراین، توسعه‌دهندگان باید هنگام طراحی یک سامانه معاملاتی مبتنی بر API، محدودیت‌های مربوطه را در نظر بگیرند.

ازآنجاکه قوانین و محدودیت‌های API ممکن است به‌روزرسانی شوند، پیش از راه‌اندازی یا تغییر یکپارچه‌سازی باید آخرین مستندات رسمی بررسی شود.

WEEX API برای چه کسانی طراحی شده است؟

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

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

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

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

جمع‌بندی

WEEX API برنامه‌ها و سامانه‌های معاملاتی خارجی را به قابلیت‌های پشتیبانی‌شده صرافی WEEX متصل می‌کند. این API دسترسی REST API و WebSocket، پشتیبانی از معاملات اسپات و فیوچرز USDT-M، داده‌های بازار، عملیات معاملاتی احراز هویت‌شده، مجوزهای قابل‌تنظیم و رابط‌های معاملات آزمایشی فیوچرز را ارائه می‌دهد.

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

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

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

2. WEEX API از چه محصولات معاملاتی پشتیبانی می‌کند؟
WEEX منابع API را برای معاملات اسپات و فیوچرز USDT-M ارائه می‌دهد. قابلیت‌های موجود به محصول API، نقطه پایانی و مجوزها بستگی دارند.

3. آیا می‌توانم از WEEX API برای معاملات خودکار استفاده کنم؟
بله. رابط‌های احراز هویت‌شده WEEX API از معاملات برنامه‌نویسی‌شده پشتیبانی می‌کنند؛ بنابراین، کاربران می‌توانند سامانه‌هایی بسازند که بر اساس منطق خودشان دستورهای معاملاتی پشتیبانی‌شده را ارسال کنند.

4. آیا WEEX API امکان معاملات آزمایشی دارد؟
بله. WEEX نقاط پایانی معاملات آزمایشی را برای Futures API خود ارائه می‌دهد که شامل موجودی‌های شبیه‌سازی‌شده، موقعیت‌ها، ثبت سفارش و قابلیت‌های تاریخچه سفارش می‌شوند.

5. آیا WEEX API محدودیت نرخ درخواست دارد؟
بله. محدودیت نرخ درخواست بسته به API و عملیات متفاوت است و ممکن است با گذشت زمان تغییر کند. توسعه‌دهندگان باید پیش از ساخت، مستندات رسمی فعلی را بررسی کنند.