سابقه تغییرات API نوبیتکس

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

تغییرات مهم API​

تغییرات شهریور ۱۴۰۴​

• افزودن APIهای جدید دفتر آدرس: اعتبارسنجی آدرس، ایجاد دو مرحله‌ای و تأیید آدرس

تغییرات مرداد ۱۴۰۵​

اعمال محدودیت بر فراخوانی مرورگری APIهای نوبیتکس​

به‌منظور افزایش امنیت سرویس‌های نوبیتکس و جلوگیری از فراخوانی مستقیم APIها از وب‌سایت‌های غیرمجاز، از تاریخ ۳۱ مردادماه ۱۴۰۵ محدودیت جدیدی بر اساس هدر Origin و هدرهای Fetch Metadata مرورگر اعمال خواهد شد.

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

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

• درخواست‌هایی که هدرهای مرورگری Origin و Sec-Fetch-Site را ارسال نمی‌کنند، طبق روال فعلی پردازش خواهند شد.
• درخواست‌های مرورگری متعلق به مبدأهای مجاز نوبیتکس، از جمله https://nobitex.ir و https://apiv2.nobitex.ir، طبق روال عادی پردازش خواهند شد.
• فراخوانی مستقیم API از یک وب‌سایت با مبدأ غیرمجاز، به‌جز موارد استثنایی مشخص‌شده توسط نوبیتکس، با پاسخ HTTP 403 Forbidden رد خواهد شد.

تأثیر این تغییر​

این تغییر عمدتاً سرویس‌ها و وب‌سایت‌هایی را تحت تأثیر قرار می‌دهد که APIهای نوبیتکس را مستقیماً از کد سمت مرورگر، مانند JavaScript، و از مبدأیی خارج از مبدأهای مجاز نوبیتکس فراخوانی می‌کنند.

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

اگر در حال حاضر APIهای نوبیتکس را مستقیماً از یک وب‌سایت یا اپلیکیشن تحت وب با مبدأ غیرمجاز فراخوانی می‌کنید، لازم است پیش از ۳۱ مردادماه ۱۴۰۵ معماری ارتباط خود با API را اصلاح کنید. روش پیشنهادی این است که درخواست‌ها ابتدا به سرور متعلق به سرویس شما ارسال شده و سپس از سمت سرور با APIهای نوبیتکس ارتباط برقرار شود.

تغییرات تیر ۱۴۰۵​

• افزودن راهنمای هدر User-Agent: TraderBot/<name-and-version> به همه APIهای HTTP
• اصلاح عناوین تکراری APIهای معاملات اخیر و آمار بازار
• حذف نمایش تکراری API مشترک فهرست برداشت‌ها از بخش برداشت ریالی

تغییرات خرداد ۱۴۰۵​

• به‌روزرسانی APIهای مربوط به برداشت
• به‌روزرسانی APIهای دفتر آدرس (AddressBook)
• افزودن APIهای مربوط به نسخه جدید برداشت ریالی

تغییرات خرداد ۱۴۰۴​

• تغییر آدرس پایه api ها
• منسوخ شدن نسخه قدیمی اردربوک
• افزودن اطلاعات تکمیلی برای محدودیت فراخوانی

تغییرات مهر ۱۴۰۳​

• حذف پارامتر availableBalance از پاسخ endpoint های زیر:
  • /liquidity-pools/list

تغییرات شهریور ۱۴۰۳​

• افزودن اندپوینت اردربوک ورژن ۳ و deprecate کردن ورژن ۲
• اضافه نمودن وب‌سوکت
• اضافه کردن کانال «لیست سفارش‌ها: اردربوک» به وب‌سوکت

تغییرات مرداد ۱۴۰۳​

• قابلیت دریافت سفارشات به ترتیب زمان ثبت، شناسه و قیمت به صورت صعودی و نزولی در لیست سفارشات

تغییرات مهر ۱۴۰۲​

• افزودن معاملات خرید تعهدی

تغییرات مرداد ۱۴۰۲​

• افزودن ضریب به فروش تعهدی

تغییرات اردیبهشت ۱۴۰۲​

• افزودن انواع سفارش بازار، حد ضرر و OCO به فروش تعهدی

تغییرات بهمن ۱۴۰۱​

• افزودن معاملات فروش تعهدی

تغییرات مرداد ۱۴۰۱​

• افزودن کندل دقیقه‌ای به OHLC

تغییرات فروردین ۱۴۰۱​

• پشتیبانی از سفارش‌های OCO

تغییرات اسفند ۱۴۰۰​

• پشتیبانی از سفارش‌های حد ضرر (Stop Loss)
• قابلیت ارسال کارت هدیه

تغییرات آذر ۱۴۰۰​

• آخرین اعلام برای APIهای قدیمی: از تاریخ ۱۵ آذر ۱۴۰۰ مواردی که در مستندات به عنوان «قدیمی» مشخص شده‌اند یا در مستندات ذکر نشده‌اند، دیگر مورد پشتیبانی نخواهند بود و باید کدهای استفاده کننده از این موارد تا این تاریخ به‌روزرسانی شوند.
• حذف متد POST برای دریافت اردربوک: دریافت اطلاعات اردربوک از تاریخ ۱۵ آذر ۱۴۰۰ تنها با روش جدید موجود در مستندات ممکن است. روش قدیمی که با متد POST مورد استفاده قرار می‌گرفت از این تاریخ دیگر در دسترس نخواهد بود.
• بهبود خروجی اردربوک: تعداد سفارش‌های بازگردانده شده در هر سمت اردربوک از ۱۶ به ۲۴ سفارش افزایش یافته است. همین طور امکان استفاده از نماد all برای دریافت یکجای تمامی اردربوک‌ها فراهم شده است. به طور کلی نیز سرعت به‌روزرسانی اردربوک بهبود یافته است.

سایر تغییرات API​

تغییرات آذر ۱۴۰۱​

• افزودن امکان فیلتر لیست سفارشات با یک آی دی مبدا
• افزودن امکان جستجوی نماد روی چارت UDF
• افزودن امکان ثبت و دریافت لیست بازارهای مورد علاقه

تغییرات آبان ۱۴۰۱​

• افزوده شدن کارمزد واریز شناسه دار جیبیت به پاسخ endpoint تنظیمات: v2/options

تغییرات مهر ۱۴۰۱​

• افزوده شدن امکان ثبت و دریافت آنتی‌فیشینگ کد

تغییرات بهمن ۱۴۰۰​

• ایجاد دیرهنگام کیف پول در زمان استفاده کاربر
• افزودن زمان آخرین به‌روزرسانی به لیست سفارش‌ها (اوردربوک)

تغییرات آبان ۱۴۰۰​

• افزودن پارامتر hasNext به پاسخ endpoint های زیر:

  • /users/transactions-history

• افزودن کد خطا به endpoint های زیر:

مستندات جدید​

مستندات جدید تیر ۱۴۰۱​

• فهرست معاملات کاربر (/market/trades/list)

مستندات جدید آذر ۱۴۰۰​

• ثبت درخواست برداشت (/users/wallets/withdraw)
• تایید درخواست برداشت (/users/wallets/withdraw-confirm)
• لیست برداشت‌ها (/users/wallets/withdraws/list)
• مشاهده برداشت (/withdraws/ID)

مستندات جدید آبان ۱۴۰۰​

• لیست سفارشات همه بازارها (/v2/orderbook/all)
• تاریخچه تراکنش‌های مالی کاربر (/users/transactions-history)
• لیست معاملات صرافی (/exchange/trades-list)
• ثبت معامله در صرافی (/exchange/create-trade)
• دریافت قیمت از صرافی (/exchange/estimate)
• CRUD اعلان قیمت (/v2/price-alerts)
• غیرفعال‌سازی شناسایی دوعاملی (/users/tfa/disable)
• تایید شناسایی دوعاملی (/users/tfa/confirm)
• فعال‌سازی شناسایی دوعاملی (/users/tfa/request)
• تفسیر صورت‌حساب (/users/wallets/invoice/decode)
• ایجاد صورت‌حساب واریز (/users/wallets/invoice/generate)
• لیست نوتیفیکیشن‌ها (/notifications/list)