Skip to content
Kero Docs

Market message examples

Market messages that you receive from Kero will contain all the required variables and data for you to create a rich and potentially multilingual market flow. As you will see in the examples below, Market messages contain a wide range of information such as the event the market belongs to, the type of market it is, the betting options, their odds, market state and the variables.

It is very important to understand what variables are. They are the bits of information for each market that actually change. For example a market that asks “Which team will have the first shot after minute 17:00” will have the variable start_resolve_cl =17:00.

Kero will not send you the static market title in these messages, rather only the necessary variables. The market titles and all of the static market information is available in the Market & Translations Catalogue. Translations and other static info is available in multiple languages and will make your integration process quite smooth. The only thing you have to do is match the market template and the market message by the “key_market” value.

{
  "type": "MARKET",
  "sub_type": "TEMPLATE",
  "object": {
    "id": "9b92c52b-8fed-4571-b8eb-3b62cfaff7f4",
    "event_id": "2ba77318-6e3d-4568-a961-ceb18315ae08",
    "event": {
      "alternate_game_ids": {
        "betradar": "50410491",
        "opta": "aszgh1n3g7mb04hsliqyg14pg"
      }
    },
    "market_state": "PUBLISHED",
    "answers_odds": {
      "answer_a": {
        "is_restricted": false,
        "prob": 0.78,
        "odds": {
          "american": "-454",
          "european": "1.22",
          "fractional": "11/50"
        }
      },
      "answer_b": {
        "is_restricted": false,
        "prob": 0.22,
        "odds": {
          "american": "+285",
          "european": "3.85",
          "fractional": "57/20"
        }
      }
    },
    "game_id": "aszgh1n3g7mb04hsliqyg14pg",
    "key_market": "SOCCER_A_6_84",
    "is_core": false,
    "title_variable": "{\"team_name\": \"ATL\", \"player_name\": \"Gregore\", \"end_resolve_cl\": \"5:59\", \"start_resolve_cl\": \"3:00\"}",
    "context_note_variable": "{\"team\": \"ATL\", \"target_value\": \"12.3\"}",
    "constraint_variable": "",
    "context_note_variable_type": "",
    "title_variable_type": "",
    "constraint_variable_type": "",
    "variables_entities": {
      "team_name": {
        "type": "TEAM",
        "id": 1,
        "side": "HOME",
        "short_name": "ATL"
      },
      "team": {
        "type": "TEAM",
        "id": 1,
        "side": "HOME",
        "short_name": "ATL"
      },
      "player_name": {
        "type": "PLAYER",
        "id": 2,
        "short_name": "Gregore"
      }
    },
    "answers_restricted": {
        "answer_a": false,
        "answer_b": false
    }
  },
  "action": "PUBLISH",
  "timestamp": 1732996919951
}