Bettrails

Search everything on Bettrails by name: eSoccer (virtual football) players with their league, matches and ELO; eSoccer head-to-head pages ("lost vs troy"); NBA 2K virtual basketball players and head-to-heads; esports teams and players (League of Legends, Dota 2, CS2, VALORANT), champions, heroes, agents, maps, tournaments and countries. Returns the matching pages (readable with read_page). Useful when the exact name, league or game is not known (the same nickname can exist in several leagues).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Name or part of the name, e.g. \"snak\", \"caps\", \"vitality\", \"lost vs troy\", \"jarvan\"."
    },
    "league": {
      "type": "string",
      "enum": [
        "gt",
        "adriatic",
        "valhalla",
        "valkyrie",
        "ggleague",
        "esportsbattle",
        "erivals",
        "cyberlivearena",
        "volta"
      ],
      "description": "Optional league filter. gt = GTLeagues; adriatic = Adriatic League; valhalla = Valhalla League; valkyrie = Valkyrie League; ggleague = GG League; esportsbattle = EsportsBattle; erivals = eRivals; cyberlivearena = Cyber Live Arena; volta = EsportsBattle Volta."
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "de",
        "fr",
        "pt"
      ],
      "description": "Language of the bettrails.com links returned (normally the language of the conversation). Default: es."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Read any public page of bettrails.com as clean text: eSoccer players and head-to-heads, today's matches and results (/hoy, /resultados), records, rankings (/jugadores), and the esports and basketball sections: /lol, /dota, /cs2, /valorant, /basket (hubs, leagues, today, teams, players, matches with preview or result, tournaments, champions, heroes, agents, maps, countries, records). Covers these topics in text and tables; the links on each page (shown as [/path]) can be read too. Useful starting points: /hoy (eSoccer today), /lol/hoy, /dota/hoy, /cs2/hoy, /valorant/hoy, /basket/hoy, /lol/worlds, /jugadores (eSoccer ELO ranking), /records. Pages of a specific player, team, champion or tournament can be found with search. Content is statistics only (no odds, no betting).

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "maxLength": 200,
      "description": "Page path or full bettrails.com URL, e.g. \"/valorant/hoy\" or \"/basket/ggl/jugador/archer\"."
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "de",
        "fr",
        "pt"
      ],
      "description": "Language of the bettrails.com links returned (normally the language of the conversation). Default: es."
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false
}

Get a link so Bettrails notifies the user before a match starts. Kinds: esoccer_duel (league + player1 + player2: about 10 minutes before each of their next duels, with their head-to-head), basket_duel (league nba|euro|ggl + player1 + player2), esports_team (game lol|dota|cs2|valorant + team: 1 hour before each match and the result). The link opens Bettrails, where the person confirms with a free account (created in the same step if needed). Bettrails sends the notifications itself.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "esoccer_duel",
        "basket_duel",
        "esports_team"
      ]
    },
    "league": {
      "type": "string",
      "description": "esoccer_duel: eSoccer league key (gt, adriatic, valhalla, valkyrie, ggleague, esportsbattle, erivals, cyberlivearena, volta); basket_duel: nba, euro or ggl."
    },
    "player1": {
      "type": "string",
      "maxLength": 60
    },
    "player2": {
      "type": "string",
      "maxLength": 60
    },
    "game": {
      "type": "string",
      "enum": [
        "lol",
        "dota",
        "cs2",
        "valorant"
      ],
      "description": "esports_team only."
    },
    "team": {
      "type": "string",
      "maxLength": 80,
      "description": "esports_team only: team name, e.g. \"T1\" or \"Team Vitality\"."
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "de",
        "fr",
        "pt"
      ],
      "description": "Language of the bettrails.com links returned (normally the language of the conversation). Default: es."
    }
  },
  "required": [
    "kind"
  ],
  "additionalProperties": false
}

Profile of an eSoccer (virtual football, EA FC) player: ELO rating and position in the league ranking, win rate, draws, goals scored and conceded per match, goals per match compared with the league, how many matches had 3, 4 or 5+ goals, current run of matches with 3+ goals (or 2 or fewer), recent form, latest matches with clubs, most frequent opponents and next scheduled match. Answers questions like "how is X playing", "X stats", "is X in form", "how many goals does X score", "who does X play most", "when does X play next". Same window as the Bettrails page: last 6 months when there are at least 15 matches, otherwise the whole career. May include a free sample of member data (active streaks). Statistics only: no odds, no betting advice.

{
  "type": "object",
  "properties": {
    "player": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Player nickname as on Bettrails (case does not matter)."
    },
    "league": {
      "type": "string",
      "enum": [
        "gt",
        "adriatic",
        "valhalla",
        "valkyrie",
        "ggleague",
        "esportsbattle",
        "erivals",
        "cyberlivearena",
        "volta"
      ],
      "description": "League. If omitted, the league where the player has played most. gt = GTLeagues; adriatic = Adriatic League; valhalla = Valhalla League; valkyrie = Valkyrie League; ggleague = GG League; esportsbattle = EsportsBattle; erivals = eRivals; cyberlivearena = Cyber Live Arena; volta = EsportsBattle Volta."
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "de",
        "fr",
        "pt"
      ],
      "description": "Language of the bettrails.com links returned (normally the language of the conversation). Default: es."
    }
  },
  "required": [
    "player"
  ],
  "additionalProperties": false
}

Head-to-head record between two eSoccer (virtual football, EA FC) players: who wins more, draws, average goals per duel compared with their league, how many duels ended with 3, 4 or 5+ goals, how often both players scored, goals per player, most common score, current streak, the latest duels (with the clubs each one used) and their next scheduled duel. Answers questions like "who usually wins between X and Y", "X vs Y history", "cara a cara", "h2h", "how many goals in X vs Y", "do both usually score", "how did the last X vs Y end", "and in the last month?", "and when X plays with Real Madrid?". Filters: period, last_n (only the latest N duels) and clubs (club1/club2, or clubs_of_last_duel=true to keep only duels with the same clubs as their latest meeting). By default it uses the same window as the Bettrails page: the last 6 months when that leaves at least 10 duels, otherwise the full record. Statistics only: no odds, no betting advice.

{
  "type": "object",
  "properties": {
    "player1": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "First player (nickname as on Bettrails, case does not matter)."
    },
    "player2": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Second player."
    },
    "league": {
      "type": "string",
      "enum": [
        "gt",
        "adriatic",
        "valhalla",
        "valkyrie",
        "ggleague",
        "esportsbattle",
        "erivals",
        "cyberlivearena",
        "volta"
      ],
      "description": "League. If omitted, the league where they have met most is used. gt = GTLeagues; adriatic = Adriatic League; valhalla = Valhalla League; valkyrie = Valkyrie League; ggleague = GG League; esportsbattle = EsportsBattle; erivals = eRivals; cyberlivearena = Cyber Live Arena; volta = EsportsBattle Volta."
    },
    "period": {
      "type": "string",
      "enum": [
        "auto",
        "all",
        "1y",
        "6m",
        "3m",
        "1m",
        "7d"
      ],
      "description": "Time window. auto (default) = like the Bettrails page; all = full record."
    },
    "last_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Only the latest N duels (applied after the period)."
    },
    "club1": {
      "type": "string",
      "maxLength": 40,
      "description": "Only duels where player1 used this club (partial name OK, e.g. \"City\")."
    },
    "club2": {
      "type": "string",
      "maxLength": 40,
      "description": "Only duels where player2 used this club."
    },
    "clubs_of_last_duel": {
      "type": "boolean",
      "description": "Only duels with the same clubs both used in their latest meeting."
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "de",
        "fr",
        "pt"
      ],
      "description": "Language of the bettrails.com links returned (normally the language of the conversation). Default: es."
    }
  },
  "required": [
    "player1",
    "player2"
  ],
  "additionalProperties": false
}