📣 کانال رسمی API نوبیتکس 📣

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

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

🔗 مستندات API نوبیتکس:
https://apidocs.nobitex.ir

📌 برای پیشنهاد قابلیت‌های جدید و مشارکت در توسعه API، به مخزن GitHub مستندات مراجعه نمایید:
https://github.com/nobitex/docs-api

📢 روش اطلاع‌رسانی تغییرات API نوبیتکس

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

تغییرات مهم همچنین از طریق کانال رسمی API نوبیتکس به اطلاع شما خواهد رسید.

📢 اطلاعیه تغییرات و بهبود اردربوک

از تاریخ ۱۵ آذر بهبودهای جدید اردربوک نوبیتکس در اختیار تمامی کاربران API قرار گرفته است:

✅ تعداد سفارش‌های بازگردانده شده در هر سمت اردربوک از ۱۶ به ۲۴ سفارش افزایش یافته است
✅ امکان استفاده از نماد all برای دریافت یکجای تمامی اردربوک‌ها فراهم شده است
✅ سرعت به‌روزرسانی API اردربوک بهبود یافته است و نتایج مدت زمان کوتاه‌تری کش می‌شوند
✅ توضیحات کامل استفاده از اردربوک در مستندات نوبیتکس به‌روزرسانی شده است

‼️ لازم به توجه است که روش بسیار قدیمی دریافت اردربوک مبتنی بر متد POST دیگر مورد پشتیبانی نمی‌باشد و کاربرانی که از این روش‌ برای دریافت اردربوک استفاده می‌کنند باید هر چه سریع‌تر نسبت به به‌روزرسانی کد خود مطابق با روش جدید (متد GET) اقدام نمایند.
البته از آن جایی که از چندین ماه گذشته در مستندات تنها روش جدید مبتنی بر GET وجود داشته است، اغلب کاربران نیازی به تغییر در کد خود نخواهند داشت.

📢 افزوده شدن مستندات برداشت به API نوبیتکس

توضیحات مرتبط با کار با درخواست‌های برداشت به سایت مستندات API نوبیتکس اضافه شدند. با استفاده از این Endpoint ها می‌توانید اقدامات زیر را به صورت خودکار انجام دهید:

✅ مشاهده فهرست درخواست‌های برداشت حساب خود
✅ پیگیری وضعیت یک درخواست برداشت
✅ ثبت و تایید درخواست برداشت جدید
⚡️ پشتیبانی از شبکه لایتنینگ

➡️ https://apidocs.nobitex.ir/#withdraw

🔶 لازم به توضیح است که برای تایید درخواست برداشت‌های ثبت شده از سمت API باید کد تایید ارسال شده به ایمیل خود را داشته باشید. برای مثال می‌توانید کد تایید را با اتصال برنامه خود به ایمیل حساب‌تان با پروتکل IMAP دریافت کنید. به زودی امکاناتی مانند آدرس‌بوک و لیست سفید آی‌پی از سمت نوبیتکس برای تسهیل فرآیند ثبت برداشت از طریق API فراهم خواهد شد.

#Nobitex #API #Withdraw

📢 افزوده شدن پارامتر clientOrderId به سفارش ها

⚡️شناسه یکتا سفارش یا clientOrderId، یک شناسه منحصر به فرد میباشد که شما می‌توانید از این شناسه برای پیگیری و مدیریت سفارشات خود استفاده کنید.
برای استفاده از شناسه یکتا سفارش، باید این پارامتر را هنگام ارسال سفارش به نوبیتکس ارسال نمایید. شما می‌توانید این شناسه را در هر فرمت دلخواه (حروف و اعداد انگلیسی) ارسال کنید. دقت کنید که این پارامتر برای هر کاربر در میان سفارش های open/active/inactive یکتاست.

✅ نکات و ملاحظات مهم در زمان ثبت یا بروزرسانی سفارش:
▫️در ارسال پارامتر های ورودی جهت دریافت و یا تغییر وضعیت سفارش، حداقل یکی از پارامترهای order و clientOrderId باید ارسال شوند.
▫️اگر هر دو پارامتر order و clientOrderId ارسال شوند، اولویت با id است.
▫️پارامتر clientOrderId فقط در میان سفارشات open/active/inactive جستجو می‌شود.
▫️پارامتر clientOrderId در حال حاضر در حالت آزمایشی است و ممکن است در آینده تغییر کند.

برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:
➡️ https://apidocs.nobitex.ir

📢 اطلاعیه مهم درباره افزایش نرخ محدودیت‌ها برای سفارش‌گذاری و لغو سفارش‌ها

همراهان گرامی نوبیتکس،

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

🛑 برای افزایش نرخ این اندپوینت‌ها نیاز است که در درخواست‌های ارسالی خود، مقدار User-Agent تنظیم‌شده باشد و مقدار User-Agent تنظیم‌شده را به پشتیبانی نوبیتکس ارسال نمایید.

1️⃣ اندپوینت سفارش گذاری :
محدودیت ارسال درخواست در سفارش گذاری برای کاربران از ۳۰۰ سفارش در ۱۰ دقیقه، به ۶۰۰ سفارش در ۱۰ دقیقه افزایش یافته است.

2️⃣اندپوینت لغو سفارش:
محدودیت ارسال درخواست در لغو سفارش گذاری برای کاربران از ۹۰ درخواست لغو در دقیقه، به ۱۸۰ لغو سفارش در دقیقه افزایش یافته است.


⚠️جهت بهره‌مندی از این تغییرات، لطفاً مراحل زیر را انجام دهید:

1- تنظیم User-Agent:
برای اطلاعات بیشتر در مورد نحوه تنظیم User-Agent، به مستندات نوبیتکس مراجعه نمایید.

2- ارسال User-Agent تنظیم‌شده:
پس از تنظیم User-Agent، آن را به ایمیل پشتیبانی نوبیتکس به آدرس ba@nobitex.net ارسال کنید.


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

لازم به ذکر است که این تغییرات ممکن است با توجه به شرایط و سیاست‌های نوبیتکس به وضعیت عادی بازگردد.
از همراهی شما سپاسگزاریم.


➡️ https://apidocs.nobitex.ir

📢 افزوده شدن وب‌سوکت به نوبیتکس به‌صورت آزمایشی⚡️

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

✅ نکات و ملاحظات مهم در استفاده از وب‌سوکت:

▫️ اتصال از طریق SDK رسمی: برای اتصال به وب‌سوکت، توصیه می‌شود از SDK رسمی که در مستندات ذکر شده است، استفاده نمایید.

▫️ تغییرات پارامترهای asks و bids: توجه داشته باشید که پارامترهای asks و bids در وب‌سوکت نسبت به اندپوینت v2/orderbook جابه‌جا شده‌اند. لطفاً هنگام استفاده از این ویژگی به این تغییرات دقت کنید.

برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:
➡️ https://apidocs.nobitex.ir/#api

📢 تعداد سفارش‌های نوبیتکس از مرز ۲میلیارد عبور کرد.

⚡️به اطلاع کاربران گرامی می‌رسانیم که تعداد سفارش‌های ثبت‌شده در نوبیتکس از مرز ۲ میلیارد فراتر رفته است. این موضوع ممکن است در صورت استفاده از مقادیر صحیح محدود (int32) در کدهای شما، منجر به بروز خطا شود.

برای جلوگیری از هرگونه مشکل، لطفاً کدهای خود را بررسی کرده و در صورت نیاز از نوع داده‌های مناسب‌تری مانند int64 یا BigInteger برای نگهداری شناسه سفارش‌ها استفاده نمایید.

در حال حاضر در اندپبونت های زیر، شناسه سفارش ارسال میگردد:
▫️ثبت سفارش جدید
▫️تغییر وضعیت سفارش
▫️فهرست سفارش های کاربر
▫️مشاهده وضعیت سفارش


برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:
➡️ https://apidocs.nobitex.ir/#api

📢 اطلاعیه مهم: تغییر آدرس اتصال به وب‌سوکت نوبیتکس

کاربران گرامی،

به اطلاع می‌رسانیم که دامنه اتصال به وب‌سوکت نوبیتکس تغییر یافته است. لطفاً در اسرع وقت تنظیمات برنامه‌ها و سرویس‌های خود را با دامنه جدید بروزرسانی کنید تا ارتباط شما بدون وقفه برقرار باشد.

🔗 آدرس جدید وب‌سوکت:
wss://wss.nobitex.ir/connection/websocket

⚠️ لطفاً توجه داشته باشید که آدرس قبلی غیرفعال شده است.
از همراهی و همکاری شما سپاسگزاریم.

⚠️ یادآوری

⚡️به اطلاع کاربران گرامی می‌رسانیم که تعداد سفارش‌های ثبت‌شده در نوبیتکس از مرز ۲ میلیارد فراتر رفته است. این موضوع ممکن است در صورت استفاده از مقادیر صحیح محدود (int32) در کدهای شما، منجر به بروز خطا شود.

برای جلوگیری از هرگونه مشکل، لطفاً کدهای خود را بررسی کرده و در صورت نیاز از نوع داده‌های مناسب‌تری مانند int64 یا BigInteger برای نگهداری شناسه سفارش‌ها استفاده نمایید.

📢 تغییرات جدید در صفحه‌بندی لیست سفارش‌ها

⚡️ کاهش مقدار پیش‌فرض تعداد سفارش‌های بازگردانده‌شده
اگر در درخواست دریافت لیست سفارشات، پارامتر pageSize ارسال نشده باشد، مقدار پیش‌فرض اعمال خواهد شد. این مقدار که پیش‌تر برابر با ۱۰۰۰ سفارش بود، اکنون به ۱۰۰ سفارش کاهش یافته است. در صورتی که به تعداد بیشتری از سفارشات نیاز دارید، می‌توانید مقدار دلخواه خود را با استفاده از پارامتر pageSize تعیین کنید.

⚡️ حذف امکان استفاده همزمان از پارامترهای fromId و page
در صورتی که از پارامتر fromId برای دریافت سفارشات با شناسه‌های بزرگ‌تر از مقدار مشخص استفاده می‌کنید، امکان استفاده از پارامتر page برای دریافت صفحات مختلف وجود نخواهد داشت. در این حالت، تنها اولین صفحه سفارشات پس از شناسه مشخص شده بازگردانده می‌شود.
تعداد سفارشات بازگردانده شده همچنان با استفاده از پارامتر pageSize قابل تنظیم است. مقدار پیش‌فرض ۱۰۰ بوده و حداکثر مقدار قابل تنظیم ۱۰۰۰ سفارش است.

📢 تعداد تراکنش‌های نوبیتکس از مرز ۲میلیارد عبور کرد.

⚡️به اطلاع کاربران گرامی می‌رسانیم که تعداد تراکنش‌های ثبت‌شده در نوبیتکس از مرز ۲ میلیارد فراتر رفته است. این موضوع ممکن است در صورت استفاده از مقادیر صحیح محدود (int32) در کدهای شما، منجر به بروز خطا شود.

برای جلوگیری از هرگونه مشکل، لطفاً کدهای خود را بررسی کرده و در صورت نیاز از نوع داده‌های مناسب‌تری مانند int64 یا BigInteger برای نگهداری شناسه تراکنش‌ها استفاده نمایید.

در حال حاضر در اندپبونت زیر، شناسه تراکنش‌ ارسال میگردد:
▫️لیست تراکنش‌ها

برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:
➡️ https://apidocs.nobitex.ir/#api