Look up matched sports events by identifier

Canonical event key(s) to look up (for example, nba-okc-sas-2026-10-20), matched case-insensitively. Repeat the parameter for several events (do not comma-join them), and combine it freely with source_id, up to 100 unique identifiers in all. At least one event_id or source_id is required. A venue's own ID here (a Kalshi ticker, a numeric ID, an SX Bet L… fixture, an 0x hash, a ULID or a {provider}:{id} composite) is a 400 telling you to send it as source_id, and so is an empty value. So is a value that matches no canonical event but is a venue's identifier, most often a Polymarket slug: a night game's slug carries the UTC date (nfl-sea-den-2026-10-16 for the canonical nfl-sea-den-2026-10-15), and Polymarket spells some teams differently (cal for Calgary, la for the Rams).

Venue identifier(s) to look up, as {provider}:{id}: any market_id, market_slug or event_id that a data[].submarkets[].source_markets[] entry publishes, prefixed with that entry's provider. On Polymarket, Predict, AlphaArcade and Hyperliquid an outcome token (outcomes[].outcome_id) works too, because those tokens identify one market (a Hyperliquid token starts with #, which a URL must send as %23), and on Polymarket so does a market's conditionId, the ID wallet positions carry. Elsewhere outcome IDs are side names such as yes that repeat in every market: Kalshi's, Pred's and Limitless's yes/no and SX Bet's outcomeOne/outcomeTwo are a 400 that points to market_id. For example kalshi:KXNBAGAME-26OCT20OKCSAS (an event ticker), kalshi:KXNBAGAME-26OCT20OKCSAS-OKC (a market ticker), sxbet:L19766755 (a fixture), or Pred's pred:<parent_market_id>:<child_market_id> pair, or a Limitless market's slug. Only the text before the first colon is the provider, and it must be one of kalshi, polymarket, predict, sxbet, alpha-arcade, prophetx, pred, limitless or hyperliquid; anything else is a 400 naming the value. Matching is case-insensitive. lookups reports every identifier under its spelling as sent (whitespace around the provider and ID trimmed), with the canonical events it found. Repeat the parameter for several identifiers, across providers (a comma-joined list or an empty value is a 400); combined with event_id, up to 100 unique identifiers in all. At least one event_id or source_id is required. A lookup finds the event an identifier belongs to and, by default, returns it in full, so the submarket the identifier names is in it unless include_submarkets=false. A player prop finds its game under any player_prop_match policy when the game has another matched submarket, while the prop itself appears only when the policy admits it; a game matched only on props the policy excludes is not returned.

Selects which events the lookup searches. Defaults to false: only events whose scheduled start has not certainly passed — today's games, plus a one-day grace so a late start that runs past midnight Eastern is never dropped mid-play. Set it to true to also search the settled archive: events that left the live matching run, usually because the venues settled or delisted them. That adds games whose date is further in the past, including ones a venue still lists as open, and games a venue cancelled, which can be future-dated; the default leaves a cancelled game out.

Because it selects the population, a lookup for a past-dated or cancelled game answers 200 with the identifier listed in lookups with no events, unless this is true. A game that has started is served with the fullest mapping it had, as on the list: a lookup by another venue's identifier finds nothing for games archived before 2026-10-04 21:26 UTC, which kept only the venues that still listed them and age out of the 30-day archive by 2026-11-04.

Player-prop admission policy. It requires include_submarkets to be true, which it is by default on a lookup; with include_submarkets=false it is a 400. Matched case-insensitively. strict (the default) includes only groups of at least two distinct providers with verified player/game/stat/threshold/side identity and a completely reviewed equivalent settlement profile. same_prop retains exact prop identity but also admits different or unverified settlement rules, identified by settlement_equivalence and rule_comparisons. Unknown rules never prove equivalence. Applies with include_settled. Does not change game-line matching. Historical snapshots without verified player identity do not expose props.

When true, each event lists every matched submarket (spreads, totals, period lines and player props); when false, only its full-game moneyline, and an event appears only when that is matched. Defaults to true on a lookup, which returns the events it finds in full: a spread ticker shows its spread. Every submarket has the same shape, so code written against the moneyline reads the rest unchanged. This is an identity mapping only; fetch current status, quotes, and liquidity from the referenced market resources. Explicit player_prop_match requires this to be true.

When true, every moneyline, spread and total also lists rule_comparisons: the three rows (tie, overtime and push), each with every source market's value, a description and an evidence link, that sit behind its settlement_equivalence. When false, the default, a game line carries settlement_equivalence alone: the verdict is always there and only the rows are left out. The rows are about 60% of an event's bytes on a busy football slate, and a lookup returns every submarket, so ask for them when you want the evidence. A player prop always carries its own matrix, whatever this is. The flag changes what each event lists and never which events are found.