{"openapi":"3.0.0","info":{"title":"Tirbet API","description":"High-performance Tirbet aggregation and market mapping API","version":"1.0.0","contact":{"name":"Rashedul","email":"rashedulbcc@gmail.com","url":"https://fb.me/mdrashedulislam11"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"tags":[{"name":"Sports","description":"Provides access to sports data, including sports listings and hierarchical navigation through leagues and games. These endpoints support browsing by match status and retrieving detailed event information."}],"security":[{"ClientApiKey":[]}],"components":{"securitySchemes":{"ClientApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Client API key used to access public API"}},"schemas":{},"parameters":{}},"paths":{"/sports/find_main_live_by_upcoming_id/{id}":{"get":{"tags":["Sport Meta"],"summary":"Find main live event by upcoming ID","description":"Retrieves the main live event associated with a specific upcoming event ID.This endpoint is typically called after the event start time to find the corresponding live event.","operationId":"findMainLiveByUpcomingId","parameters":[{"schema":{"type":"string","pattern":"^\\d+$","example":"12345"},"required":true,"name":"id","in":"path","description":"Upcoming event ID (numeric)"}],"responses":{"200":{"description":"List of events for a sport","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"object","properties":{"sportId":{"type":"integer"},"leagueId":{"type":"integer"},"id":{"type":"integer"},"mainId":{"type":"integer"}},"required":["sportId","leagueId","id","mainId"]}},"required":["success","requestId","data"]}}}},"404":{"description":"Upcoming event not found or no live event available yet","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false],"example":false},"error":{"type":"string","example":"NOT_FOUND"},"message":{"type":"string","example":"Resource not found"}},"required":["success","error","message"]}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/recommendations/{status}":{"get":{"tags":["Sport Meta"],"operationId":"getRecommendationGame","summary":"Get recommendation games","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"responses":{"200":{"description":"List of recommendation games","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","nullable":true,"example":987654,"description":"Match identifier"},"ci":{"type":"number","nullable":true,"example":4353456,"description":"Category identifier"},"team":{"type":"object","properties":{"home":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Home team","example":{"id":12345,"name":"Manchester United","slug":"manchester-united","countryId":44,"logo":"https://cdn.example.com/teams/manchester-united.png"}},"away":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Away team","example":{"id":67890,"name":"Liverpool","slug":"liverpool","countryId":44,"logo":"https://cdn.example.com/teams/liverpool.png"}}},"required":["home","away"],"description":"Match teams (home vs away)"},"league":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"}},"required":["id","name","slug"],"description":"League information","example":{"id":1,"name":"Premier League","slug":"premier-league"}},"country":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"}},"required":["id","name"],"description":"Country information","example":{"id":44,"name":"England"}},"status":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Match status"},"startTime":{"type":"integer","example":1768651200,"description":"Unix timestamp (UTC)"},"ec":{"type":"integer","example":134,"description":"event count"},"sport":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"}},"required":["id","name","slug"]},"gameTypeId":{"type":"number"},"period":{"type":"number"},"periodName":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":6,"description":"Market id"},"name":{"type":"string","example":"Total Goals","description":"Localized market name"},"gs":{"type":"number","example":1,"description":"Market game status"},"outcomes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":83,"description":"Outcome id"},"name":{"type":"string","example":"(2.5) Over","description":"Localized outcome name"},"coefficient":{"type":"number","example":1.9,"description":"Odds coefficient"},"suspended":{"type":"boolean","example":false,"description":"Outcome suspended status"},"point":{"type":"number","example":2.5,"description":"Handicap / line value"},"pl":{"type":"object","properties":{"I":{"type":"number","example":1,"description":"Player/participant id"},"N":{"type":"string","example":"Player Name","description":"Player/participant name"}},"required":["I","N"],"description":"Player/participant info (if applicable)"}},"required":["id","name","coefficient"]}},"description":"Grouped outcomes (2D array)","example":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}},"required":["id","name","gs","outcomes"]},"description":"Transformed GE markets","example":[{"id":6,"name":"Total Goals","gs":1,"outcomes":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]}},"marketType":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"count":{"type":"number"},"key":{"type":"string"}},"required":["id","name","count","key"]}},"matchInfo":{"type":"object","properties":{"location":{"type":"string","example":"Old Trafford, Manchester","description":"Match venue or location"},"stage":{"type":"string","example":"Semi Final","description":"Tournament stage"},"format":{"type":"string","example":"Regular Time","description":"Match format"}},"description":"Additional match metadata from provider"},"scoreContext":{"type":"object","properties":{"currentPeriod":{"type":"number","example":2,"description":"Current period number"},"stageLiveStatus":{"type":"string","example":"LIVE","description":"Stage live status"},"currentPeriodString":{"type":"string","example":"2nd Half","description":"Current period string"},"fullScore":{"type":"object","properties":{"home":{"type":"number","example":2,"description":"Home team full score"},"away":{"type":"number","example":2,"description":"Home team full score"}},"description":"Full score"},"info":{"type":"string","example":"Match in progress","description":"Additional live match information"},"currentPlay":{"type":"number","example":1,"description":"Current play (example cricket)"},"periodScores":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Period key"},"Value":{"type":"object","properties":{"NF":{"type":"string","example":"HT","description":"Normalized period label"},"S1":{"type":"number","example":1,"description":"Home score for this period"},"S2":{"type":"number","example":0,"description":"Away score for this period"}},"required":["NF"]}},"required":["Key","Value"]},"description":"Scores per period","example":[{"Key":1,"Value":{"NF":"1st Half","S1":1,"S2":0}}]},"setScore":{"type":"object","properties":{"S1":{"type":"string"},"S2":{"type":"string"}},"required":["S1","S2"]},"timeoutRemaining":{"type":"number","example":60,"description":"Timeout remaining (seconds)"},"timeSeconds":{"type":"number","example":3420,"description":"Match time elapsed in seconds"},"matchStatistics":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Statistics group key"},"Value":{"type":"array","items":{"type":"object","properties":{"ID":{"type":"number","example":101,"description":"Statistic identifier"},"N":{"type":"string","example":"Possession","description":"Statistic name"},"S1":{"type":"string","example":"55%","description":"Home team value"},"S2":{"type":"string","example":"45%","description":"Away team value"}},"required":["ID","N","S1","S2"]}}},"required":["Key","Value"]},"description":"Match statistics"},"inningsData":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"string","example":"Team1Scores"},"Value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","additionalProperties":{"nullable":true}}],"example":"75/4"}},"required":["Key","Value"]}}},"description":"Live scoring context; present only when match is live"},"weather":{"type":"object","properties":{"temperature":{"type":"string","example":"+7°C","description":"Air temperature"},"cloudLevel":{"type":"string","example":"69","description":"Cloud coverage percentage"},"cloudDescription":{"type":"string","example":"Cloudy, rain","description":"Cloud / weather condition description"},"uvIndex":{"type":"string","example":"3","description":"UV index level"},"windSpeed":{"type":"string","example":"1.7","description":"Wind speed"},"windDirection":{"type":"string","example":"S","description":"Wind direction"},"windUnit":{"type":"string","example":"m/s","description":"Wind speed unit"},"pressure":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Atmospheric pressure"},"humidity":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Humidity information"},"precipitation":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Precipitation probability"}}},"probability":{"type":"object","properties":{"home":{"type":"number","example":0.44,"description":"Probability of home team winning (percentage)"},"draw":{"type":"number","example":0.26,"description":"Probability of a draw (percentage)"},"away":{"type":"number","example":0.5,"description":"Probability of away team winning (percentage)"}}},"slug":{"type":"string","example":"manchester-united-vs-liverpool","description":"SEO-friendly match slug"}},"required":["id","team","league","status","startTime","ec","sport","periodName","slug"]}}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/top/{status}":{"get":{"tags":["Sport Meta"],"operationId":"getTopGame","summary":"Get top games","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"responses":{"200":{"description":"List of top games","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","nullable":true,"example":987654,"description":"Match identifier"},"ci":{"type":"number","nullable":true,"example":4353456,"description":"Category identifier"},"team":{"type":"object","properties":{"home":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Home team","example":{"id":12345,"name":"Manchester United","slug":"manchester-united","countryId":44,"logo":"https://cdn.example.com/teams/manchester-united.png"}},"away":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Away team","example":{"id":67890,"name":"Liverpool","slug":"liverpool","countryId":44,"logo":"https://cdn.example.com/teams/liverpool.png"}}},"required":["home","away"],"description":"Match teams (home vs away)"},"league":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"}},"required":["id","name","slug"],"description":"League information","example":{"id":1,"name":"Premier League","slug":"premier-league"}},"country":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"}},"required":["id","name"],"description":"Country information","example":{"id":44,"name":"England"}},"status":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Match status"},"startTime":{"type":"integer","example":1768651200,"description":"Unix timestamp (UTC)"},"ec":{"type":"integer","example":134,"description":"event count"},"sport":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"}},"required":["id","name","slug"]},"gameTypeId":{"type":"number"},"period":{"type":"number"},"periodName":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":6,"description":"Market id"},"name":{"type":"string","example":"Total Goals","description":"Localized market name"},"gs":{"type":"number","example":1,"description":"Market game status"},"outcomes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":83,"description":"Outcome id"},"name":{"type":"string","example":"(2.5) Over","description":"Localized outcome name"},"coefficient":{"type":"number","example":1.9,"description":"Odds coefficient"},"suspended":{"type":"boolean","example":false,"description":"Outcome suspended status"},"point":{"type":"number","example":2.5,"description":"Handicap / line value"},"pl":{"type":"object","properties":{"I":{"type":"number","example":1,"description":"Player/participant id"},"N":{"type":"string","example":"Player Name","description":"Player/participant name"}},"required":["I","N"],"description":"Player/participant info (if applicable)"}},"required":["id","name","coefficient"]}},"description":"Grouped outcomes (2D array)","example":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}},"required":["id","name","gs","outcomes"]},"description":"Transformed GE markets","example":[{"id":6,"name":"Total Goals","gs":1,"outcomes":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]}},"marketType":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"count":{"type":"number"},"key":{"type":"string"}},"required":["id","name","count","key"]}},"matchInfo":{"type":"object","properties":{"location":{"type":"string","example":"Old Trafford, Manchester","description":"Match venue or location"},"stage":{"type":"string","example":"Semi Final","description":"Tournament stage"},"format":{"type":"string","example":"Regular Time","description":"Match format"}},"description":"Additional match metadata from provider"},"scoreContext":{"type":"object","properties":{"currentPeriod":{"type":"number","example":2,"description":"Current period number"},"stageLiveStatus":{"type":"string","example":"LIVE","description":"Stage live status"},"currentPeriodString":{"type":"string","example":"2nd Half","description":"Current period string"},"fullScore":{"type":"object","properties":{"home":{"type":"number","example":2,"description":"Home team full score"},"away":{"type":"number","example":2,"description":"Home team full score"}},"description":"Full score"},"info":{"type":"string","example":"Match in progress","description":"Additional live match information"},"currentPlay":{"type":"number","example":1,"description":"Current play (example cricket)"},"periodScores":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Period key"},"Value":{"type":"object","properties":{"NF":{"type":"string","example":"HT","description":"Normalized period label"},"S1":{"type":"number","example":1,"description":"Home score for this period"},"S2":{"type":"number","example":0,"description":"Away score for this period"}},"required":["NF"]}},"required":["Key","Value"]},"description":"Scores per period","example":[{"Key":1,"Value":{"NF":"1st Half","S1":1,"S2":0}}]},"setScore":{"type":"object","properties":{"S1":{"type":"string"},"S2":{"type":"string"}},"required":["S1","S2"]},"timeoutRemaining":{"type":"number","example":60,"description":"Timeout remaining (seconds)"},"timeSeconds":{"type":"number","example":3420,"description":"Match time elapsed in seconds"},"matchStatistics":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Statistics group key"},"Value":{"type":"array","items":{"type":"object","properties":{"ID":{"type":"number","example":101,"description":"Statistic identifier"},"N":{"type":"string","example":"Possession","description":"Statistic name"},"S1":{"type":"string","example":"55%","description":"Home team value"},"S2":{"type":"string","example":"45%","description":"Away team value"}},"required":["ID","N","S1","S2"]}}},"required":["Key","Value"]},"description":"Match statistics"},"inningsData":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"string","example":"Team1Scores"},"Value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","additionalProperties":{"nullable":true}}],"example":"75/4"}},"required":["Key","Value"]}}},"description":"Live scoring context; present only when match is live"},"weather":{"type":"object","properties":{"temperature":{"type":"string","example":"+7°C","description":"Air temperature"},"cloudLevel":{"type":"string","example":"69","description":"Cloud coverage percentage"},"cloudDescription":{"type":"string","example":"Cloudy, rain","description":"Cloud / weather condition description"},"uvIndex":{"type":"string","example":"3","description":"UV index level"},"windSpeed":{"type":"string","example":"1.7","description":"Wind speed"},"windDirection":{"type":"string","example":"S","description":"Wind direction"},"windUnit":{"type":"string","example":"m/s","description":"Wind speed unit"},"pressure":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Atmospheric pressure"},"humidity":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Humidity information"},"precipitation":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Precipitation probability"}}},"probability":{"type":"object","properties":{"home":{"type":"number","example":0.44,"description":"Probability of home team winning (percentage)"},"draw":{"type":"number","example":0.26,"description":"Probability of a draw (percentage)"},"away":{"type":"number","example":0.5,"description":"Probability of away team winning (percentage)"}}},"slug":{"type":"string","example":"manchester-united-vs-liverpool","description":"SEO-friendly match slug"}},"required":["id","team","league","status","startTime","ec","sport","periodName","slug"]}}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/coupon":{"post":{"tags":["Sport Meta"],"operationId":"sportCoupon","parameters":[{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"Events":{"type":"array","items":{"type":"object","properties":{"GameId":{"type":"number","example":668362977},"Type":{"type":"number","example":1},"Coef":{"type":"number","example":1.23},"Param":{"type":"number","example":0},"PV":{"type":"number","nullable":true,"example":null},"PlayerId":{"type":"number","example":0},"Kind":{"type":"number","example":1},"InstrumentId":{"type":"number","example":0},"Seconds":{"type":"number","example":0},"Price":{"type":"number","example":0},"Expired":{"type":"number","example":0},"PlayersDuel":{"type":"array","items":{"nullable":true},"default":[],"example":[]}},"required":["GameId","Type","Coef","Param","PV","PlayerId","Kind","InstrumentId","Seconds","Price","Expired"]}}},"required":["Events"],"example":{"Events":[{"GameId":668362977,"Type":1,"Coef":1.23,"Param":0,"PV":null,"PlayerId":0,"Kind":1,"InstrumentId":0,"Seconds":0,"Price":0,"Expired":0,"PlayersDuel":[]}]}}}}},"responses":{"200":{"description":"List of bet sport coupon","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"object","properties":{"coefficient":{"type":"number","example":1.23,"description":"Decimal odds for the selected outcome. Represents the total return multiplier including the original stake."},"antiExpressCoefficient":{"type":"number","example":0.23,"description":"Risk-adjusted or partial payout coefficient used for anti-express, cashout, or protected bet calculations. Typically used internally for reduced-risk payout scenarios."},"minBet":{"type":"number","example":0.3,"description":"Minimum allowed stake amount for this coupon or selection."},"maxBet":{"type":"number","example":500,"description":"Maximum allowed stake amount for this coupon or selection."},"items":{"type":"array","items":{"type":"object","properties":{"sportId":{"type":"number"},"leagueId":{"type":"number"},"gameId":{"type":"number","example":668362977,"description":"Unique identifier of the game/event instance in the provider system."},"gameConstId":{"type":"number","example":0,"description":"Constant game template identifier shared across identical fixtures. Used for mapping recurring or mirrored events across systems."},"outcomeId":{"type":"number","example":1,"description":"Unique identifier of the selected market outcome (e.g., Home Win, Over 2.5, Handicap -1)."},"gameTypeId":{"type":"number"},"param":{"type":"number","example":0,"description":"Market parameter value associated with the outcome (e.g., handicap line, total line, or special market value)."},"coefficient":{"type":"number","example":1.23,"description":"Decimal odds for the selected outcome. Represents total return multiplier including the original stake."},"suspended":{"type":"boolean","example":true,"description":"Indicates whether betting on this outcome is temporarily suspended (e.g., due to game events or risk control)."},"finish":{"type":"boolean","example":true,"description":"Indicates whether the game or market has finished and no further updates or betting actions are expected."},"gameStatus":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Current lifecycle status of the game. 'live' means in-play, 'upcoming' means pre-match."},"isRelation":{"type":"number","example":0,"description":"Flag indicating whether this outcome or market is linked or dependent on another market or selection (provider-specific relation logic)."},"FS1":{"type":"number","nullable":true},"FS2":{"type":"number","nullable":true},"MS1":{"type":"number","nullable":true},"MS2":{"type":"number","nullable":true},"period":{"type":"number"},"periodName":{"type":"string"},"startTime":{"type":"number"},"timeSec":{"type":"number","example":0,"description":"Elapsed or remaining game time in seconds, depending on provider time model."},"timeDirection":{"type":"number","example":0,"description":"Time flow direction indicator. Typically 0 = counting up (elapsed time), 1 = counting down (remaining time). Provider-specific."}},"required":["gameId","gameConstId","outcomeId","param","coefficient","suspended","finish","gameStatus","isRelation","FS1","FS2","MS1","MS2","periodName","timeSec","timeDirection"]}}},"required":["coefficient","antiExpressCoefficient","minBet","maxBet","items"]}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/{status}":{"get":{"tags":["Sports"],"operationId":"listSports","summary":"Get sport list","description":"Returns a list of available sports filtered by match status. Each sport includes associated metadata and is scoped to the provided status, such as live or upcoming events.","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"responses":{"200":{"description":"Sports list","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"},"gc":{"type":"number","example":38,"description":"Total number of games in the league season"},"lc":{"type":"number","example":120,"description":"Total number of leagues available for this sport"},"countries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"},"leagues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"},"gc":{"type":"number","example":38,"description":"Total number of games in the league season"}},"required":["id","name","slug","gc"]}}},"required":["id","name","leagues"]}}},"required":["id","name","slug","gc","lc","countries"]}}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/{status}/{sport}":{"get":{"tags":["Sports"],"operationId":"getGameList","summary":"Get game list","description":"Returns a list of games for the specified sport and status. The response includes all available events associated with the given sport slug, filtered by match status such as live or upcoming.","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$","example":"football","description":"Unique identifier for the sport (e.g., 'football', 'cricket')"},"required":true,"description":"Unique identifier for the sport (e.g., 'football', 'cricket')","name":"sport","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"responses":{"200":{"description":"List of events for a sport","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","nullable":true,"example":987654,"description":"Match identifier"},"ci":{"type":"number","nullable":true,"example":4353456,"description":"Category identifier"},"team":{"type":"object","properties":{"home":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Home team","example":{"id":12345,"name":"Manchester United","slug":"manchester-united","countryId":44,"logo":"https://cdn.example.com/teams/manchester-united.png"}},"away":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Away team","example":{"id":67890,"name":"Liverpool","slug":"liverpool","countryId":44,"logo":"https://cdn.example.com/teams/liverpool.png"}}},"required":["home","away"],"description":"Match teams (home vs away)"},"league":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"}},"required":["id","name","slug"],"description":"League information","example":{"id":1,"name":"Premier League","slug":"premier-league"}},"country":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"}},"required":["id","name"],"description":"Country information","example":{"id":44,"name":"England"}},"status":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Match status"},"startTime":{"type":"integer","example":1768651200,"description":"Unix timestamp (UTC)"},"ec":{"type":"integer","example":134,"description":"event count"},"sport":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"}},"required":["id","name","slug"]},"gameTypeId":{"type":"number"},"period":{"type":"number"},"periodName":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":6,"description":"Market id"},"name":{"type":"string","example":"Total Goals","description":"Localized market name"},"gs":{"type":"number","example":1,"description":"Market game status"},"outcomes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":83,"description":"Outcome id"},"name":{"type":"string","example":"(2.5) Over","description":"Localized outcome name"},"coefficient":{"type":"number","example":1.9,"description":"Odds coefficient"},"suspended":{"type":"boolean","example":false,"description":"Outcome suspended status"},"point":{"type":"number","example":2.5,"description":"Handicap / line value"},"pl":{"type":"object","properties":{"I":{"type":"number","example":1,"description":"Player/participant id"},"N":{"type":"string","example":"Player Name","description":"Player/participant name"}},"required":["I","N"],"description":"Player/participant info (if applicable)"}},"required":["id","name","coefficient"]}},"description":"Grouped outcomes (2D array)","example":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}},"required":["id","name","gs","outcomes"]},"description":"Transformed GE markets","example":[{"id":6,"name":"Total Goals","gs":1,"outcomes":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]}},"marketType":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"count":{"type":"number"},"key":{"type":"string"}},"required":["id","name","count","key"]}},"matchInfo":{"type":"object","properties":{"location":{"type":"string","example":"Old Trafford, Manchester","description":"Match venue or location"},"stage":{"type":"string","example":"Semi Final","description":"Tournament stage"},"format":{"type":"string","example":"Regular Time","description":"Match format"}},"description":"Additional match metadata from provider"},"scoreContext":{"type":"object","properties":{"currentPeriod":{"type":"number","example":2,"description":"Current period number"},"stageLiveStatus":{"type":"string","example":"LIVE","description":"Stage live status"},"currentPeriodString":{"type":"string","example":"2nd Half","description":"Current period string"},"fullScore":{"type":"object","properties":{"home":{"type":"number","example":2,"description":"Home team full score"},"away":{"type":"number","example":2,"description":"Home team full score"}},"description":"Full score"},"info":{"type":"string","example":"Match in progress","description":"Additional live match information"},"currentPlay":{"type":"number","example":1,"description":"Current play (example cricket)"},"periodScores":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Period key"},"Value":{"type":"object","properties":{"NF":{"type":"string","example":"HT","description":"Normalized period label"},"S1":{"type":"number","example":1,"description":"Home score for this period"},"S2":{"type":"number","example":0,"description":"Away score for this period"}},"required":["NF"]}},"required":["Key","Value"]},"description":"Scores per period","example":[{"Key":1,"Value":{"NF":"1st Half","S1":1,"S2":0}}]},"setScore":{"type":"object","properties":{"S1":{"type":"string"},"S2":{"type":"string"}},"required":["S1","S2"]},"timeoutRemaining":{"type":"number","example":60,"description":"Timeout remaining (seconds)"},"timeSeconds":{"type":"number","example":3420,"description":"Match time elapsed in seconds"},"matchStatistics":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Statistics group key"},"Value":{"type":"array","items":{"type":"object","properties":{"ID":{"type":"number","example":101,"description":"Statistic identifier"},"N":{"type":"string","example":"Possession","description":"Statistic name"},"S1":{"type":"string","example":"55%","description":"Home team value"},"S2":{"type":"string","example":"45%","description":"Away team value"}},"required":["ID","N","S1","S2"]}}},"required":["Key","Value"]},"description":"Match statistics"},"inningsData":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"string","example":"Team1Scores"},"Value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","additionalProperties":{"nullable":true}}],"example":"75/4"}},"required":["Key","Value"]}}},"description":"Live scoring context; present only when match is live"},"weather":{"type":"object","properties":{"temperature":{"type":"string","example":"+7°C","description":"Air temperature"},"cloudLevel":{"type":"string","example":"69","description":"Cloud coverage percentage"},"cloudDescription":{"type":"string","example":"Cloudy, rain","description":"Cloud / weather condition description"},"uvIndex":{"type":"string","example":"3","description":"UV index level"},"windSpeed":{"type":"string","example":"1.7","description":"Wind speed"},"windDirection":{"type":"string","example":"S","description":"Wind direction"},"windUnit":{"type":"string","example":"m/s","description":"Wind speed unit"},"pressure":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Atmospheric pressure"},"humidity":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Humidity information"},"precipitation":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Precipitation probability"}}},"probability":{"type":"object","properties":{"home":{"type":"number","example":0.44,"description":"Probability of home team winning (percentage)"},"draw":{"type":"number","example":0.26,"description":"Probability of a draw (percentage)"},"away":{"type":"number","example":0.5,"description":"Probability of away team winning (percentage)"}}},"slug":{"type":"string","example":"manchester-united-vs-liverpool","description":"SEO-friendly match slug"}},"required":["id","team","league","status","startTime","ec","sport","periodName","slug"]}}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/{status}/{sport}/{league}":{"get":{"tags":["Sports"],"operationId":"getLeague","summary":"Get game list by league","description":"Returns a list of games for the specified league within a sport and status.\n\nThe response contains all available events associated with the given league slug, including upcoming and live games depending on the provided status.","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$","example":"football","description":"Unique identifier for the sport (e.g., 'football', 'cricket')"},"required":true,"description":"Unique identifier for the sport (e.g., 'football', 'cricket')","name":"sport","in":"path"},{"schema":{"type":"string","example":"2796379-indonesia-liga-4","description":"Unique identifier for the league (e.g., '2796379-indonesia-liga-4')"},"required":true,"description":"Unique identifier for the league (e.g., '2796379-indonesia-liga-4')","name":"league","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"}],"responses":{"200":{"description":"List of events for a league","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","nullable":true,"example":987654,"description":"Match identifier"},"ci":{"type":"number","nullable":true,"example":4353456,"description":"Category identifier"},"team":{"type":"object","properties":{"home":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Home team","example":{"id":12345,"name":"Manchester United","slug":"manchester-united","countryId":44,"logo":"https://cdn.example.com/teams/manchester-united.png"}},"away":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Away team","example":{"id":67890,"name":"Liverpool","slug":"liverpool","countryId":44,"logo":"https://cdn.example.com/teams/liverpool.png"}}},"required":["home","away"],"description":"Match teams (home vs away)"},"league":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"}},"required":["id","name","slug"],"description":"League information","example":{"id":1,"name":"Premier League","slug":"premier-league"}},"country":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"}},"required":["id","name"],"description":"Country information","example":{"id":44,"name":"England"}},"status":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Match status"},"startTime":{"type":"integer","example":1768651200,"description":"Unix timestamp (UTC)"},"ec":{"type":"integer","example":134,"description":"event count"},"sport":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"}},"required":["id","name","slug"]},"gameTypeId":{"type":"number"},"period":{"type":"number"},"periodName":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":6,"description":"Market id"},"name":{"type":"string","example":"Total Goals","description":"Localized market name"},"gs":{"type":"number","example":1,"description":"Market game status"},"outcomes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":83,"description":"Outcome id"},"name":{"type":"string","example":"(2.5) Over","description":"Localized outcome name"},"coefficient":{"type":"number","example":1.9,"description":"Odds coefficient"},"suspended":{"type":"boolean","example":false,"description":"Outcome suspended status"},"point":{"type":"number","example":2.5,"description":"Handicap / line value"},"pl":{"type":"object","properties":{"I":{"type":"number","example":1,"description":"Player/participant id"},"N":{"type":"string","example":"Player Name","description":"Player/participant name"}},"required":["I","N"],"description":"Player/participant info (if applicable)"}},"required":["id","name","coefficient"]}},"description":"Grouped outcomes (2D array)","example":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}},"required":["id","name","gs","outcomes"]},"description":"Transformed GE markets","example":[{"id":6,"name":"Total Goals","gs":1,"outcomes":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]}},"marketType":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"count":{"type":"number"},"key":{"type":"string"}},"required":["id","name","count","key"]}},"matchInfo":{"type":"object","properties":{"location":{"type":"string","example":"Old Trafford, Manchester","description":"Match venue or location"},"stage":{"type":"string","example":"Semi Final","description":"Tournament stage"},"format":{"type":"string","example":"Regular Time","description":"Match format"}},"description":"Additional match metadata from provider"},"scoreContext":{"type":"object","properties":{"currentPeriod":{"type":"number","example":2,"description":"Current period number"},"stageLiveStatus":{"type":"string","example":"LIVE","description":"Stage live status"},"currentPeriodString":{"type":"string","example":"2nd Half","description":"Current period string"},"fullScore":{"type":"object","properties":{"home":{"type":"number","example":2,"description":"Home team full score"},"away":{"type":"number","example":2,"description":"Home team full score"}},"description":"Full score"},"info":{"type":"string","example":"Match in progress","description":"Additional live match information"},"currentPlay":{"type":"number","example":1,"description":"Current play (example cricket)"},"periodScores":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Period key"},"Value":{"type":"object","properties":{"NF":{"type":"string","example":"HT","description":"Normalized period label"},"S1":{"type":"number","example":1,"description":"Home score for this period"},"S2":{"type":"number","example":0,"description":"Away score for this period"}},"required":["NF"]}},"required":["Key","Value"]},"description":"Scores per period","example":[{"Key":1,"Value":{"NF":"1st Half","S1":1,"S2":0}}]},"setScore":{"type":"object","properties":{"S1":{"type":"string"},"S2":{"type":"string"}},"required":["S1","S2"]},"timeoutRemaining":{"type":"number","example":60,"description":"Timeout remaining (seconds)"},"timeSeconds":{"type":"number","example":3420,"description":"Match time elapsed in seconds"},"matchStatistics":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Statistics group key"},"Value":{"type":"array","items":{"type":"object","properties":{"ID":{"type":"number","example":101,"description":"Statistic identifier"},"N":{"type":"string","example":"Possession","description":"Statistic name"},"S1":{"type":"string","example":"55%","description":"Home team value"},"S2":{"type":"string","example":"45%","description":"Away team value"}},"required":["ID","N","S1","S2"]}}},"required":["Key","Value"]},"description":"Match statistics"},"inningsData":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"string","example":"Team1Scores"},"Value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","additionalProperties":{"nullable":true}}],"example":"75/4"}},"required":["Key","Value"]}}},"description":"Live scoring context; present only when match is live"},"weather":{"type":"object","properties":{"temperature":{"type":"string","example":"+7°C","description":"Air temperature"},"cloudLevel":{"type":"string","example":"69","description":"Cloud coverage percentage"},"cloudDescription":{"type":"string","example":"Cloudy, rain","description":"Cloud / weather condition description"},"uvIndex":{"type":"string","example":"3","description":"UV index level"},"windSpeed":{"type":"string","example":"1.7","description":"Wind speed"},"windDirection":{"type":"string","example":"S","description":"Wind direction"},"windUnit":{"type":"string","example":"m/s","description":"Wind speed unit"},"pressure":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Atmospheric pressure"},"humidity":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Humidity information"},"precipitation":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Precipitation probability"}}},"probability":{"type":"object","properties":{"home":{"type":"number","example":0.44,"description":"Probability of home team winning (percentage)"},"draw":{"type":"number","example":0.26,"description":"Probability of a draw (percentage)"},"away":{"type":"number","example":0.5,"description":"Probability of away team winning (percentage)"}}},"slug":{"type":"string","example":"manchester-united-vs-liverpool","description":"SEO-friendly match slug"}},"required":["id","team","league","status","startTime","ec","sport","periodName","slug"]}}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}},"/sports/{status}/{sport}/{league}/{game}":{"get":{"tags":["Sports"],"operationId":"getGame","summary":"Get game","description":"Fetches a single game by its unique slug within a league and sport. This endpoint is commonly used to display detailed game information, including match status and related metadata.","parameters":[{"schema":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Filter sports by event status"},"required":true,"description":"Filter sports by event status","name":"status","in":"path"},{"schema":{"type":"string","minLength":1,"pattern":"^[a-z0-9-]+$","example":"football","description":"Unique identifier for the sport (e.g., 'football', 'cricket')"},"required":true,"description":"Unique identifier for the sport (e.g., 'football', 'cricket')","name":"sport","in":"path"},{"schema":{"type":"string","example":"2796379-indonesia-liga-4","description":"Unique identifier for the league (e.g., '2796379-indonesia-liga-4')"},"required":true,"description":"Unique identifier for the league (e.g., '2796379-indonesia-liga-4')","name":"league","in":"path"},{"schema":{"type":"string","example":"683886685-adelaide-united-vs-central-coast-mariners","description":"Unique identifier for the event (e.g., '683886685-adelaide-united-vs-central-coast-mariners')"},"required":true,"description":"Unique identifier for the event (e.g., '683886685-adelaide-united-vs-central-coast-mariners')","name":"game","in":"path"},{"schema":{"type":"string","enum":["en","bn","hi"],"default":"en","example":"en","description":"Response language (en, bn, hi, etc.)"},"required":false,"description":"Response language (en, bn, hi, etc.)","name":"locale","in":"query"},{"schema":{"type":"string","enum":["all_markets","popular","total","handicap","players","goals","intervals","other","points","games","result_plus_total","asian_markets","tie_break","period","special","option_Bet"],"default":"all_markets","example":"all_markets","description":"Market type filter"},"required":false,"description":"Market type filter","name":"marketType","in":"query"}],"responses":{"200":{"description":"Game event details","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"requestId":{"type":"string","format":"uuid","example":"6f8a7c3e-1f2a-4d8e-b9a1-9c3b6a2c8f11"},"data":{"type":"object","properties":{"id":{"type":"number","nullable":true,"example":987654,"description":"Match identifier"},"ci":{"type":"number","nullable":true,"example":4353456,"description":"Category identifier"},"team":{"type":"object","properties":{"home":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Home team","example":{"id":12345,"name":"Manchester United","slug":"manchester-united","countryId":44,"logo":"https://cdn.example.com/teams/manchester-united.png"}},"away":{"type":"object","properties":{"id":{"type":"number","example":12345,"description":"Unique team identifier"},"name":{"type":"string","example":"Manchester United","description":"Team display name"},"slug":{"type":"string","example":"manchester-united","description":"URL-friendly team identifier"},"countryId":{"type":"number","example":44,"description":"Country identifier where the team is registered"},"logo":{"type":"string","nullable":true,"example":"https://cdn.example.com/teams/manchester-united.png","description":"Team logo URL"}},"required":["id","name","slug","countryId"],"description":"Away team","example":{"id":67890,"name":"Liverpool","slug":"liverpool","countryId":44,"logo":"https://cdn.example.com/teams/liverpool.png"}}},"required":["home","away"],"description":"Match teams (home vs away)"},"league":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique league identifier"},"name":{"type":"string","example":"Premier League","description":"League display name"},"slug":{"type":"string","example":"premier-league","description":"URL-friendly league identifier"}},"required":["id","name","slug"],"description":"League information","example":{"id":1,"name":"Premier League","slug":"premier-league"}},"country":{"type":"object","properties":{"id":{"type":"number","example":44,"description":"Unique country identifier"},"name":{"type":"string","example":"England","description":"Country name"}},"required":["id","name"],"description":"Country information","example":{"id":44,"name":"England"}},"status":{"type":"string","enum":["live","upcoming"],"example":"live","description":"Match status"},"startTime":{"type":"integer","example":1768651200,"description":"Unix timestamp (UTC)"},"ec":{"type":"integer","example":134,"description":"event count"},"sport":{"type":"object","properties":{"id":{"type":"number","example":1,"description":"Unique sport identifier"},"name":{"type":"string","example":"Football","description":"Sport display name"},"slug":{"type":"string","example":"football","description":"URL-friendly sport identifier"}},"required":["id","name","slug"]},"gameTypeId":{"type":"number"},"period":{"type":"number"},"periodName":{"type":"string"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":6,"description":"Market id"},"name":{"type":"string","example":"Total Goals","description":"Localized market name"},"gs":{"type":"number","example":1,"description":"Market game status"},"outcomes":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","example":83,"description":"Outcome id"},"name":{"type":"string","example":"(2.5) Over","description":"Localized outcome name"},"coefficient":{"type":"number","example":1.9,"description":"Odds coefficient"},"suspended":{"type":"boolean","example":false,"description":"Outcome suspended status"},"point":{"type":"number","example":2.5,"description":"Handicap / line value"},"pl":{"type":"object","properties":{"I":{"type":"number","example":1,"description":"Player/participant id"},"N":{"type":"string","example":"Player Name","description":"Player/participant name"}},"required":["I","N"],"description":"Player/participant info (if applicable)"}},"required":["id","name","coefficient"]}},"description":"Grouped outcomes (2D array)","example":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}},"required":["id","name","gs","outcomes"]},"description":"Transformed GE markets","example":[{"id":6,"name":"Total Goals","gs":1,"outcomes":[[{"id":83,"name":"(2.5) Over","coefficient":1.9,"suspended":false,"point":2.5},{"id":84,"name":"(2.5) Under","coefficient":1.9,"suspended":false,"point":2.5}]]}]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"]}},"marketType":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"},"count":{"type":"number"},"key":{"type":"string"}},"required":["id","name","count","key"]}},"matchInfo":{"type":"object","properties":{"location":{"type":"string","example":"Old Trafford, Manchester","description":"Match venue or location"},"stage":{"type":"string","example":"Semi Final","description":"Tournament stage"},"format":{"type":"string","example":"Regular Time","description":"Match format"}},"description":"Additional match metadata from provider"},"scoreContext":{"type":"object","properties":{"currentPeriod":{"type":"number","example":2,"description":"Current period number"},"stageLiveStatus":{"type":"string","example":"LIVE","description":"Stage live status"},"currentPeriodString":{"type":"string","example":"2nd Half","description":"Current period string"},"fullScore":{"type":"object","properties":{"home":{"type":"number","example":2,"description":"Home team full score"},"away":{"type":"number","example":2,"description":"Home team full score"}},"description":"Full score"},"info":{"type":"string","example":"Match in progress","description":"Additional live match information"},"currentPlay":{"type":"number","example":1,"description":"Current play (example cricket)"},"periodScores":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Period key"},"Value":{"type":"object","properties":{"NF":{"type":"string","example":"HT","description":"Normalized period label"},"S1":{"type":"number","example":1,"description":"Home score for this period"},"S2":{"type":"number","example":0,"description":"Away score for this period"}},"required":["NF"]}},"required":["Key","Value"]},"description":"Scores per period","example":[{"Key":1,"Value":{"NF":"1st Half","S1":1,"S2":0}}]},"setScore":{"type":"object","properties":{"S1":{"type":"string"},"S2":{"type":"string"}},"required":["S1","S2"]},"timeoutRemaining":{"type":"number","example":60,"description":"Timeout remaining (seconds)"},"timeSeconds":{"type":"number","example":3420,"description":"Match time elapsed in seconds"},"matchStatistics":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"number","example":1,"description":"Statistics group key"},"Value":{"type":"array","items":{"type":"object","properties":{"ID":{"type":"number","example":101,"description":"Statistic identifier"},"N":{"type":"string","example":"Possession","description":"Statistic name"},"S1":{"type":"string","example":"55%","description":"Home team value"},"S2":{"type":"string","example":"45%","description":"Away team value"}},"required":["ID","N","S1","S2"]}}},"required":["Key","Value"]},"description":"Match statistics"},"inningsData":{"type":"array","items":{"type":"object","properties":{"Key":{"type":"string","example":"Team1Scores"},"Value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","additionalProperties":{"nullable":true}}],"example":"75/4"}},"required":["Key","Value"]}}},"description":"Live scoring context; present only when match is live"},"weather":{"type":"object","properties":{"temperature":{"type":"string","example":"+7°C","description":"Air temperature"},"cloudLevel":{"type":"string","example":"69","description":"Cloud coverage percentage"},"cloudDescription":{"type":"string","example":"Cloudy, rain","description":"Cloud / weather condition description"},"uvIndex":{"type":"string","example":"3","description":"UV index level"},"windSpeed":{"type":"string","example":"1.7","description":"Wind speed"},"windDirection":{"type":"string","example":"S","description":"Wind direction"},"windUnit":{"type":"string","example":"m/s","description":"Wind speed unit"},"pressure":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Atmospheric pressure"},"humidity":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Humidity information"},"precipitation":{"type":"object","properties":{"value":{"type":"string","example":"750","description":"Numeric value as string"},"unit":{"type":"string","example":"mmHg","description":"Measurement unit"}},"description":"Precipitation probability"}}},"probability":{"type":"object","properties":{"home":{"type":"number","example":0.44,"description":"Probability of home team winning (percentage)"},"draw":{"type":"number","example":0.26,"description":"Probability of a draw (percentage)"},"away":{"type":"number","example":0.5,"description":"Probability of away team winning (percentage)"}}},"slug":{"type":"string","example":"manchester-united-vs-liverpool","description":"SEO-friendly match slug"}},"required":["id","team","league","status","startTime","ec","sport","periodName","slug"]}},"required":["success","requestId","data"]}}}},"400":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"message":{"type":"string"}},"required":["path","message"]}}},"required":["success","error","issues"]}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"error":{"type":"string"},"message":{"type":"string"}},"required":["success","error"]}}}}}}}}}