• Notifications Markets & Prices
      View more
    • Language & Exchange Rate Switch
    • Preference Settings
      Rise/fall colour
      Starting time for price change
    Coin Price 24h %
    Back To

    Gate.io Futures API upgrade (New orderbook API with 10ms update)

    Creation Time:2021-03-12 14:23:52 UTCRead:96327

    Gate.io has upgraded the Futures websocket API with new orderbook update methods. This upgrade includes:

    1) Added a new order book channel futures.book_ticker to push best ask/bid in realtime (10ms)
    2) Added a new order book channel futures.order_book_update to push order book change with user specified update frequency (100ms and 1000 ms)


    How to maintain local order book using the new orderbook API?

    1) Subscribe futures.order_book_update with specified level and update frequency, e.g. ["BTC_USDT", "1000ms", "10"] pushes the first 10 levels' update in BTC_USDT order book every 1s
    2) Cache WebSocket notifications. Every notification use U and u to tell the first and last update ID since last notification.
    3) Retrieve base order book using REST API (order_book method), and set with_id=true to make sure the order book ID is recorded(referred as baseID below) e.g. https://api.gateio.ws/api/v4/futures/usdt/order_book?contract=BTC_USDT&limit=10&with_id=true retrieves the 10-level base order book of BTC_USDT
    4) Iterate the cached WebSocket notifications, and find the first one which contains the baseID, i.e. U <= baseId+1 and u >= baseId+1, then start consuming from it. Note that sizes in notifications are all absolute values. Use them to replace original sizes in corresponding price. If size equals to 0, delete the price from the order book.
    5) Dump all notifications which satisfy u < baseID+1. If baseID+1 < first notification U, it means current base order book falls behind notifications. Start from step 3 to retrieve newer base order book.
    6) If any subsequent notification which satisfy U > baseID+1 is found, it means some updates are lost. Reconstruct local order book from step 3.

    Gate.io is an established exchange that holds integrity, transparency, and fairness to a very high standard. We charge zero listing fees and only choose quality and promising projects. Our exchange consists only of 100% real trading volume. Thanks to everyone who has joined us in our journey. We always intend to improve and innovate to reward our users for their continuous support.


    Gate.io Team
    March 12, 2021

    Get 40% of all referees' trading fees in the affiliate program at https://www.gate.io/referral
    Click to Sign up :https://www.gate.io/m#/register
    Download it now at: https://www.gate.io/mobileapp

    Follow us on social
    Facebook: https://facebook.com/gateioglobal
    Twitter: https://twitter.com/gate_io
    Telegram:https://t.me/gateio
    Instagram:https://www.instagram.com/gateioglobal
    Medium:https://medium.com/@gateio
    Share with:
    gate.io APP

    gate.io APP 2.0

    gate.io APP 2.0
    Download
    language and region
    exchange rate
    Survey with rewards
    Participate in a survey, Win a reward of 20USDT
    Start survey
    Survey with rewards
    Participate in a survey, Win a reward of 20USDT