# Player-prop matching (https://docs.predictorsdk.com/guides/player-prop-matching)

Compare the same player prop across venues, and see where their settlement rules differ.

Two markets can ask the same player to exceed the same line and still pay
differently when that player does not play. PredictorSDK separates **prop
identity** from **settlement equivalence**. These options apply to player props
only. Moneylines, spreads, and game totals publish a smaller matrix of their own
(tie, overtime, push), with its rows only when you send `include_rules=true`; a
player prop's matrix is always there. See [game-line rules](https://docs.predictorsdk.com/guides/game-line-rules).

## Choose a policy [#choose-a-policy]

Use the existing [sports matching endpoint](https://docs.predictorsdk.com/api-reference/getSportsMatchingMarkets).

| Request | Player props returned |
| --- | --- |
| No parameters | Each event's full-game moneyline only; no player props |
| `include_submarkets=true` | Strict settlement-equivalent player props only |
| `include_submarkets=true&player_prop_match=strict` | Same strict default, explicitly selected |
| `include_submarkets=true&player_prop_match=same_prop` | Verified same-prop identities, including different or unverified settlement rules |
| `player_prop_match` with `include_submarkets=false`, or in list mode without `include_submarkets=true` | `400`; the requested comparison would not be visible. A lookup sets `include_submarkets=true` by default. |
| A repeated or unsupported `player_prop_match` | `400`; no silent fallback |
| An empty `player_prop_match=` | The default, `strict`, like an empty value of any other control parameter |

Both policies work with list pagination, lookups (`event_id` and `source_id` on
`GET /v1/matching-markets/sports/lookup`), and `include_settled=true`. A cursor belongs to one policy and cannot be reused
after switching policies. Lookup still accepts at most 100 unique identifiers
and remains unpaginated. Without `include_submarkets=true`, each event carries
only its full-game moneyline, never player-prop outcomes.

```http
GET /v1/matching-markets/sports?include_submarkets=true&player_prop_match=same_prop
```

For a known event, call `GET /v1/matching-markets/sports/lookup?event_id=<canonical-event-id>`;
do not search every page to rediscover it. A result requires at least two distinct providers, not two
markets from the same venue. An event whose only matches are player props is
listed only when the policy admits its props: with
`include_submarkets=true&player_prop_match=same_prop` today, because the strict
policy currently admits none.

## What must match in both modes [#what-must-match-in-both-modes]

The sport and league, both teams, game date, player, statistic, full-game
period, threshold, and native selection meanings must agree. NFL kickoff dates
are normalized to America/New_York; Polymarket's UTC-dated slug is not used as
the Eastern game date (its NBA and WNBA slugs carry the Eastern day itself, a
night game's included). Player names are resolved against both teams' ESPN
rosters to an unambiguous athlete ID, and exactly one ESPN fixture must
corroborate the matchup and Eastern game day. An explicit source kickoff that
conflicts with ESPN is refused. A venue's name matches an athlete when it is
ESPN's name for that athlete, ignoring case, accents and punctuation. When no
athlete of the game has the name exactly, it also matches when the two differ
only by a generational suffix (Jr., Sr., II, III, IV or V) written on one side,
or when one first name is a short form of the other (Greg and Gregory, Nic and
Nicolas, Irv and Irvin), as long as exactly one athlete of the game fits. A few
athletes ESPN lists by a nickname or initials also match the legal name a venue
writes for them, through an alias reviewed for that athlete (Kevin Concepcion is
ESPN's KC Concepcion, and Zonovan Knight is Bam Knight). Two different suffixes
(Jr. and Sr.), two spellings of one name (Brian and Bryan), other nicknames that
aren't a short form of the name (Hollywood and Marquise), initials and surnames
alone don't match, and a name two athletes of the game share is refused.

For integer statistics, **250+ means Over 249.5**, not Over 250. A contract
requiring **more than 10 points** is not the same as **10+ points**. Only
verified nonnegative half-point thresholds are admitted in this release;
whole-number push contracts, exact-value/range bets, fractional statistics,
weekly accumulation, season props, and D/ST units are not player-prop matches.
Passing touchdowns and touchdowns scored are separate statistics.

Roster checks are performed during sports ingestion, with a five-minute
cache and bounded requests. A missing or stale roster, a team conflict, or an
ambiguous athlete removes that prop, not ordinary game lines. Current rosters
cannot certify historical membership: ingestion does not newly admit props
more than 48 hours past their scheduled start. Previously verified archived
props remain eligible under `include_settled=true`; older snapshots without
identity verification do not acquire it retroactively.

## Read the rule matrix [#read-the-rule-matrix]

Every returned player prop has `settlement_equivalence` and `rule_comparisons`.

| Equivalence | Meaning |
| --- | --- |
| `equivalent` | Every source has a completely reviewed, equivalent settlement profile |
| `different` | At least one known difference exists, even if other rules remain unknown |
| `unverified` | No difference has been established, but equivalence has not been proved |

Each `rule_comparisons` row has a machine-readable `rule`, readable `label`,
`comparison`, and `source_values`. Each source value names its exact
`provider` and `market_id`, a machine-readable `value`, a plain-language
`description`, and an `evidence_url` when verified. The matrix always covers:

| Rule | What to check |
| --- | --- |
| `non_participation` | Inactive, withdrawn, or no-play settlement; minimum participation |
| `overtime` | Whether overtime statistics count |
| `stat_definition` | Which statistic and attribution rules govern |
| `threshold` | Comparison operator, equality, and push behavior |
| `stat_corrections` | Whether later official corrections can change settlement |
| `postponement` | How long a delayed game remains eligible |
| `cancellation` | Fair-price settlement, split payout, or refund conditions |
| `interruption` | Abandonment, minimum play, and restart conditions |
| `resolution_source` | Official source, fallbacks, and missing-data handling |

Filter rows with `comparison=different` to find known differences. Filter
`unverified` rows to find evidence gaps. Values are extensible strings; display
the description rather than guessing an unfamiliar value's meaning. A row can
have a known difference and still contain an `unknown` source value. Agreement
on observed clauses is not a complete contract review, and unknown values
never mean equivalent or unrestricted.

Rule evidence is attached to individual source contracts, not assumed from
the provider's name. Market clauses are observed at ingestion. Kalshi product
terms require the current series to link to the reviewed document; ProphetX
requires its filings index to retain the reviewed NFL filing. Both require the
document's SHA-256 to match the reviewed version; these
checks are cached for at most five minutes. Changed or unavailable documents
leave affected dimensions unknown. Known unresolved wording is not assigned
an invented precedence. Read the evidence link for additional applicable terms.

## Example: a no-play difference [#example-a-no-play-difference]

The September 2026 audit found Josh Allen passing-yard props with matching
game/player/249.5 identities, but different non-participation treatment:

| Source | Active player takes no snap |
| --- | --- |
| Polymarket | Under wins; Over loses |
| Kalshi | Settles at a pregame fair price, not necessarily zero or one |
| ProphetX | Filed rules require active status and at least one snap for validity; no automatic Under win |

A fair-price settlement, a 50-50 split, and a purchase-price refund are not
interchangeable. A same-prop match is useful for discovery and comparison; it
does not establish a risk-free arbitrage or a perfect hedge.

For a comparison UI, show the prop's `display_name`, an overall
`settlement_equivalence` badge, and the descriptions from each rule row. Keep
unknown rows visible. A simplified excerpt (the actual response contains all
nine rows and exact source market references) looks like:

```json
{
  "display_name": "Josh Allen Passing yards O/U 249.5",
  "settlement_equivalence": "different",
  "rule_comparisons": [
    {
      "rule": "non_participation",
      "label": "Player does not participate",
      "comparison": "different",
      "source_values": [
        {
          "provider": "kalshi",
          "market_id": "KXNFLPASSYDS-26SEP13BUFHOU-BUFJALLEN17-250",
          "value": "no_participation_fair_price",
          "description": "Inactive/withdrawn players settle at a fair price; active players taking no snap settle at the pregame fair price. A snap nullified by penalty counts as participation.",
          "evidence_url": "https://assets.kalshi.com/contract_terms/FOOTBALLENTITYSTAT.pdf"
        },
        {
          "provider": "polymarket",
          "market_id": "4080510",
          "value": "under_wins",
          "description": "If the player does not participate or is inactive, Under/No wins and Over/Yes loses.",
          "evidence_url": "https://gamma-api.polymarket.com/markets/4080510"
        }
      ]
    }
  ]
}
```

## Coverage and limitations [#coverage-and-limitations]

| Provider | Player-prop admission in this release |
| --- | --- |
| Kalshi | Thirteen NFL families listed below, and the NBA and WNBA statistics in the basketball table below. Each is an "N+" market, matched as over N − 0.5, when its title and rules text name the statistic in the series' own words |
| Polymarket | The NFL families below it lists (its touchdowns-scored props now count fewer touchdowns, see below), and the NBA and WNBA statistics in the basketball table below, when the question and both sides of the rules text name the statistic in Polymarket's own words |
| Predict | No new admission: weekly NFL contracts are not single-game props; a bridge alone does not certify prop rules or selections |
| ProphetX | Eleven NFL integer-stat families below, each half-point line of a prop's ladder matched on its own; whole-number lines and contradictory selections are refused. Its NFL touchdown scorers (To Score a Touchdown, 2+ and 3+) are matched as touchdowns scored over 0.5, 1.5 and 2.5 |
| Pred | NBA full-game player points (`<Player> Points Over N`, a half-point line, `yes` over and `no` the line or fewer) when its rules text names the same game, start, threshold and full game including overtime; its other families and leagues are not admitted |
| Polymarket US | NFL families below, and NBA and WNBA points, rebounds, assists, threes, steals, blocks and points + rebounds + assists. Each market is "N or more" (`yes`) against fewer (`no`), matched as over N − 0.5, when its rules text names the same player, game, threshold and full game including overtime |
| SX Bet, AlphaArcade, Hyperliquid | No verified game player-prop pairing in the audited NFL inventories |

| NFL statistic | Kalshi | Polymarket | ProphetX | Polymarket US |
| --- | --- | --- | --- | --- |
| Passing yards | Yes | Yes | Yes | Yes |
| Rushing yards | Yes | Yes | Yes | Yes |
| Receiving yards | Yes | Yes | Yes | Yes |
| Receptions | Yes | Yes | Yes | Yes |
| Passing completions | Yes | Yes | Yes | Yes |
| Passing touchdowns | Yes | Yes | Excluded: filing assigns the scorer to the receiver | Yes |
| Touchdowns scored (anytime / 2+ / 3+) | Yes | No: rushing and receiving touchdowns only | Yes (To Score a Touchdown, 2+, 3+) | Yes (passing touchdowns excluded) |
| Passing attempts | Yes | Yes | Yes | Yes |
| Passing interceptions | Yes | No observed family | Yes | Yes |
| Rushing attempts | Yes | No observed family | Yes | Yes |
| Rushing + receiving yards | Yes | No observed family | Yes | Yes |
| Longest reception | Yes | Yes | Yes | Yes |
| Longest rush | Yes | No observed family | Yes | Yes |

| NBA and WNBA statistic (`metric`) | Kalshi | Polymarket | Polymarket US | Pred |
| --- | --- | --- | --- | --- |
| Points (`points`) | Yes | Yes | Yes | NBA |
| Rebounds (`rebounds`) | Yes | Yes | Yes | No |
| Assists (`assists`) | Yes | Yes | Yes | No |
| Three-pointers made (`threes`) | Yes | Yes | Yes | No |
| Steals (`steals`) | NBA | Yes | Yes | No |
| Blocks (`blocks`) | NBA | Yes | Yes | No |
| Points + rebounds + assists (`points_rebounds_assists`) | NBA | No observed family | Yes | No |

These are the statistics that can match, not a promise that every venue lists
a line for each one. Each venue words a statistic its own way, and the check
reads exactly that wording: Kalshi's threes titles say "3+ threes" and its
rules "3+ made three-pointers", Polymarket's question says "3-Pointers Made",
and Polymarket's rebounds rules count "more than 7.5 total rebounds" against
"7.5 rebounds or fewer". A market in any other wording isn't matched. Polymarket's touchdowns-scored props count rushing and
receiving touchdowns only ("Defensive and special teams touchdowns do not
count"), while Kalshi and Polymarket US count every touchdown a player scores
except a passing one, so a kick-return touchdown settles them differently and
they are not matched. ProphetX lists each prop as a ladder of lines, and every
half-point line is matched as its own market, named
`<event_id>:<market_id>:<line>`; a whole-number line is left out. Each line's
labels and value must agree on every side of that line.

ProphetX's touchdown scorers are `YES`/`NO` markets with no ladder: "To Score a
Touchdown", "To Score 2+ Touchdowns" and "To Score 3+ Touchdowns". `YES` is
the over side of 0.5, 1.5 or 2.5 touchdowns scored (`side` `yes`) and `NO` the
under (`side` `no`), and each market is named by its own
`<event_id>:<market_id>`. ProphetX's NFL terms, as
amended in August 2026, settle the official NFL total touchdowns and credit a
passing touchdown to the receiver, which is Kalshi's and Polymarket US's
statistic. Its first and last touchdown scorers are other contracts and aren't
matched.

Predict's player props are weekly contracts rather than single games, so they
aren't matched. SX Bet, AlphaArcade and Hyperliquid list no player props that
pair with another venue's. A venue's sport tag alone never makes a match: a
prop has to name a verified player, game, statistic and line.

Venues and ESPN don't always write a suffix the same way. Polymarket, Polymarket
US and the Chiefs' published roster name Kenneth Walker, while ESPN calls athlete
`4567048` Kenneth Walker III, and Kalshi, Polymarket and Polymarket US list Joe
Milton III, whom ESPN lists as Joe Milton. Each of them matches, and the prop is
published under ESPN's name and athlete ID.

First names differ too. Kalshi, Polymarket and Polymarket US list Gregory
Desrosiers, whom ESPN lists as Greg Desrosiers Jr., and Polymarket and Polymarket
US list Nicolas Claxton, whom ESPN lists as Nic Claxton. These match the same way.

What's listed changes from week to week. Kalshi, Polymarket and Pred list NBA
points props for upcoming games. Pred writes its rules into each market, so its
rule values are read from that text, as Polymarket's are: a player who doesn't
play resolves `No`, overtime counts, a postponed game stays open, and a
cancelled one resolves 50-50. It differs from Kalshi and Polymarket on one
point: a correction to the official stats made after the game, but before the
market resolves, counts on Pred.

Polymarket US also writes its rules into each market, one template per sport.
Its values differ from the other venues' on three points. A player who doesn't
take part (a snap in football, playing time in basketball) settles the market
at its last fair market price (`last_fair_market_price`) rather than as a loss
for `yes`. A stat correction counts until the market settles
(`excluded_after_settlement`). A game rescheduled to within two days of its
original time keeps the market open, and one rescheduled later settles it at
the last fair market price (`last_fair_market_price_unless_within_two_days`).
Overtime counts. Its props join Kalshi's, Polymarket's and Pred's under
`same_prop`, and each venue's side of the difference is in the rule matrix.

No venue pair has a fully reviewed settlement profile yet, so the default strict
mode can return no player props at all. Use `same_prop` to see matched props
with their rule differences.

Canonical player keys use `espn_<league>_<athlete-id>`. Same-prop keys identify
the base prop; strict keys additionally identify a reviewed settlement group.
One base prop can contain several equivalent subsets: strict mode emits each
qualifying subset separately and never pulls in an incompatible third venue.
Join native market/outcome IDs to [market detail](https://docs.predictorsdk.com/api-reference/getMarket)
for current data; this endpoint adds no prices, liquidity, or execution advice.

ProphetX market detail converts its Trading API's American-odds offers into
probabilities: the cheapest available back offer is the named selection's
`ask`, and the opposite selection's ask supplies the complementary `bid`.
`price` is the midpoint when both are present, not a last trade or a guaranteed
fill. A one-sided book remains one-sided, and an empty book has null quotes.
These quote conventions do not establish settlement equivalence or make one
line of a ProphetX ladder interchangeable with another.