openapi: 3.2.0
info:
title: iSports Football Other Odds API
version: '2026-08-09'
description: 'Key-authenticated REST/HTTP data feeds for football (soccer) and basketball: livescores, schedules and results, match events, lineups, live text, statistics, standings, player and team profiles, transfers, referees, multi-language name packs, live-animation feeds, and pre-match / in-play / historical odds across 200+ bookmakers.
All operations are GET, authenticated with an `api_key` query parameter, and return the same `{code, message, data}` envelope with HTTP 200 — including on error (see `code`).
This document was derived by API Evangelist from the endpoint definitions the provider publishes at https://www.isportsapi.com/en/docs.html — iSports API does not publish an OpenAPI definition of its own.'
termsOfService: https://www.isportsapi.com/en/home/terms.html
contact:
name: iSports API
url: https://www.isportsapi.com/en/
x-derived-by: API Evangelist enrichment pipeline
x-derived-from: https://www.isportsapi.com/en/docs.html
x-derived-on: '2026-08-09'
servers:
- url: https://api.isportsapi.com
description: Primary API host
- url: https://api2.isportsapi.com
description: Alternate host, documented for when the primary host is slow or unreachable
security:
- apiKeyQuery: []
tags:
- name: Football Other Odds
paths:
/sport/football/odds/teamtoscore/prematch:
get:
operationId: getFootballOddsTeamtoscorePrematch
summary: First/Last Team To Score (pre-match)
description: '• This API endpoint returns pre-match odds for which team scores first and which team scores last in the match.
• By default, returns data for the next 10 days.
• Currently supports Macauslot (1) and Crown (3).
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=1,3).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown"
odds:
type: object
description: First/Last Team to Score odds
properties:
firstIsHome:
type: string
description: Odds for the home team to score first (Hong Kong Odds)
firstIsAway:
type: string
description: Odds for the away team to score first (Hong Kong Odds)
lastIsHome:
type: string
description: Odds for the home team to score last (Hong Kong Odds).
lastIsAway:
type: string
description: Odds for the away team to score last (Hong Kong Odds).
noGoal:
type: string
description: Odds for the match to end with no goals scored (Hong Kong Odds)
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=113
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=113
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/oddeven/prematch:
get:
operationId: getFootballOddsOddevenPrematch
summary: Goals Odd/Even (pre-match)
description: '• This API endpoint returns pre-match odds for whether the total number of goals in the match is odd or even.
• By default, returns data for matches in the next 10 days.
• Currently supports Macauslot (1) and Crown (3).
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=1,3).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown"
odds:
type: object
description: Goals Odd/Even odds
properties:
single:
type: string
description: Odds for the total number of goals to be odd (Hong Kong Odds)
double:
type: string
description: Odds for the total number of goals to be even (Hong Kong Odds)
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=114
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=114
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/totalgoals/prematch:
get:
operationId: getFootballOddsTotalgoalsPrematch
summary: Number of Goals in Match (pre-match)
description: '• This API endpoint returns the pre-match odds for the number of goals in the match.
• By default, returns data for the next 10 days.
• Odds format: All odds values are returned in Hong Kong Odds format. To convert to Decimal Odds: Decimal Odds = HK + 1 (e.g., 0.85 → 1.85).
• Currently supported by: Macauslot (1), Crown (3). Additional bookmakers may be added in the future.
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown"
odds:
type: object
description: Number of Goals in Match odds
properties:
zeroToOne:
type: string
description: Hong Kong odds for total goals in the match being 0–1
twoToThree:
type: string
description: Hong Kong odds for total goals in the match being 2–3
fourToSix:
type: string
description: Hong Kong odds for total goals in the match being 4–6
moreThanSix:
type: string
description: Hong Kong odds for total goals in the match being more than 6
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=115
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=115
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/halffull/prematch:
get:
operationId: getFootballOddsHalffullPrematch
summary: Half Time/Full Time (pre-match)
description: '• This API endpoint returns pre-match odds for Half Time/Full Time, where the result is based on the combination of the half-time result and the full-time result.
• By default, returns data for matches in the next 10 days.
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown \n 8: Bet365\n 19：Interwetten\n 24: 12bet\n 31: Sbobet"
odds:
type: object
description: Half Time/Full Time odds
properties:
halfWinFullWin:
type: string
description: Odds for home team winning at half-time and winning the match (Hong Kong Odds)
halfWinFullDraw:
type: string
description: Odds for home team winning at half-time and the match ending in a draw (Hong Kong Odds)
halfWinFullLose:
type: string
description: Odds for home team winning at half-time and losing the match (Hong Kong Odds)
halfDrawFullWin:
type: string
description: Odds for the match being drawn at half-time and home team winning the match (Hong Kong Odds)
halfDrawFullDraw:
type: string
description: Odds for the match being drawn at half-time and ending in a draw (Hong Kong Odds)
halfDrawFullLose:
type: string
description: Odds for the match being drawn at half-time and home team losing the match (Hong Kong Odds)
halfLoseFullWin:
type: string
description: Odds for home team losing at half-time and winning the match (Hong Kong Odds)
halfLoseFullDraw:
type: string
description: Odds for home team losing at half-time and the match ending in a draw (Hong Kong Odds)
halfLoseFullLose:
type: string
description: Odds for home team losing at half-time and losing the match (Hong Kong Odds)
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=116
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=116
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/score/prematch:
get:
operationId: getFootballOddsScorePrematch
summary: Correct Score (pre-match)
description: "• This API endpoint returns pre-match correct score odds for each possible scoreline.\n\n\n\n• By default, returns data for matches in the next 10 days. \n\n\n\n• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5)."
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=1,3).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown"
odds:
type: object
description: Correct score odds
properties:
bettingOddsItems:
type: array
description: List of specific scoreline odds entries
items:
type: object
properties:
homeScore:
type: integer
description: Home team's score for this scoreline (e.g., 1)
awayScore:
type: integer
description: Away team's score for this scoreline (e.g., 0)
odds:
type: string
description: Odds for this exact scoreline occurring (Hong Kong Odds)
otherScoresOdds:
type: string
description: Odds for any scoreline not listed in bettingOddsItems.
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=117
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=117
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/score/half/prematch:
get:
operationId: getFootballOddsScoreHalfPrematch
summary: Half Time Correct Score (pre-match)
description: '• This API endpoint returns pre-match correct score odds for the first half.
• By default, returns data for matches in the next 10 days.
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=1,3).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n 3: Crown"
odds:
type: object
description: Half Time Correct Score odds
properties:
bettingOddsItems:
type: array
description: List of specific first-half scoreline odds entries
items:
type: object
properties:
homeScore:
type: integer
description: Home team's first-half score for this scoreline
awayScore:
type: integer
description: Away team's first-half score for this scoreline
odds:
type: string
description: Odds for this exact first-half scoreline occurring (Hong Kong Odds)
otherScoresOdds:
type: string
description: Odds for any first-half scoreline not listed in bettingOddsItems
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=118
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=118
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/cornershandicap/prematch:
get:
operationId: getFootballOddsCornershandicapPrematch
summary: Handicap Corners (pre-match)
description: "• This API endpoint returns pre-match Asian Handicap odds for corners, where a corner handicap is applied to one team.\n\n\n\n• By default, returns data for matches in the next 10 days. \n\n\n\n• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5)."
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "1: Macauslot \n3: Crown \n 8: Bet365"
odds:
type: object
description: Handicap Corners odds
properties:
handicapCorners:
type: string
description: "Corner handicap line. \n\n Positive = home team gives corners (home team favored). \n Negative = home team receives corners (away team favored). \n Quarter lines expressed as decimals (e.g., -0.5, 2.5)."
home:
type: string
description: Odds for the home team after the corner handicap is applied (Hong Kong Odds)
away:
type: string
description: Odds for the away team after the corner handicap is applied (Hong Kong Odds)
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=119
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=119
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/cornerstotal/prematch:
get:
operationId: getFootballOddsCornerstotalPrematch
summary: Total Corners (pre-match)
description: "• This API endpoint returns pre-match over/under odds for the total number of corners in the match. Use cmd=half to retrieve first-half corner totals instead.\n\n\n\n• By default, returns data for matches in the next 10 days. \n\n\n\n• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5)."
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).
- name: cmd
in: query
required: false
schema:
type: string
description: Pass half to return first-half corner total odds instead of full-match.
responses:
'200':
description: Standard iSports envelope. `code` 0 indicates success; a non-zero `code` carries the error in `message` (HTTP status is 200 in both cases).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
description: 0 on success; 2 on invalid/illegal api_key
message:
type: string
description: '"success" on success; otherwise the error message'
data:
type: array
items:
type: object
properties:
matchId:
type: string
companyId:
type: string
description: "3: Crown \n 8: Bet365"
odds:
type: object
description: Total Corners odds
properties:
totalCorners:
type: string
description: Corner total line (e.g., 8.5, 9)
over:
type: string
description: Odds for the total corners to exceed the line (Hong Kong Odds)
under:
type: string
description: Odds for the total corners to fall below the line (Hong Kong Odds)
changeTime:
type: integer
description: Timestamp of the last odds update (Unix timestamp, GMT+0)
externalDocs:
description: iSports API documentation
url: https://www.isportsapi.com/en/docs.html?id=121
x-documentation:
- https://www.isportsapi.com/en/docs.html?id=121
x-rate-limit: This interface is limited to 10 seconds/call;
x-recommended-call-frequency: 15 seconds/call
x-plan-products:
- Odds Pro
x-doc-modified: '2026-07-06'
/sport/football/odds/oddeven/inplay:
get:
operationId: getFootballOddsOddevenInplay
summary: Goals Odd/Even (In-play)
description: '• This API endpoint returns in-play odds for whether the total number of goals in the match is odd or even.
• Currently supports Crown (3).
• Note: The odds returned by this endpoint are net odds (excluding the stake/principal). To calculate the full payout odds, add 1 to the value returned (e.g., a value of 3.5 represents a full payout odds of 4.5).'
tags:
- Football Other Odds
parameters:
- name: matchId
in: query
required: false
schema:
type: string
description: Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611).
- name: companyId
in: query
required: false
schema:
type: string
description: Filter results to specific bookmakers. Separate mul
# --- truncated at 32 KB (91 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/isports-api/refs/heads/main/openapi/isports-api-football-other-odds-api-openapi.yml