Get bet markets

GET /bet/markets/

Operation ID: get_bet_markets

Retrieve all bet markets. Users can later use the full market names to create notifications or publish picks.

Parameters

No parameters required.

Response

Success Response (200)

Returns a BetMarket object:

{
  "markets": [
    "Fixed Win",
    "Fixed Place", 
    "Top Fluc",
    "Tote Win",
    "Tote Place",
    "Best Tote Win",
    "Best Tote Place",
    "Mid Tote Win",
    "Mid Tote Place",
    "Best of Best",
    "Same Race Multi",
    "Betfair SP",
    "Lay Win",
    "Lay Place"
  ],
  "codes": [
    "FWIN",
    "FPLC", 
    "TF",
    "TWIN",
    "TPLC",
    "BT3SP",
    "BTP",
    "MT",
    "MTP",
    "BOB",
    "SRM",
    "BSP",
    "LWIN",
    "LPLC"
  ],
  "sports_markets": [
    {
      "sport": "AFL",
      "markets": [
        "Head to Head",
        "Margin",
        "Handicap",
        "Total Match Points",
        "Home Team Total Points (Over/Under)",
        "Away Team Total Points (Over/Under)"
      ]
    },
    {
      "sport": "NBA", 
      "markets": [
        "Head to Head",
        "Margin",
        "Handicap",
        "Total Match Points",
        "Player Points (Over/Under)",
        "Player Assists (Over/Under)",
        "Player Rebounds (Over/Under)"
      ]
    }
  ]
}

Response Fields

Field	Type	Description
markets	array[string]	Full names of available bet markets for racing
codes	array[string]	Short codes for bet markets used to check available markets for bookies
sports_markets	array[SportsMarket]	Sports markets with their available betting options

Usage

curl -X GET "https://betmatic.app/api/bet/markets/" \
  -H "Authorization: Token your_token"

Potential Use Cases

1. Bet Creation: Use market names when creating notifications or publishing picks

2. Market Validation: Validate market selections before submitting bets

3. Bot Configuration: Configure automated betting strategies for specific markets

Authentication

This endpoint requires authentication. Include your token in the Authorization header:

Authorization: Token your_token