{
  "opencollection": "1.0.0",
  "info": {
    "name": "iSports Football Odds (18 Agencies) Football Odds (18 Agencies) API",
    "version": "2026-08-09"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "api_key",
      "value": "{{api_key}}",
      "placement": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "Football Odds (18 Agencies)",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Pre-match and In-play Odds (Main)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/main",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns pre-match and in-play odds for major markets, including Asian Handicap, 1X2, and over/under — with both full-match and first-half breakdowns.\n\n\n\n• Returns matches with odds available for the next 14 days, covering both pre-match and in-play. Use it alongside the Live Odds Changes (Main) endpoint for real-time updates, and Schedule & Results or Match Modify Record to get basic match information.\n\n\n\n• Handicap and over/under line format: Lines are multiples of 0.25. \n\n0"
        },
        {
          "info": {
            "name": "Live Odds Changes (Main)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/main/changes",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns real-time odds changes for major market types (Handicap, Europe Odds, and Over/Under) that occurred within the last 20 seconds.\n\n\n\n• Data is delivered incrementally in a high-efficiency format, using comma-separated strings within arrays to represent various odds parameters and flags.\n\n\n\n• Use it alongside the Pre-match and In-play Odds (Main) endpoint to synchronize and maintain a real-time local odds database."
        },
        {
          "info": {
            "name": "Historical Odds (Main)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/main/history",
            "params": [
              {
                "name": "date",
                "value": "",
                "type": "query",
                "description": "Filter results by date (GMT+0 00:00–23:59). Supports back-checking within the past month. Format: yyyy-MM-dd (e.g., date=2026-06-18). \n\n\n\nIf omitted, returns data for the current day."
              },
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns historical opening and closing odds for major football betting markets.It defaults to records from GMT+0 0:00 today, while supporting a date parameter for historical back-checking up to one month.\n\n\n\n• Handicap and over/under line format: Lines are multiples of 0.25. \n\n0 = 0 goals, 0.25 = 0/0.5, 0.5 = 0.5, 0.75 = 0.5/1, 1 = 1 goal, and so on. A positive value means the home team gives goals; a negative value means the away team gives goals.\n\n\n\n• Odds format: All odds "
        },
        {
          "info": {
            "name": "Future Odds (Main)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/main/future",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns pre-match odds for all matches starting more than 10 days from now, covering Asian Handicap (handicap), 1X2 (europeOdds), over/under (overUnder), and their first-half equivalents (handicapHalf, overUnderHalf).\n\n\n\n• Handicap and over/under line format: Lines are multiples of 0.25. \n\n0 = 0 goals, 0.25 = 0/0.5, 0.5 = 0.5, 0.75 = 0.5/1, 1 = 1 goal, and so on. A positive value means the home team gives goals; a negative value means the away team gives goals.\n\n\n\n• The compa"
        },
        {
          "info": {
            "name": "Historical Odds (All)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/all/history",
            "params": [
              {
                "name": "date",
                "value": "",
                "type": "query",
                "description": "Filter results by date (GMT+0 00:00–23:59). Supports back-checking within the past month. Format: yyyy-MM-dd (e.g., date=2026-06-18). \n\n\n\nIf omitted, returns data for the current day."
              },
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns the historical initial and final odds across all available handicap and goal lines for finished matches, covering Asian Handicap (handicap), 1X2 (europeOdds), over/under (overUnder), and their first-half equivalents (handicapHalf, overUnderHalf).\n\n\n\n• The content is consistent with the Historical Odds (Main) endpoint — the entry where handicapIndex = 1 represents the main market line.\n\n\n\n• By default, returns all finished matches from GMT+0 00:00 to the present.\n\n\n\n• "
        },
        {
          "info": {
            "name": "European Odds (Halftime)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/european/half",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns half-time 1X2 odds, including pre-match and in-play odds.\n\n\n\n• By using endpoints <a href=\"/docs.html?id=41\" style=\"color:blue\">Schedule & Results (Basic)\n</a> and <a href=\"/docs.html?id=33\" style=\"color:blue\">Match Modify Record</a>, you can get basic information of matches.\n\n\n\n• The company ID corresponds to the company:\n\n1: Macauslot, 3: Crown, 4: Ladbrokes, 8: Bet365, 9: William Hill, 12: Easybets, 14: Vcbet, 17: Mansion88, 19: Interwetten, 22: 10BET, 24: 12bet, 3"
        },
        {
          "info": {
            "name": "Pre-match and In-play Odds (All)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/all",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns pre-match and in-play odds for multiple market lines (alternative lines), including Asian Handicap, 1X2, and over/under — with both full-match and first-half breakdowns.\n\n\n\n• The content is consistent with the Pre-match and In-play Odds (Main) endpoint — the entry where handicapIndex = 1 represents the main market line.\n\n\n\n• It covers upcoming matches scheduled within the next 14 days (where odds are available) and ongoing matches, including both pre-match and in-play"
        },
        {
          "info": {
            "name": "Live Odds Changes (All)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/all/changes",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns all odds that changed in the past 20 seconds. \n\n\n\n• You can use it with the <a href=\"/docs.html?id=71\" style=\"color:blue\">Pre-match and In-play Odds (All)</a> endpoint— call that endpoint once to get the full odds list, then poll this endpoint every 2 seconds to receive incremental updates."
        },
        {
          "info": {
            "name": "In-play Odds",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/inplay",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request. \n\n\n\nOnly supports querying matches within the past 20 days."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns in-play odds for the main market, covering Asian Handicap (handicap), 1X2 (europeOdds), and over/under (overUnder).\n\n\n\n• By default, returns in-play odds updated in the past 3 minutes for all matches.\n\n\n\n• The company ID corresponds to the company:\n\n1: Macauslot, 3: Crown, 4: Ladbrokes ,8: Bet365, 12: Easybets, 14: Vcbet, 17: Mansion88, 19: Interwetten, 22: 10BET, 24: 12bet, 31: Sbobet, 35: Wewbet, 42: 18bet, 48: HK Jockey Club, 49:BWin, 50:1xbet\n\n\n\n\n• By using endpoi"
        },
        {
          "info": {
            "name": "Future Odds (All)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/all/future",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns pre-match odds across all available handicap and goal lines for matches starting more than 10 days from now, covering Asian Handicap (handicap), 1X2 (europeOdds), over/under (overUnder), and their first-half equivalents (handicapHalf, overUnderHalf).\n\n\n\n• Handicap and over/under line format: Lines are multiples of 0.25. \n\n0 = 0 goals, 0.25 = 0/0.5, 0.5 = 0.5, 0.75 = 0.5/1, 1 = 1 goal, and so on. A positive value means the home team gives goals; a negative value means "
        },
        {
          "info": {
            "name": "In-play Odds (Halftime)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/inplay/half",
            "params": [
              {
                "name": "matchId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific matches. Separate multiple IDs with \",\" (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request. \n\n\n\nOnly supports querying matches within the past 20 days."
              },
              {
                "name": "companyId",
                "value": "",
                "type": "query",
                "description": "Filter results to specific bookmakers. Separate multiple IDs with \",\" (e.g., companyId=3,8)."
              }
            ]
          },
          "docs": "• This API endpoint returns half-time in-play odds for the main market, covering Asian Handicap (handicapHalf), 1X2 (europeOddHalf), and over/under (overUnderHalf).\n\n\n\n• By default, returns in-play odds updated in the past 3 minutes for all matches.\n\n\n\n• The company ID corresponds to the company:\n\n1: Macauslot, 3: Crown, 4: Ladbrokes ,8: Bet365, 12: Easybets, 14: Vcbet, 17: Mansion88, 19: Interwetten, 22: 10BET, 24: 12bet, 31: Sbobet, 35: Wewbet, 42: 18bet, 48: HK Jockey Club, 49:BWin, 50:1xbet"
        },
        {
          "info": {
            "name": "Odd Modify Record",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.isportsapi.com/sport/football/odds/oddsbyid",
            "params": [
              {
                "name": "type",
                "value": "",
                "type": "query",
                "description": "Returns a list of matches with historical odds that may have changed in the last hour."
              },
              {
                "name": "matchId + companyId",
                "value": "",
                "type": "query",
                "description": "Returns historical odds for the specified match and bookmaker (main market only)."
              }
            ]
          },
          "docs": "• This API endpoint returns historical odds for matches whose odds changed within a specific time window, supporting three query modes:\n\n\n 1.type=match — Returns a list of matches with historical odds that may have increased or decreased in the last hour, along with the bookmaker that changed and the operation time.\n\n\n\n 2.matchId + companyId — Returns historical odds for a specific match and bookmaker, main market only (e.g., /sport/football/odds/oddsbyid?api_key&matchId=256921227&companyId=3).\n"
        }
      ]
    }
  ],
  "bundled": true
}