راهنمای ارتقاء V5

ساخت وبلاگ

آخرین مطالب

امکانات وب

راهنمای ارتقاء V5

Open API V5 یکنواختی و کارآیی را به خطوط تولید Bybit ، یک نقطه متحد ، مشتقات و گزینه ها در یک مجموعه از مشخصات به ارمغان می آورد.

پوشش API فعلی

اگر حساب شما هنوز یک حساب حاشیه متحد است ، شما نمی توانید از طریق API V5 تجارت کنید. ما اکیداً توصیه می کنیم که به حساب تجارت یکپارچه ارتقا دهید.

USDC v1 نقطه V3 Futures v2 یکپارچه V3 قرارداد v3 همه در یک V5
نقطه ✗ ✓ (حالت عادی) ✗ ✗ ✗ ✓ (حالت یکپارچه و حالت عادی)
قرارداد USDT ✗ ✗ ✓ (حالت عادی) ✓ (حالت متحد) ✓ (حالت عادی) ✓ (حالت یکپارچه و حالت عادی)
USDC دائمی ✓ (حالت عادی) ✗ ✗ ✓ (حالت متحد) ✗ ✓ (حالت متحد)
آینده USDC ✗ ✗ ✗ ✗ ✗ ✓ (حالت متحد)
قرارداد معکوس ✗ ✗ ✓ (حالت عادی) ✗ ✓ (حالت عادی) ✓ (حالت یکپارچه و حالت عادی)
گزینه ✓ (حالت عادی) ✗ ✗ ✓ (حالت متحد) ✗ ✓ (حالت متحد)

ارتقاء کلیدی

تراز خطوط تولید

پیش از این ، گزینه های V1/V3 ، Futures V2 و USDC گزینه های V1 مجموعه API های خاص خود را داشتند که فقط بخشی از محصولات Bybit را پوشش می داد. V5 API محصولات مختلف تجاری را به یک واحد متحد می کند ، و این امکان را برای کاربران فراهم می کند تا بتوانند با یک API منفرد با یک API واحد ، با یک API واحد ، با یک API واحد معامله کنند. در نتیجه ، نیازی به جابجایی بین چندین رابط در هنگام ساخت محصولات مختلف - صرف نظر از کارهایی مانند مدیریت سفارش یا داده های کیف پول پرس و جو - از همان API برای درخواست و بازگشت نتایج نیست.

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

به عنوان مثال ، هنگام ایجاد سفارش با Post V5/Order/Create ، کاربران می توانند دسته = Spot/Linear/Option را برای ایجاد چندین سفارش در محصولات مختلف مشخص کنند.

سهولت ارتقا

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

افزایش کارایی سرمایه

V5 این امکان را برای کاربران فراهم می کند تا بتوانند حساب ها را به یک حساب یکپارچه ارتقا دهند و امکان به اشتراک گذاری و استفاده متقابل وجوه را در سراسر نقطه ، USDT دائمی ، USDC دائمی و گزینه ها فراهم می کند. کاربران همچنین قادر به جبران سود و زیان در موقعیت های مختلف هستند ، بنابراین باعث افزایش کارایی سرمایه می شوند.

قرض گرفتن حساب یکپارچه

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

به عنوان مثال: معامله گر آلیس در حالی که فقط دارایی های BTC را در اختیار دارد ، موقعیت قرارداد BTCUSDT را تنظیم می کند. اگر ضرر شناور متحمل شود ، بدهی ثبت می شود و بهره ساعتی به آن پرداخت می شود.

تجارت بلوک پارادایم

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

حالت حاشیه نمونه کارها

حساب های متحد اکنون از حاشیه ترکیبی بین قراردادهای دائمی USDC و گزینه ها پشتیبانی می کنند و به زودی گسترش می یابد تا شامل قراردادهای دائمی USDT شود.

استاندارد نامگذاری رابط API

API V5 تعاریف مسیر واضح تری را برای بهبود وضوح و کاهش ابهام ارائه می دهد. نسخه جدید مسیر API را به داده های بازار ، مدیریت سفارش ، مدیریت موقعیت ، مدیریت حساب ، مدیریت دارایی و ماژول های بیشتر تقسیم می کند.

بخش خطاب شرح
v5/بازار/ شمعدان ، دفترچه ، تیک ، داده های معامله پلت فرم ، قوانین مالی اساسی ، قوانین کنترل ریسک
v5/سفارش/ مدیریت سفارش
v5/موقعیت/ مدیریت موقعیت
v5/حساب/ فقط عملیات حساب کاربری - حساب بودجه یکپارچه ، نرخ و غیره
v5/دارایی/ عملیات در چندین حساب - مدیریت دارایی ، مدیریت صندوق و غیره
v5/Spot-Lever-token/ به نقل از نشانه های اهرمی در محل ، و استفاده از توابع خرید و بازخرید
V5/Spot-Margin Trade/ تجارت حاشیه را در محل مدیریت کنید

تنظیم حد API

برای اطمینان از معاملات صاف و بهبود تجربه کاربر ، حد نرخ در V5 تنظیم شده است تا سهمیه حد مجاز برای هر شناسه کاربری را در بین محصولات تخصیص دهد.

  • محدودیت نرخ V2: "شناسه کاربر + نماد + نقطه پایانی API" فرکانس درخواست های API را با تعداد مشخصی از شمارش در دقیقه محدود می کند
  • محدودیت نرخ V3: "شناسه کاربر + نقطه پایانی API" فرکانس درخواست های API را با تعداد مشخصی از تعداد در ثانیه محدود می کند
  • محدودیت نرخ V5: "شناسه کاربر + نقطه پایانی API" فرکانس درخواست های API را با تعداد مشخصی از تعداد در ثانیه محدود می کند
  • در آینده V2 ،
    • Trader Bob فرکانس سفارش BTCUSDT را در 400/متر ، ETHUSDT در 200/متر و سایر نمادها در 100/متر تنظیم می کند
    • اگر او 200 درخواست سفارش برای BTCUSDT را قرار دهد ، حد باقی مانده وی در این دقیقه 200 درخواست سفارش برای BTCUSDT ، 200 برای EthusDT و 100 برای سایر نمادها است
    • اگر 100 درخواست سفارش EthusDT به طور همزمان ارسال شود ، اعتبار باقی مانده در آن دقیقه 200 درخواست سفارش برای BTCUSDT ، 100 برای EthusDT و 100 برای سایر نمادها است
    • حد پیش فرض برای همه کاربران 10/ثانیه است
    • معامله گر چارلی فرکانس سفارش خود را به 100/ثانیه افزایش می دهد (حداکثر 100 درخواست در تمام رابط ها برای یک UID واحد)
    • او 50 درخواست سفارش برای BTCUSDT را در یک ثانیه قرار می دهد ، که در آن ثانیه حد باقی مانده از 50 درخواست سفارش را باقی می گذارد
    • محدودیت فرکانس سپس در طی ثانیه بعدی به 100/ثانیه بازنشانی می شود

    API های مبتنی بر پرس و جو نمی توانند در فرکانس افزایش یابد و به 10 درخواست در ثانیه محدود می شوند (WebSocket برای دریافت داده ها توصیه می شود).

    هیچ تغییری در تأخیر وجود ندارد

    API V5 که از اول ژانویه 2023 اجرا شده است ، در حال حاضر از معاملات حساب یکپارچه با همان تأخیر در معاملات حاشیه متحد پشتیبانی می کند. اجرای آینده برای معاملات حساب غیرحضوری همان تأخیر API V3 را نشان می دهد.

    رابط محل قرارگیری

    با V2 ، ارسال سفارشات عادی و مشروط به دو API مختلف نیاز داشت. سفارشات ادغام API V3 و V5 از طریق پارامترهای مختلف ارسال در یک رابط محل قرارگیری واحد. این امر نیاز کاربران را برای درخواست چندین سفارش با استفاده از رابط های مختلف از بین می برد.

    افزودن پرس و جو سفارش در زمان واقعی

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

    وضعیت سفارشات اخیراً پر شده نیز می تواند در زمان واقعی پرس و جو شود و تأخیر را در مقایسه با پرس و جو از طریق رابط نظم یا تاریخ کاهش می دهد.

    لغو سفارشات توسط ارز تسویه حساب

    کاربران می توانند تمام سفارشات مشتقات را که با همان ارز با SettleCoin تسویه حساب شده اند ، لغو کنند.

    افزودن پرس و جو نرخ بودجه تاریخی

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

    افزودن رابط صندوق بیمه

    این رابط کاربری را برای پرس و جوهای استخر بیمه فراهم می کند ، که کاربران می توانند از آنها برای بررسی هرگونه به روزرسانی صندوق بیمه در بستر BYBIT استفاده کنند.

    داده های اضافی WebSocket

    داده های WebSocket بیشتر برای ارائه طیف وسیعی از داده های OrderBook در فرکانس ها و عمق های مختلف اضافه شده است. فرکانس فشار هیچ تغییری ندارد ، اما عمق از 25 به 50 افزایش یافته است. لطفاً برای اطلاعات بیشتر به توضیحات رابط WebSocket مراجعه کنید.

    کتاب سفارش به روز شده اکنون برای اطمینان از صحیح بودن داده های کتاب سفارش محلی ، تداوم داده ها را بررسی می کند. یک قسمت SEQ (دنباله) نیز برای تعیین توالی داده های کشیده شده اضافه شده است ، بنابراین کاربران می توانند به طور مؤثر به تغییرات بازار پاسخ دهند.

     

    تولید - محصول عمق 1 عمق 25 عمق 50 عمق 100 عمق 200 عمق 500
    نقطه 10MS - 20ms - - -
    مشتق 10MS - 20ms - 100ms 100ms
    گزینه - 20ms - 100ms - -

    فقط سفارشات پست را افزایش دهید

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

    داده های یکنواخت و دقیق

    API های قبلی داده ها را به عنوان E2 و E8 برگرداندند. API V3 و V5 داده ها را به عنوان مقادیر واقعی باز می گردانند و نیاز کاربران برای اجرای منطق تبدیل را از بین می برند.

    بهبود خوانایی برای باز کردن مستندات API

    مستندات API باز برای بهبود وضوح و کاهش سردرگمی اصلاح شده و تصحیح شده است. هر بخش از مستندات قبلی که مشخص نیست اصلاح شده است تا توضیحات بهتری ارائه دهد.

    لیست نقشه برداری رابط V5 و V3

    مدول نقطه پایانی V5 نقطه پایانی V3
    بازار /v5/بازار/کلین /مشتقات/v3/عمومی/kline
    /Spot/v3/عمومی/QUOTE/KLINE
    /v5/بازار/مارک-قیمت /مشتقات/V3/عمومی/قیمت-قیمت-خط
    /v5/بازار/index-price-kline /مشتقات/V3/عمومی/قیمت-قیمت-خط
    /v5/بازار/حق بیمه-شاخص-قیمت /مشتقات/V3/عمومی/حق بیمه-قیمت-قیمت
    /v5/کتاب بازار/سفارش /مشتقات/v3/عمومی/کتاب سفارش/l2
    /Spot/v3/عمومی/QUOTE/DEVE
    /v5/بازار/تیکت ها /مشتقات/v3/عمومی/تیکت ها
    /Spot/v3/عمومی/QUOTE/TICEL/24 ساعت
    /Spot/v3/عمومی/QUOTE/TICKER/قیمت
    /Spot/v3/عمومی/نقل قول/تیک/bookticker
    /v5/بازار/بودجه/تاریخ /مشتقات/v3/عمومی/بودجه/نرخ بودجه تاریخ
    /v5/بازار/تجارت اخیر /مشتقات/v3/عمومی/تجارت اخیر
    /Spot/v3/عمومی/نقل قول/معاملات
    /v5/بازار/سود باز /مشتقات/v3/عمومی/سود باز
    /v5/بازار/تاریخی-ولتوری /مشتقات/v3/عمومی/تاریخی-گرایش
    /v5/بازار/بیمه /مشتقات/v3/عمومی/بیمه
    /v5/بازار/ابزارها /مشتقات/v3/عمومی/ابزارها
    /Spot/V3/عمومی/INFOS
    /Spot/v3/عمومی/نمادها
    /v5/بازار/محدودیت خطر /مشتقات/v3/عمومی/ریسک محدود/لیست
    /v5/بازار/قیمت تحویل /مشتقات/v3/عمومی/قیمت تحویل
    سفارش /v5/سفارش/ایجاد /متحد/v3/خصوصی/سفارش/ایجاد
    /قرارداد/v3/خصوصی/سفارش/ایجاد
    /v5/سفارش/اصلاح /یکپارچه/v3/خصوصی/سفارش/جایگزینی
    /قرارداد/v3/خصوصی/سفارش/جایگزینی
    /v5/سفارش/لغو /متحد/v3/خصوصی/سفارش/لغو
    /قرارداد/v3/خصوصی/سفارش/لغو
    /v5/سفارش/زمان واقعی /یکپارچه/v3/خصوصی/سفارش/سفارشات نشده
    /قرارداد/v3/خصوصی/سفارش/سفارشات پر نشده
    /v5/سفارش/لغو همه /یکپارچه/v3/خصوصی/سفارش/لغو همه
    /قرارداد/v3/خصوصی/سفارش/لغو همه
    /v5/سفارش/تاریخ /یکپارچه/v3/خصوصی/سفارش/لیست
    /قرارداد/v3/خصوصی/سفارش/لیست
    /v5/سفارش/ایجاد دسته /متحد/v3/خصوصی/سفارش/ایجاد دسته
    /v5/سفارش/BATCH /یکپارچه/v3/خصوصی/سفارش/مسابقه جایگزین
    /v5/سفارش/لغو دسته /یکپارچه/v3/خصوصی/سفارش/لغو
    /v5/سفارش/بررسی وام-چک هیچ یک
    موقعیت /v5/موقعیت/لیست /یکپارچه/v3/خصوصی/موقعیت/لیست
    /قرارداد/v3/خصوصی/موقعیت/لیست
    /v5/موقعیت/تنظیم کننده /یکپارچه/v3/خصوصی/موقعیت/تنظیم کننده
    /قرارداد/v3/خصوصی/موقعیت/تنظیم کننده
    /v5/موقعیت/تنظیم خطرناک /یکپارچه/v3/خصوصی/موقعیت/تنظیم خطرناک
    /قرارداد/v3/خصوصی/موقعیت/تنظیم خطرناک
    /v5/موقعیت/تجارت-توقف /یکپارچه/v3/خصوصی/موقعیت/تجارت-توقف
    /قرارداد/v3/خصوصی/موقعیت/تجارت-توقف
    /v5/موقعیت/سوئیچ جدا شده /قرارداد/v3/خصوصی/موقعیت/سوئیچ جدا شده
    /v5/موقعیت/حالت سوئیچ /قرارداد/v3/خصوصی/موقعیت/حالت سوئیچ
    /v5/موقعیت/set-auto-add-margin /قرارداد/v3/خصوصی/موقعیت/Set-Auto-ADD-Margin
    /v5/موقعیت/بسته-pnl /قرارداد/v3/موقعیت/بسته-pnl
    /v5/اجرای/لیست /یکپارچه/v3/خصوصی/اجرای/لیست
    /قرارداد/v3/خصوصی/اجرای/لیست
    حساب /v5/حساب/تعادل کیف پول /یکپارچه/v3/خصوصی/حساب/کیف پول/مانده
    /قرارداد/v3/خصوصی/حساب/کیف پول/مانده
    /v5/حساب/به روزرسانی به uta /یکپارچه/v3/خصوصی/حساب/ارتقاء-حساب-حساب
    /v5/حساب/وام-تاریخی /یکپارچه/v3/خصوصی/حساب/وام-تاریخ
    /v5/حساب/وثیقه-اینوفو /یکپارچه/v3/خصوصی/حساب/نرخ وام
    /v5/دارایی/سکه ها هیچ یک
    /v5/حساب/اطلاعات هیچ یک
    /v5/حساب/معامله-راه /یکپارچه/v3/خصوصی/حساب/معامله-log
    /v5/حساب/تنظیم حاشیه /قرارداد/v3/خصوصی/حساب/setMarginMode
    نشانه اهرم نقطه ای /v5/spot-lever-token/اطلاعات /Spot/V3/عمومی/INFOS
    /v5/spot-lever-token/مرجع /spot/v3/خصوصی/سفارش/مرجع
    /V5/Spot-Lever-Token/خرید /spot/v3/خصوصی/سفارش/خرید
    /V5/Spot-Lever-Token/بازخرید /spot/v3/خصوصی/سفارش/بازخرید
    /v5/Spot-Lever-token/order-Record /spot/v3/خصوصی/سفارش/ضبط
    تجارت حاشیه نقطه /V5/TRADE/SPOT-MARGIN/SWITCH-MODE /Spot/v3/خصوصی/متقاطع-سوئیچ
    /V5/Trade-Trade/Set-Le هیچ یک
    /V5/تجارت-تجارت/Set-set-token هیچ یک
    دارایی /v5/دارایی/تحویل رکورد /یکپارچه/v3/خصوصی/تحویل رکورد
    /v5/دارایی/تسویه حساب /متحد/v3/خصوصی/تسویه حساب
    /v5/دارایی/انتقال/انتقال بین /دارایی/v3/خصوصی/انتقال/انتقال بین
    لیست V5/دارایی/انتقال/پرس و جو در لیست انتقال /دارایی/v3/خصوصی/انتقال/انتقال/لیست/پرس و جو
    V5/Asset/Transfer/Save-Transfer-Sub-Member /دارایی/v3/خصوصی/انتقال/انتقال-موضوع-عضو-
    /v5/دارایی/انتقال/انتقال جهانی /دارایی/v3/خصوصی/انتقال/انتقال جهانی
    /v5/دارایی/انتقال/پرس و جو-غیرقانونی-انتقال /دارایی/v3/خصوصی/انتقال/انتقال جهانی/لیست/پرس و جو
    /v5/دارایی/انتقال/پرس و جو-انتقال-رونق /دارایی/v3/خصوصی/انتقال/انتقال-سکه/لیست/پرس و جو
    /v5/دارایی/انتقال/پرس و جو-sub-member /دارایی/v3/خصوصی/انتقال/زیر عضو/لیست/Quer
    /v5/دارایی/انتقال/پرس و جو-حساب-سکه-توازن /دارایی/v3/خصوصی/انتقال/حساب-سکه/تراز/پرس و جو
    /v5/دارایی/انتقال/پرس و جو-asset-info /دارایی/v3/خصوصی/انتقال/دارایی- INFO/پرس و جو
    /v5/دارایی/سپرده/پرس و جو-لیست /دارایی/v3/عمومی/سپرده/لیست مجاز/لیست/پرس و جو
    /v5/دارایی/سپرده/پرس و جو /دارایی/v3/خصوصی/سپرده/ضبط/پرس و جو
    /v5/دارایی/سپرده/پرس و جو-موضوع-عضو-رکورد /دارایی/v3/خصوصی/سپرده/زیر عضو-رکورد/پرس و جو
    /v5/دارایی/برداشت/پرس و جو /دارایی/v3/خصوصی/برداشت/ضبط/پرس و جو
    /v5/دارایی/سکه/پرس و جو-ایفید /دارایی/v3/خصوصی/سکه-ای-ایفو/پرس و جو
    /v5/دارایی/برداشت/ایجاد /دارایی/v3/خصوصی/برداشت/ایجاد
    /v5/دارایی/برداشت/لغو /دارایی/v3/خصوصی/برداشت/لغو
    /v5/دارایی/سپرده/پرس و جو /دارایی/v3/خصوصی/سپرده/آدرس/پرس و جو
    /v5/دارایی/سپرده/پرس و جو-موضوع-عضو-آدرس /دارایی/v3/خصوصی/سپرده/زیر عضو-آدرس/پرس و جو
    /v5/دارایی/مبادله/سفارش ثبت /دارایی/v2/خصوصی/مبادله/پرس و جو-سفارش
    عمومی WebSocket wss: //stream. bybit. com/v5/public/spot wss: //stream. bybit. com/spot/public/v3
    wss: //stream. bybit. com/v5/public/linear wss: //stream. bybit. com/contract/usdt/public/v3
    wss: //stream. bybit. com/contract/usdc/public/v3
    wss: //stream. bybit. com/v5/public/inverse wss: //stream. bybit. com/contract/inverse/public/v3
    wss: //stream. bybit. com/v5/public/option wss: //stream. bybit. com/option/usdc/public/v3
    WebSocket Private wss: //stream. bybit. com/v5/private wss: //stream. bybit. com/spot/private/v3
    wss: //stream. bybit. com/unified/private/v3
    wss: //stream. bybit. com/contract/private/v3
    • بررسی اجمالی
    • پوشش API فعلی
    • ارتقاء کلیدی
      • تراز خطوط تولید
      • سهولت ارتقا
      • افزایش کارایی سرمایه
      • قرض گرفتن حساب یکپارچه
      • تجارت بلوک پارادایم
      • حالت حاشیه نمونه کارها
      • استاندارد نامگذاری رابط API
      • تنظیم حد API
      • هیچ تغییری در تأخیر وجود ندارد
      • رابط محل قرارگیری
      • افزودن پرس و جو سفارش در زمان واقعی
      • لغو سفارشات توسط ارز تسویه حساب
      • افزودن پرس و جو نرخ بودجه تاریخی
      • افزودن رابط صندوق بیمه
      • داده های اضافی WebSocket
      • فقط سفارشات پست را افزایش دهید
      • داده های یکنواخت و دقیق
      • بهبود خوانایی برای باز کردن مستندات API
نرم افزار مفید تریدر...
ما را در سایت نرم افزار مفید تریدر دنبال می کنید

برچسب : نویسنده : احمد شاملو بازدید : 29 تاريخ : شنبه 31 تير 1402 ساعت: 19:25

آرشیو مطالب

پيوندهای روزانه

لینک دوستان

خبرنامه