> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsxapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query market data with the SportsX C# SDK

> Use STXMarketService and STXEventService to list markets, filter by sport or status, paginate results, and browse the sports and competitions catalog.

Market data in the SportsX SDK is split across two services. `STXMarketService` gives you individual markets and their counts. `STXEventService` gives you events (a match or game) with their associated markets pre-loaded in a single call.

## List markets

Resolve `STXMarketService` and call `GetMarketInfosAsync` for a full list of markets:

```csharp theme={null}
var markets = serviceProvider.GetRequiredService<STXMarketService>();

var resp = await markets.GetMarketInfosAsync();

foreach (var m in resp.MarketInfos)
{
    Console.WriteLine($"{m.MarketId}  {m.Status}  {m.Title}");
}
```

For lightweight lookups where you already know the IDs, use `GetShortMarketInfosAsync` to retrieve a reduced payload:

```csharp theme={null}
var ids = new[] { "mkt_abc", "mkt_def" };
var shortMarkets = await markets.GetShortMarketInfosAsync(ids);
```

## Filter markets

`STXMarketInfosFilter` combines the common filter fields. Pass it to `GetMarketInfosAsync` or `GetMarketInfosWithCountAsync`:

| Field              | Type                    | Notes                             |
| ------------------ | ----------------------- | --------------------------------- |
| `Status`           | `STXMarketInfosStatus`  | `OPEN`, `CLOSED`, etc.            |
| `Trading`          | `STXMarketInfosTrading` | `TRUE`, `FALSE`, or `ALL`         |
| `Sport`            | `string`                | e.g. `"basketball"`, `"baseball"` |
| `Competition`      | `string`                | e.g. `"NBA"`, `"MLB"`             |
| `EventId`          | `string`                | Only markets for a specific event |
| `Limit` / `Offset` | `int`                   | Pagination controls               |

```csharp theme={null}
var filtered = await markets.GetMarketInfosAsync(new STXMarketInfosFilter
{
    Status      = STXMarketInfosStatus.OPEN,
    Trading     = STXMarketInfosTrading.TRUE,
    Sport       = "basketball",
    Competition = "NBA",
});
```

## Pagination

`GetMarketInfosWithCountAsync` returns both the paginated result and the total count. Use it when you need to display "showing N of M" or drive a full offset/limit scan:

```csharp theme={null}
var page = await markets.GetMarketInfosWithCountAsync(new STXMarketInfosFilter
{
    Status  = STXMarketInfosStatus.OPEN,
    Trading = STXMarketInfosTrading.TRUE,
    Limit   = 100,
    Offset  = 0,
});

Console.WriteLine($"Fetched {page.MarketInfos.Count} of {page.Count} total markets");
```

## Browse sports and competitions

`GetSportAndCompetitionsAsync` returns the full catalog of sports and their associated competitions:

```csharp theme={null}
var catalog = await markets.GetSportAndCompetitionsAsync();

foreach (var sport in catalog)
{
    Console.WriteLine(sport.Sport);
    foreach (var competition in sport.Competitions)
        Console.WriteLine($"  {competition}");
}
```

Use the sport and competition strings from this call as filter values in `STXMarketInfosFilter`.

## Query events

`STXEventService` bundles an event with its markets in one call — no need to make separate per-event requests:

```csharp theme={null}
var events = serviceProvider.GetRequiredService<STXEventService>();

var resp = await events.GetEventInfosAsync(new STXEventInfosFilter
{
    Sport = "basketball",
    EventStatusFilter = new[]
    {
        STXEventStatus.scheduled,
        STXEventStatus.live,
    },
});

foreach (var ev in resp.EventInfos)
{
    Console.WriteLine($"{ev.EventId}  {ev.Title}  ({ev.MarketInfos.Count} markets)");
}
```

## Real-time price updates

REST calls are appropriate for snapshots and catalog browsing. For live price ticks on open markets — where latency matters — subscribe to the `STXMarketChannel` WebSocket wrapper instead:

```csharp theme={null}
var marketChannel = serviceProvider.GetRequiredService<STXMarketChannel>();

marketChannel.OnPriceUpdate += tick =>
{
    Console.WriteLine($"{tick.MarketId}  bid={tick.BestBid}  ask={tick.BestAsk}");
};

await marketChannel.ConnectAsync();
await marketChannel.SubscribeAsync("mkt_abc", "mkt_def");
```

See [WebSockets](/sdks/csharp/websockets) for the full channel API including subscribe/unsubscribe at runtime.