- Endpoint & Required Headers
- Example Request
- Supported Locales
- Navigation Data File Structure
- JSON Model Structure
Endpoint & Required Headers
This request allows the retrieval of the full Betfair market navigation menu from a compressed file.
The file can be accessed via https://api.betfair.com/exchange/betting/rest/v1/en/navigation/menu.json and is updated every 5 minutes.
The following request headers are required:
- X-Application - Your Application Key
- X-Authentication - Your session token, obtained from the API login response.
The following request headers are optional
- Host- Host on which the request is being called
- X-IP - IP from which the request has been made.
Example Request
Supported Locales
The following languages are supported by the navigation file:
English - en
Spanish - es
Italian - it
German - de
Swedish - sv
Portuguese -pt
Russian - ru
Greek - el
Bulgarian – bg
Danish - de
Navigation Data File Structure
This is a diagram showing how the LHM Data File is structured.
In plain English:
A ROOT group node has one or many EVENT_TYPE nodes
An EVENT_TYPE node has zero, one or many GROUP nodes
An EVENT_TYPE node has zero, one or many EVENT nodes
A Greyhound or Horse Racing EVENT_TYPE node has zero, one or many RACE nodes
A RACE node has one or many MARKET nodes
A GROUP node has zero, one or many EVENT nodes
A GROUP node has zero, one or many GROUP nodes
An EVENT node has zero, one or many MARKET nodes
An EVENT node has zero, one or many GROUP nodes
JSON Model Structure
ROOT
{ "children" : [ { EVENT_TYPE1 }, { EVENT_TYPE2 }, ... ], "id" : 0 , // always 0 "name" : "ROOT" , // always ROOT "type" : "GROUP" // always GROUP } |
EVENT_TYPE
{ "children" : [ { GROUP or EVENT or RACE (RACE only if Greyhounds/Horse Racing) }, ... ], "id" : "1" , // Betfair specific eventTypeId "name" : "Soccer" , "type" : "EVENT_TYPE" } |
GROUP
{ "children" : [ { GROUP or EVENT }, ... ], "id" : "74568202414" , // Not a Betfair specific id, different for every GROUP "name" : "Womens Soccer" , "type" : "GROUP" } |
EVENT
{ "children" : [ { GROUP or MARKET }, ... ], "id" : "27244118" , // Betfair specific eventId "name" : "South Korea U20 (W) v Mexico U20 (W)" , "type" : "EVENT" } |
RACE
{ "children" : [ { MARKET }, ... ], "id" : "27247020.1115" , // Betfair specific raceId "name" : "1300m 3yo" , "startTime" : "2014-08-12T11:15:00.000Z" , "type" : "RACE" , "venue" : "Deauville" } |
MARKET
{ "exchangeId" : "1" , // Betfair specific exchangeId "id" : "1.114881860" , // Betfair specific marketId "marketStartTime" : "2014-08-14T00:00:00.000Z" , // Betfair specific marketStartTime "name" : "Over/Under 6.5 Goals" , "type" : "MARKET" } |