📢 روش اطلاع‌رسانی تغییرات 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

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

⚡️شما می‌توانید برای دریافت فهرست سفارشات با ترتیب خاص، در خروجی این API با ارسال پارامتر order در درخواست خود، ترتیب مدنظر را اعمال کنید.
مقادیر قابل پذیرش برای پارامتر order برابر با

id / -id
price / -price
created_at / -created_at

خواهد بود و با توجه به علامت آن‌ها به صورت صعودی(بدون علامت) یا نزولی(با علامت -) مرتب می گردد.

به عنوان مثال:
اگر بخواهیم مقدار لیست دریافتی براساس قیمت سفارش به صورت نزولی مرتب شده باشد، پارامتر order را با مقدار زیر پر می‌کنیم:

-price

⚠️ نکات و ملاحظات:

در صورتی که پارامتر order ارسال سفارشات در درخواست ارسال نشود، اولین شرطی که در ادامه می‌نوشته شده و مطبق بر درخواست شماست، اعمال خواهد شد:

🔹اگر پارامتر fromId در درخواست ارسال شده باشد، سفارش‌ها در پاسخ براساس شناسه‌ی سفارش(id) به صورت نزولی مرتب می‌شوند.

🔹اگر پارامتر نوع سفارش(type) در درخواست ارسال نشده باشد، سفارش‌ها در پاسخ به ترتیب زمان ایجاد سفارش(created_at) به صورت نزولی بازگردانده می‌شوند.

🔹اگر نوع سفارش(type) با مقدار buy تعیین شده باشد، سفارش‌ها به‌ترتیب قیمت به صورت نزولی و اگر نوع سفارش با مقدار sell تعیین شده باشد سفارش‌ها به ترتیب قیمت به صورت صعودی بازگردانده می‌شوند.


برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:

➡️ https://apidocs.nobitex

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

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

به اطلاع شما می‌رسانیم که از مدتی پیش، نرخ محدودیت‌ها (ریت لیمیت‌ها) برای برخی از اندپوینت‌های مربوط به سفارش‌گذاری و لغو سفارش‌ها برای کاربران 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

📢 اطلاعیه تغییر آدرس دامنه API

آدرس دامنه API اصلی نوبیتکس به آدرس زیر تغییر یافته است:
🌐 https://apiv2.nobitex.ir

آدرس دامنه وب‌سوکت (آزمایشی) نوبیتکس نیز به آدرس زیر تغییر کرده است:
🌐 wss://ws.nobitex.ir

⚡️ هم‌اکنون آخرین نسخه از تمامی APIهای منتشر شده در مستندات نوبیتکس برای استفاده تمامی کاربران در دسترس است.

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

📢 اطلاعیه تغییرات محدودیت فراخوانی

⚡️ محدودیت فراخوانی APIهای مرتبط با معاملات در بازار اسپات از آدرس IP به کاربر درخواست تغییر یافته است. به زودی این تغییر برای سایر APIها مانند موجودی و برداشت نیز اعمال خواهد شد.

🔍 مدت زمان لازم برای انتظار پیش از تلاش مجدد به پاسخ خطای محدودیت فراخوانی در این APIها اضافه شده است.
نمونه پاسخ:

{
  "status": "failed",
  "code": "TooManyRequests",
  "message": "تعداد درخواست شما بیش از حد معمول تشخیص داده شده. لطفا 12 ثانیه صبر نمایید.",
  "backOff": 12,
  "limit": 60
}

✅ پیاده‌سازی فرایند انتظار پیش از تلاش مجدد، به بهبود کیفیت سرویس و تجربه کاربری شما کمک خواهد نمود.

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

📢 اضافه شدن تاریخچه تراکنش‌ها به مستندات عمومی

🔸 این API امکان فیلتر تاریخچه تراکنش‌ها با محدوده زمانی و انواع تراکنش را به صورت موردی فراهم می‌کند.

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

📢 افزوده‌شدن کانال‌های جدید WebSocket به مستندات عمومی نوبیتکس

به‌منظور بهبود تجربه توسعه‌دهندگان و دسترسی بهتر کاربران به اطلاعات لحظه‌ای، سه کانال جدید به مستندات WebSocket اضافه شد:

🔹 کانال عمومی معاملات:
دریافت آخرین معاملات انجام‌شده در هر بازار، به‌صورت آنی.

🔹 کانال وضعیت بازارها:
دریافت اطلاعات کامل یک بازار یا همه بازارها در ۲۴ ساعت گذشته.

🔹 کانال خصوصی سفارشات کاربر:
دریافت کلیه رخدادهای مربوط به سفارشات شامل ایجاد، لغو، انجام معامله و سایر رویدادها.

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

📢 اضافه شدن قابلیت جدید «API Key»

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

با استفاده از API Key می‌توانید:

🔹سطح دسترسی‌ها را مدیریت کنید:
برای هر کلید، مجوزهای جداگانه تعیین کنید و مشخص کنید چه عملیاتی مجاز است.

🔹 دسترسی هر کلید را به چند IP محدود کنید.

🔹 چند کلید مستقل، با دسترسی های متفاوت، برای استفاده‌های مختلف ایجاد کنید.

🔹تاریخ انقضای دلخواه خود را روی کلید تنظیم کنید.


وضعیت ریلیز: Beta

برای مطالعه راهنما، نمونه درخواست‌ها و جزئیات فنی، به مستندات رسمی مراجعه کنید:
➡️ https://apidocs.nobitex.ir/#b1827ba2b0

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

به‌منظور بهبود پایداری، سرعت و یکپارچگی فرآیند برداشت ریالی، APIهای جدید برداشت ریالی به سرویس‌های نوبیتکس و مستندات آن در مستندات عمومی نوبیتکس اضافه شدند.

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

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

برای اطلاعات بیشتر می‌توانید به مستندات نوبیتکس مراجعه کنید:

⬅️ برداشت ریالی: https://apidocs.nobitex.ir/#rial-withdraw
⬅️ برداشت رمزارزی: https://apidocs.nobitex.ir/#withdraw
⬅️ فهرست برداشت‌ها: https://apidocs.nobitex.ir/#withdraw-list

📢 افزایش محدودیت تعداد کانال‌های وب‌سوکت از ۳۰۰ به ۴۵۰

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

بر این اساس، حداکثر تعداد کانال‌های قابل استفاده در هر اتصال وب‌سوکت از ۳۰۰ به ۴۵۰ افزایش یافته است.

این تغییر با هدف:

• پشتیبانی مؤثرتر از بازارهای جدید
• کاهش نیاز به ایجاد اتصال‌های موازی
• بهبود پایداری و تجربه توسعه‌دهندگان و معامله‌گران
اعمال شده است.

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

📢 قابلیت API Key اکنون در وبسایت و پنل کاربری نوبیتکس در دسترس است.

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

با استفاده از API Key می‌توانید:

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

🔹 دسترسی هر کلید را برای افزایش امنیت و جلوگیری از استفاده غیرمجاز به IPهای مشخص محدود کنید.

🔹 چند API Key مستقل با دسترسی‌های متفاوت ایجاد کنید. مناسب برای استفاده‌های مختلف، ربات‌ها یا سرویس‌های جداگانه.

🔹 تاریخ انقضای دلخواه برای هر کلید تنظیم کنید و کنترل کامل روی زمان اعتبار دسترسی‌ها داشته باشید.

🔐 این ساختار نسبت به توکن پیش‌فرض حساب کاربری، امن‌تر و قابل‌کنترل‌تر طراحی شده است.

برای ساخت کلید اختصاصی API از طریق وبسایت می‌توانید از بخش پروفایل، بخش خدمات API اقدام کنید:
➡️ https://nobitex.ir/panel/profile/api-services/

همچنین برای مشاهده راهنما، نمونه درخواست‌ها و جزئیات فنی می‌توانید به داکیومنت‌های فنی این بخش رجوع کنید:
➡️ https://apidocs.nobitex.ir/#apikey