Mapping OpticOdds IDs to ProphetX IDs

If you already integrate with OpticOdds for sports data, GET /v4/mm/get_mappings translates their IDs into ProphetX IDs — or the other direction — so you don't need to maintain your own mapping table. provider is the only query parameter that names the data source, and opticodds is the only value it accepts today; more providers may be added later.

Request

GET /partner/v4/mm/get_mappings

If you set both a provider_ids filter and a prophetx_ids (or prophetx_strike_ids) filter on the same call, a mapping must match both lists, not either — the filters are ANDed together.

Results are ordered by provider_id, descending.

Response

{
  "data": {
    "mappings": [
      {
        "provider": "opticodds",
        "entity_type": "market",
        "provider_id": "point_spread",
        "prophetx_id": 219,
        "event_id": 10078829
      }
    ],
    "next_cursor": "<opaque string, omitted on the last page>"
  }
}

prophetx_id is set for sport_event, player, competitor, and market. A strike has no single integer ID — use prophetx_strike_id instead, which matches the strike_id you already see on market selections.

Markets and strikes are only mapped for events that actually came from the given provider, and only once that market or strike has a provider key. Don't expect a mapping for every ProphetX market — only the ones ProphetX actually sourced from OpticOdds.

What provider_id and the ProphetX ID mean, by entity_type

Market provider_id formats

One OpticOdds market can become more than one ProphetX market, so the format depends on the shape:

Strike provider_id format

<fixture_id>:<market provider_id>:<outcome>:<points>

• outcome is lowercase: over, under, home, away, yes, or no.
• points is the strike, to one decimal. A market with no strike value — moneyline, or a yes/no market — uses 0.0.

Examples:

• <fixture_id>:point_spread:home:-3.5
• <fixture_id>:draw:moneyline_3-way:yes:0.0

Pagination

Pass the next_cursor from a response back in as the next_cursor query param to fetch the next page. The last page has no next_cursor.