Lightweight, super fast pythonic wrapper for Betfair API-NG allowing all betting operations (including market and order streaming) and most account operations.
Currently tested on Python 2.7, 3.4 and 3.5.
$ pip install betfairlightweight
Add your certificates to '/certs/' and app_key to environment variables with username as key before using.
.bash_profile
export username = "appkey"
The library can then be used as follows:
>>> import betfairlightweight
>>> trading = betfairlightweight.APIClient('username', 'password', app_key='app_key')
>>> trading.login()>>> event_types = trading.betting.list_event_types({'filter': {}})
[<EventTypeResult>, <EventTypeResult>, ..]Currently two listeners available, below will run the base listener which prints anything it receives. Stream listener is able to hold an order stream and a market stream, although it is recommended to have one socket per stream. The listener can hold a cache and push market_books/order_books out via a queue.
from betfairlightweight import StreamingMarketFilter, StreamingMarketDataFilter
betfair_socket = trading.streaming.create_stream(unique_id=2, description='Test Market Socket')
market_filter = StreamingMarketFilter(
event_type_ids=['7'],
country_codes=['IE'],
market_types=['WIN'],
)
market_data_filter = StreamingMarketDataFilter(
fields=['EX_ALL_OFFERS', 'EX_MARKET_DEF'],
ladder_levels=3
)
betfair_socket.subscribe_to_markets(unique_id=12345,
market_filter=market_filter,
market_data_filter=market_data_filter)
betfair_socket.start(async=False)