Exchange Stream API - Release Notification - Tuesday 10th November

Collapse
This topic is closed.
X
X
 
  • Time
  • Show
Clear All
new posts
  • BetfairDeveloperProgram
    Administrator
    • Oct 2008
    • 680

    #1

    Exchange Stream API - Release Notification - Tuesday 10th November

    As part of an Exchange Stream API release on Tuesday 10th November a fullImage (boolean) field will be added to the OrderMarketChange object

    This change has been reflected in this update to the Swagger definition: https://github.com/betfair/stream-ap...hema.json#L932
    The Java and C# sample code has been updated and can be viewed via https://github.com/betfair/stream-ap...663585ad652d6f

    The fullImage field is a boolean and behaves in the same way as the existing fulImage field on the OrderRunnerChange object.

    Documentation updates (shown in bold)

    Key fields:
    • <as for ChangeMessage>
    • oc / OrderAccountChange - the modifications to account's orders (will be null on a heartbeat)
      • id / Market Id - the id of the market the order is on
      • fullImage - replace existing data at market level with the data supplied: it is not a delta (or null if delta)
      • orc / Order Changes - a list of changes to orders on a runner
        • fullImage - replace existing data at runner level with the data supplied: it is not a delta (or null if delta)
        • id / Selection Id - the id of the runner (selection)
    An order cache is somewhat simpler as orders are sent in full (on change) and only matches need delta merging
    • fullImage - if the market or runner's fullImage value is set to true then you should replace this item in your cache N.B. it is possible for the fulllImage flag to sent with an empty update for a market/runner which indicates you no longer have any position on that market/runner and it can be removed from your cache completely
    • Orders - replace each order according to order id.
    • Price point / full depth ladders
    • [1.2, 20] -> Insert / Update price 1.2 with size 20
    • [1.2, 0] -> Remove price 1.2 i.e. there is no size at this price
    An empty list of points also means the ladder is now empty

    Example of market-level snapshot with fullImage = true


    During normal streaming, you may on rare occasions receive a market-level snapshot, in which case you should replace the item in your cache. The update will be a fullImage, as shown in the example below:

    Code:
    [B]{"clk": "AIElAJgiAIYjAMAhAOsm", "oc": [{"orc": [{"uo": [{"status": "E", "rfs": "", "sm": 0, "pt": "L", "sr": 2, "rc": "REG_GGC", "sv": 0, "side": "B", "p": 990, "s": 2, "pd": [URL="tel:1603894536000"]1603894536000[/URL], "sl": 0, "sc": 0, "ot": "L", "rfo": "", "id": "[URL="tel:215144775671"]215144775671[/URL]", "rac": ""}], "id": 30246, "fullImage": true}], "id": "1.174743281", "fullImage": true}], "pt": [URL="tel:1603895058618"]1603895058618[/URL], "op": "ocm"}[/B]



    BDP Support
    Last edited by BetfairDeveloperProgram; 05-11-2020, 07:45 AM.
  • BetfairDeveloperProgram
    Administrator
    • Oct 2008
    • 680

    #2
    This release is now live

    BDP Support

    Comment

    • Garincha
      Banned
      • Nov 2020
      • 4

      #3
      Thanks
      Already used it

      Comment

      Working...
      X