Skip to Content
PredictorSDK

Matching lookups: outcome tokens, any case, and errors instead of silent misses

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.

NewFixBreaking

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".