API Changelog & Versioning
تغییرات API، بهروزرسانیهای شکستخورده و مسیرهای مهاجرت را دنبال کنید. از ویژگیهای جدید مطلع شوید و ارتقاها را بهطور استراتژیک برنامهریزی کنید.
نسخههای API
Smart Money API از نسخهبندی معنایی استفاده میکند. تمامی نقاط پایانی از پارامتر نسخه در مسیر URL پشتیبانی میکنند.
نسخه پایدار فعلی: v1 (توصیه شده برای تمامی یکپارچهسازیهای جدید)
سیاست نسخهبندی
ما سازگاری معکوس را در نسخههای اصلی حفظ میکنیم. نسخههای جزئی فیلدها و ویژگیهای جدید را بدون تغییرات شکستخورده اضافه میکنند. نسخههای اصلی تغییرات شکستخورده را با ۶ ماه اعلام قبلی معرفی میکنند.
نسخه فعلی: v1
منتشر شده: 2025-06-15 | وضعیت: پایدار | پایان عمر: 2028-06-15
ویژگیهای v1
- REST API با بیش از ۱۵ نقطه پایانی
- WebSocket برای استریمهای بلادرنگ
- ردیابی موقعیت نهنگها (بیش از ۶۰۰ کیف پول)
- تجمع نرخ تامین مالی (۳ صرافی)
- دادههای سود باز و تسویه
- امتیازات تایید هوش مصنوعی
- معیارهای زنجیرهای (Bitcoin, Ethereum)
- عملیات دستهای (۱۰۰ درخواست/دسته)
- Webhooks برای اطلاعرسانی رویدادها
تغییرات اخیر
v1.2.4 جدید
منتشر شده در 2026-03-18
- نقطه پایانی جدید: /v1/on-chain/whale-flows — ردیابی واریز/برداشت کیف پول نهنگها
- امتیازات تایید بهبود یافته با تحلیل احساسات
- پشتیبانی از فشردهسازی WebSocket (gzip, deflate)
- پیامهای خطای بهبود یافته با مراحل حل
v1.2.3
منتشر شده در 2026-02-28
- افزودن فیلد margin_ratio به موقعیتهای نهنگها
- افزایش تاریخچه تسویه به ۳۰ روز (قبلاً ۷ روز)
- بهبود قابلیت اطمینان تحویل webhook
v1.2.0
منتشر شده در 2026-01-15
- اصلی: نقطه پایانی سود باز (سطح Pro)
- اصلی: نقطه پایانی معیارهای زنجیرهای (سطح Pro)
- محدودیت صفحهبندی جدید: ۵۰۰ (قبلاً ۱۰۰)
- پشتیبانی از عملیات دستهای
راهنماهای مهاجرت
مهاجرت به v1.2.0
نقاط پایانی سود باز و زنجیرهای جدید هستند و بر یکپارچهسازیهای موجود تأثیر نمیگذارند. نیازی به مهاجرت نیست.
ارتقا اختیاری: از نقطه پایانی جدید open_interest برای تحلیل بهتر بازار استفاده کنید.
منسوخشدهها و حذفها
هیچ نقطه پایانی منسوخشدهای در v1 فعلی وجود ندارد. تمامی نقاط پایانی مستند شده پشتیبانی میشوند.
منسوخشدههای آینده (برنامهریزی شده برای v2)
نقاط پایانی زیر در v2.0 (برنامهریزی شده برای ۲۰۲۷) منسوخ خواهند شد. مسیر مهاجرت ارائه شده است.
فعلاً هیچ موردی وجود ندارد. v1 پایدار و کاملاً سازگار معکوس است.
سیاست Sunset
نقاط پایانی منسوخشده ۶ ماه قبل از حذف اعلام میشوند. ما راهنماهای مهاجرت واضحی برای تمامی تغییرات شکستخورده ارائه میدهیم.
بهروز بمانید
برای دریافت آخرین ویژگیها و تغییرات شکستخورده، به تغییرات API مشترک شوید.
مشاهده اطلاعیهها