# Matching lookups: outcome tokens, any case, and errors instead of silent misses (https://docs.predictorsdk.com/changelog/2026-10-04-matching-lookup-hardening)

2026-10-04 · New, Fix, Breaking

GET /v1/matching-markets/sports finds events by outcome token, matches identifiers case-insensitively, and rejects lookup mistakes that used to answer an empty or unrelated 200.

A review of the new matching response, as a customer would use it, found
lookups that failed quietly. This release fixes them.

**New.**

- `source_id` accepts an outcome token on Polymarket, Predict and AlphaArcade:
  `source_id=polymarket:<clob token id>` finds the game the token belongs to.
  These tokens identify one market on their own. Other venues' outcome IDs
  (`yes`, `outcomeOne`, `4`) name a side within one market and are not accepted.
- Lookups match case-insensitively: `source_id=kalshi:kxnbagame-26oct20okcsas`
  and `event_id=NBA-OKC-SAS-2026-10-20` find the same games as the venue's own
  spelling. The response is still keyed by the identifier as you sent it.

**Errors instead of silent misses.** Each of these used to answer `200` with an
empty or unrelated result, and now answers `400` quoting the rejected value:

- an empty lookup value (`source_id=`), which used to list 25 unrelated events;
- a comma-joined list (`source_id=kalshi:A,kalshi:B`), which used to match
  nothing; repeat the parameter instead;
- a venue's own ID sent as `event_id` (a Kalshi ticker, a numeric ID, an SX Bet
  `L…` fixture, an `0x` hash, a ULID), which used to match nothing; send it as
  `source_id={provider}:{id}`.

A retired lookup parameter such as `kalshi_event_ticker` still answers `400`,
and its message now names the replacement (`source_id=kalshi:{id}`).

**Default population.** Without `include_submarkets=true` the response publishes
only each event's full-game moneyline, so it now lists only events whose
full-game moneyline is matched, and `submarkets` is never empty. An event
matched only on spreads, totals or props used to appear with no submarkets; set
`include_submarkets=true` to see it.

**Also:**

- `source_markets[].event_id` is now a required field. It was always present
  in practice; the next SDK release types it as a plain string (Go `EventID`
  changes from `*string` to `string`).
- Event titles always use the participants' full names
  ("Arizona Cardinals vs. New York Giants"). Some used a venue's abbreviated
  title, and one event matched only on a Predict spread was titled
  "Spread -3.5".