PRprophetx
Mapping

Get provider ID mappings

Changed on

Map data provider IDs to ProphetX IDs, and the reverse. For entity_type=sport_event, prophetx_id is the sport event ID. For entity_type=player, prophetx_id is the player ID returned by get_players. For entity_type=competitor, prophetx_id is the competitor ID, the competitor_id on market selections, and provider_id is the OpticOdds team ID, or the OpticOdds player ID in individual sports such as tennis. For entity_type=market, prophetx_id is the market ID within the event given by event_id, and provider_id depends on the market. A main market uses the OpticOdds market_id (for example "point_spread"). A player or team prop uses "<OpticOdds player or team ID>:<OpticOdds market_id>:<ProphetX market sub type>" (for example "<player_id>:player_points:player_total_points"), because one OpticOdds market can become more than one ProphetX market. A 3-way moneyline becomes three ProphetX markets: "<home team ID>:<market_id>", "<away team ID>:<market_id>" and "draw:<market_id>" (for example "draw:moneyline_3-way"). A tennis player to win a set market becomes one market for each player: "<OpticOdds competitor ID>:player_to_win_a_set". For entity_type=strike, prophetx_strike_id is the strike_id on market selections, market_id is its market, and provider_id is "<fixture_id>:<market provider_id>:<outcome>:<points with one decimal>". The outcome is the lowercased outcome type of the strike, for example over, under, home, away, yes or no. Strikes without points, such as moneyline and yes/no strikes, use 0.0 (for example "<fixture_id>:point_spread:home:-3.5" or "<fixture_id>:draw:moneyline_3-way:yes:0.0"). Markets and strikes are returned only for events of the given provider, and only when they have a provider key. When both provider_ids and prophetx_ids (or prophetx_strike_ids) are set, a mapping must match both lists. Results are ordered by provider_id, highest first, and paged with a cursor: pass next_cursor from the response to fetch the next page. The last page has no next_cursor.

get/v4/mm/get_mappings

Request

  • Base URL
    https://cash.api.prophetx.co/partner
  • URL
    https://cash.api.prophetx.co/partner/v4/mm/get_mappings
  • Auth
    API key in header Authorization

Query parameters

provider'opticodds' required

Data provider

entity_type'sport_event' | 'player' | 'competitor' | 'market' | 'strike' required

Entity type

event_idinteger

ProphetX event ID. Required for entity_type market and strike, not allowed for other entity types

provider_idsstring

Comma separated provider IDs, at most 100 unique IDs. Duplicates are removed before the limit is checked

prophetx_idsstring

Comma separated ProphetX integer IDs, at most 100 unique IDs. Duplicates are removed before the limit is checked. Not allowed for entity_type strike

prophetx_strike_idsstring

Comma separated ProphetX strike IDs, at most 100 unique IDs. Only for entity_type strike

limitinteger

default is 20, max is 1000

next_cursorstring

next_cursor value from the previous response. Treat it as opaque

Response

OK

Example response

{
  "data": {
    "mappings": [
      {
        "provider": "opticodds"
      }
    ]
  }
}

Changes