Markets component

Purpose

To provide information about the markets currently loaded into Bet Angel.

Currently via the API you can:

get a list of markets (with or without selections) currently loaded into Bet Angel
get price information from one or more markets including profit values and bet summaries
get information about the bets you have placed in a market

Endpoint

http://localhost:<port>/api/markets/v1.0/<operationName>

e.g. http://localhost:9000/api/markets/v1.0/getMarkets

Operations

getMarkets

GetMarketsResponse getMarkets( GetMarketsInstruction instruction )

Gets details about the markets currently loaded into Bet Angel. The fields returned will be based on the MarketDataItems requested in the GetMarketsInstruction.

The markets list in the result data will contain one MarketInfo object per market loaded into Bet Angel. If selection information was requested then each MarketInfo object will contain a list of SelectionInfo objects (one per selection).

This method is particularly useful for extracting the betfair Market Ids and Selection Ids and their associated names. This allows your client application, that may be working with real names from an external web site or database, to find the correct Id for use in other API calls.

getMarketPrices

GetMarketPricesResponse getMarketPrices( GetMarketPricesInstruction instruction )

Gets price information about the markets specified in the marketsFilter field of the instruction. If the marketsFilter is not specified then all markets currently loaded into Bet Angel will be used. The fields returned will be based on the MarketPriceDataItems requested in the GetMarketPricesInstruction. If required you can also request profit information and summaries about matched & unmatched bets for each selection in a market.

The markets list in the result data will contain one MarketPriceInfo object per market and each of those objects will contain a list of SelectionInfo objects (one per selection).

getMarketBets

GetMarketBetsResponse getMarketBets( GetMarketBetsInstruction instruction )

Gets information about the bets you have placed into a market. The marketId field of the instruction is used to specify which market you are interested in. The bets that are returned will depend on the filter being used. You can filter down to specific bet references or restrict to matched bets only or unmatched bets only. If no filter is specified, information about all bets will be returned.

The result data will be split between matched and unmatched bets (one list of MarketBetInfo objects for each).

If the bet returned was placed as an offset bet or a stop loss bet, then the linkedBetRef field will be populated to give the reference of the initial bet that caused this bet. The LinkReason will indicate whether this bet is an offset or a stop.