Browse the event board
find_matchesReturns the in-play or not-yet-started fixtures of a single sport, one short row per match, each with its full-game moneyline attached. This is where event_id values for match_prices come from. To shrink the board, give query a few whitespace-separated terms; a match is kept only when every term occurs in its league, home or away name, ignoring case (for instance 'serie a juventus'). At most limit rows come back and a closing note states how many were left out. Each call is billed as one request on the key's plan, so hold on to ids you have already fetched instead of listing the board again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sport": "<sport>"
},
"name": "find_matches"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | 'live' for matches in progress, 'prematch' for fixtures that have not started | live |
| limit | No | Maximum number of rows to return | |
| query | No | Search terms; a match is returned only if every term is found in its league, home or away name | |
| sport | Yes | Numeric sport id from board_sports, or a name/alias such as 3, 'tennis' or 'NHL' | |
| response_format | No | 'detailed' also returns the main handicap and total line, plus has_odds | concise |