Betfair.Interfaces 1.0.0-alpha-0

Betfair

Fast and simple classes for interacting with the Betfair API and Stream.

I'm passionate about this library and love hearing from users! Join our Discussions to ask questions, share your experiences, or suggest new features. Your feedback helps make this library better for everyone.

Full documentation.

Installation

Available on NuGet

dotnet add package Betfair

or

PM> Install-Package Betfair

How to Subscribe to a Market Stream

Create a Subscription, define your filters, and run the zero-allocation market cache.
Full subscription documentation.

var credentials = new Credentials("USERNAME", "PASSWORD", "APP_KEY");
using var subscription = new Subscription(credentials);

var filter = new StreamMarketFilter().WithMarketIds("MARKET_ID");
var data = new DataFilter().WithBestPrices().WithLastTradedPrice();

await subscription.RunMarketCache(filter, data, onUpdate: processor =>
{
    var market = processor.GetMarket("MARKET_ID");
    if (market is null) return;

    foreach (var runner in market.RunnerSpan)
    {
        var bestBack = runner.BestAvailableToBack.GetPrice(0);
        var bestLay = runner.BestAvailableToLay.GetPrice(0);
        // React to price changes with minimal latency
    }
}, cancellationToken: cts.Token);

Optional Logging

Enable structured logging of connection lifecycle events (connect, reconnect, errors) by passing a logger:

using var subscription = new Subscription(credentials, new SubscriptionOptions
{
    Logger = loggerFactory.CreateLogger<Subscription>()
});

How to List Today's Horse Races

var credentials = new Credentials("USERNAME", "PASSWORD", "APP_KEY");

using var client = new BetfairApiClient(credentials);

var filter = new ApiMarketFilter()
    .WithMarketTypes(MarketType.Win)
    .WithCountries(Country.UnitedKingdom, Country.Ireland)
    .WithEventTypes(EventType.HorseRacing)
    .FromMarketStart(DateTimeOffset.UtcNow)
    .ToMarketStart(DateTimeOffset.UtcNow.AddDays(1));

var query = new MarketCatalogueQuery()
    .Include(MarketProjection.Event)
    .Include(MarketProjection.MarketStartTime)
    .Include(MarketProjection.MarketDescription)
    .Include(MarketProjection.RunnerDescription)
    .OrderBy(MarketSort.FirstToStart)
    .Take(200);

var marketCatalogues = await client.MarketCatalogue(filter, query);

Or use the helper extension.

var filter = new ApiMarketFilter()
    .TodaysCard();

var query = new MarketCatalogueQuery()
    .Include(MarketProjection.Event)
    .Include(MarketProjection.MarketStartTime)
    .Include(MarketProjection.MarketDescription)
    .Include(MarketProjection.RunnerDescription)
    .OrderBy(MarketSort.FirstToStart)
    .Take(200);

var marketCatalogues = await client.MarketCatalogue(filter, query);