Mappings

GET /mappings?league=<league>&date=<date>

Each fixture's ids at data sources and trading venues, with the venue's instruments: the ids you trade or stream each outcome by. Parameters as in /fixtures.

curl -H "X-Api-Key: $KEY" "https://fixtures.halfpoint.tech/mappings?league=nfl&date=2026-10-29"

{
  "updated": "2026-10-29T23:36:43.479Z",
  "league": {"id": "nfl", "name": "NFL", "sport": "Football"},
  "fixtures": [
    {
      "id": "nfl-261029-car-gb",
      "mappings": {
        "ESPN": {"id": "401873023"},
        "venue1": {
          "id": "VQ7-M4T29XKD",
          "markets": {"moneyline": {"away": "VQ7-M4T29XKD-R8F", "home": "VQ7-M4T29XKD-J3W"}}
        },
        "polymarket": {
          "id": "1158894",
          "slug": "nfl-car-gb-2026-10-30",
          "markets": {"moneyline": {"away": "44088474…", "home": "14454103…"}}
        },
        "venue2": {
          "id": "1700008860",
          "markets": {"moneyline": {"away": "1700008860:219:5", "home": "1700008860:219:4"}}
        },
        ...
      }
    }
  ]
}

Keys

mappings has one entry per source or venue where we know the game, with its id; a venue also has markets, the instruments of each outcome. Which keys a fixture has varies and grows over time, so ignore keys you don't know.

A fixture has at most one id per source or venue, and a venue event belongs to one fixture.

Markets

market	leagues	outcomes
moneyline	MLB, NBA, NFL, NCAAF, NHL	away, home: the game winner incl. overtime / extra innings
moneyline_3way	EPL, Bundesliga, LaLiga, Champions League	away, home, draw: the three-way result (each the Yes side of the venue's market)

Mappings follow reschedules until a game starts; then they stay. Venues list games days to weeks ahead, so a fixture gets its venues as they appear.