EQULS API - Get Bet Types Endpoint

Overview

This endpoint retrieves a list of all valid bet types supported by the EQULS API, optionally filtered by sport.

Details

• URL: /v1/getBetTypes
• Method: GET
• Authentication: Required (API Key)

Request Parameters

• apiKey: A required query parameter. It must be a valid 24-character hexadecimal API key for authentication.
• sport: An optional query parameter to filter bet types by a specific sport.

Response

• Success (200 OK):

  • Returns a JSON object containing an array of supported bet types.
  • Example (all bet types):
    JSON

    {
      "betTypes": ["moneyline", "spread", "total", "player prop", "team prop", ...]
    }

  • Example (filtered by sport):
    JSON

    {
      "betTypes": ["moneyline", "spread", "total", "player prop"]
    }

• Error (400 Bad Request):

  • Returned when an invalid sport parameter is provided.
  • Example:
    JSON

    {
      "error": "Invalid sport",
      "validSports": ["basketball", "football", "baseball", "hockey", "soccer"]
    }

• Error (401 Unauthorized):

  • Returned when the API key is missing or invalid.
  • Example:
    JSON

    {
      "error": "Invalid API key",
      "details": [
        {
          "code": "invalid_string",
          "message": "Must be a valid ObjectID string",
          "path": ["apiKey"]
        }
      ]
    }

Notes

• The API key must be a valid 24-character hexadecimal string in the MongoDB ObjectID format.
• When no sport parameter is provided, all bet types are returned.
• When a sport parameter is provided, only bet types available for that specific sport are returned.
• The bet types list is maintained in the configuration and may be updated as new bet types are added to the platform.