English 
Tiếng Việt 
ภาษาไทย In-play Odds
Thời gian cập nhật: 2026-07-03 15:22
Introduction
• This endpoint returns in-play (live) odds for basketball matches, covering the Handicap and Over/Under markets across Full time, Half time, and each individual quarter.
• By default, returns all odds changes recorded within the past 3 minutes. Use matchId to retrieve the full in-play odds history for a specific match, and/or companyId to filter to one or more bookmakers (e.g. companyId=3,8).
• Company ID mapping (shared across both Handicap and Over/Under markets — unlike the separate ID sets used in our pregame odds endpoints):
1: Marcauslot；2: Easybet；3: Crown；8: Bet365；9：Vcbet；10： William Hill；19：Interwetten；20：Ladbrokes；31: Sbobet ；24: 12bet; 30：China Sports Lottery; 49:BWin
• Not every record carries an odds value. Records with type=4 or type=5 indicate that a bookmaker has closed/suspended the Handicap or Over/Under market for that stage of the match — odds1/odds2/odds3 will always be 0 in this case. See the type field description below for how to interpret each record.
• This endpoint returns in-play data only. For pregame odds, see Pre-match Odds (Halftime) and Pre-match Odds (Quarter).
Related Plans
You can use this api by subscribing plans: Odds.
Request
- Path: /sport/basketball/odds/inplay
- Method: GET
- Calls: This interface is limited to 3 seconds/call;
- Recommend Calls: 15 seconds/call
- Parameters:
| Parameter | Value | Required | Description |
|---|---|---|---|
| matchId | string | false | Returns in-play odds for the specified match only. If omitted, returns odds changes for all matches within the past 3 minutes. |
| companyId | string | false | Filters results to the specified bookmaker(s). Use a comma to separate multiple IDs, e.g. companyId=3,8. If omitted, returns odds from all bookmakers. |
Response
| Parameter | Value | Description |
|---|---|---|
| recordId | string | Unique ID for this odds record. |
| matchId | string | |
| matchTime | string | Match clock at the moment this odds record was captured, formatted as Period is 1st/2nd/3rd/4th (quarter), HT (Half-time), or OT (Overtime); mm:ss is elapsed time within that period. |
| homeScore | int | Home team score at the time of this odds record. |
| awayScore | int | Away team score at the time of this odds record. |
| type | int | Market type: 1=Handicap, 2=Over/Under, 4=Handicap Closing, 5=Over/Under Closing. 4 and 5 mark that this market has been closed/suspended by the bookmaker — these records do not carry odds values (see odds1/odds2/odds3 below). Determines how to read odds1/odds2/odds3. |
| companyId | string | 1: Macauslot 2: Easybets 3: Crown 8: Bet365 9: Vcbet 10: William Hill 19: Interwetten 20: Ladbrokes 31: Sbobet 24: 12bet 30: China Sports Lottery 49: BWin |
| odds1 | string | If type=1: home team odds. If type=2: Over odds. If type=4 or 5: always 0 — the market is closed, no odds value applies. |
| odds2 | string | If type=1: the handicap line. If type=2: the total (points) line. If type=4 or 5: always 0. |
| odds3 | string | If type=1: away team odds. If type=2: Under odds. If type=4 or 5: always 0. |
| oddsType | int | Match stage this record belongs to: 6=Full time, 3=Half time, 1=Q1, 2=Q2, 4=Q3, 5=Q4. |
| changeTime | int | Unix timestamp of when this odds change occurred. |
Example Request
