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.
A review of the new matching response, as a customer would use it, found lookups that failed quietly. This release fixes them.
New.
source_idaccepts 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-26oct20okcsasandevent_id=NBA-OKC-SAS-2026-10-20find 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 BetL…fixture, an0xhash, a ULID), which used to match nothing; send it assource_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_idis now a required field. It was always present in practice; the next SDK release types it as a plain string (GoEventIDchanges from*stringtostring).- 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".