# SDKs 0.21.0 read matching events from data and lookups (https://docs.predictorsdk.com/changelog/2026-10-04-sdk-0-21-0)

2026-10-04 · SDK, Breaking

The TypeScript, Python, and Go SDKs 0.21.0 type GET /v1/matching-markets/sports as a data array of events plus lookups, with labels and market names required.

The TypeScript (`@predictorsdk/client`), Python (`predictorsdk`), and Go (`github.com/PredictorSDK/sdk-go`) SDKs are released at 0.21.0, typing the [matching response changes](https://docs.predictorsdk.com/concepts/matching-markets) shipped the same day. Upgrade now: 0.20.0 and earlier cannot read the new response. Python's client requires the `canonical_events` field the API no longer sends and raises on every matching call, and TypeScript and Go find no events.

- **Events are `data`, a list in start order.** TypeScript `response.data` (`CanonicalSportsEvent[]`), Python `response.data`, Go `response.Data` (`[]*CanonicalSportsEvent`) replace the `canonicalEvents` / `canonical_events` / `CanonicalEvents` map. Read each event's ID from its own `eventId` / `event_id` / `EventID`.
- **Lookups are `lookups`.** A map from each identifier you sent to a `SportsMatchingLookup` with `eventIds` / `event_ids` / `EventIDs`, empty when the identifier found nothing. It is absent (`undefined`, `None`, `nil`) on a list page.
- **Fields that are always present are required.** A source market's `marketName` / `market_name` / `MarketName` and its outcomes' `label` and `outcomeId` / `outcome_id` / `OutcomeID` are plain strings now, as are an event's sport, league and participants, a participant's name and role, a submarket's display name and metric, and a canonical outcome's type and side. In Go each changes from `*string` to `string`, so drop the dereference: `*m.MarketName` becomes `m.MarketName`. That is the source-breaking part for Go; TypeScript and Python only lose an `undefined` / `None` case.
- **The docstrings match the API**: `include_submarkets` defaults by mode, `source_id` accepts Polymarket condition IDs and rejects side names, and Kalshi and Pred outcomes are labelled `Yes`/`No`.