Overtime V2 user history

Get a user history. It returns all tickets grouped by status.

REST API

GET https://api.overtime.io/overtime-v2/networks/{{network}}/users/{{userAddress}}/history

See the user history API endpoint with request/response examples under Postman documentation.

Example Request

https://api.overtime.io/overtime-v2/networks/10/users/0x819a371aB4BfdeD173Edcf12b6D37c6C80E4a8C0/history

Example Response

200 OK

{
  "open": [...],
  "claimable": [
    {
      "id": "0xaDD59A5F6c144B3cBd6AC9d10B848EEABa633f93",
      "timestamp": 1718478509000,
      "collateral": "THALES",
      "account": "0x9f8e4ee788D9b00A3409584E18034aA7B736C396",
      "buyInAmount": 38.58138411178477,
      "fees": 0.7716276822356954,
      "totalQuote": 0.5294647111772277,
      "payout": 72.86866017189656,
      "numOfMarkets": 1,
      "expiry": 1726254509000,
      "isResolved": false,
      "isPaused": false,
      "isCancelled": false,
      "isLost": false,
      "isUserTheWinner": true,
      "isExercisable": true,
      "isClaimable": true,
      "isOpen": false,
      "finalPayout": 0,
      "isLive": true,
      "sportMarkets": [
        {
          "gameId": "0x3430343338343400000000000000000000000000000000000000000000000000",
          "sport": "Soccer",
          "leagueId": 50,
          "subLeagueId": 50,
          "leagueName": "UEFA EURO 2024",
          "typeId": 0,
          "type": "winner",
          "maturity": 1718478569000,
          "maturityDate": "2024-06-15T19:09:29.000Z",
          "homeTeam": "Italy",
          "awayTeam": "Albania",
          "homeScore": 2,
          "homeScoreByPeriod": [
            2
          ],
          "awayScore": 1,
          "awayScoreByPeriod": [
            1
          ],
          "isOpen": false,
          "isResolved": true,
          "isCancelled": false,
          "isWinning": true,
          "isOneSideMarket": false,
          "line": 0,
          "isPlayerPropsMarket": false,
          "isOneSidePlayerPropsMarket": false,
          "isYesNoPlayerPropsMarket": false,
          "playerProps": {
            "playerId": 0,
            "playerName": "Player Name"
          },
          "selectedCombinedPositions": [],
          "position": 0,
          "odd": 0.52941176470611,
          "isGameFinished": true,
          "gameStatus": "finished"
        }
      ]
    }
  ],
  "closed": [...]
}

Response Parameters

Name	Type	Description
open	Ticket[]	Open tickets
claimable	Ticket[]	Claimable tickets
closed	Ticket[]	Closed tickets

Ticket

Name	Type	Description
id	string	Ticket address
timestamp	number	Ticket created timestamp
collateral	string	Collateral used for ticket
account	string	Ticket owner address
buyInAmount	number	Ticket buy-in amount
fees	number	Ticket fees (paid by LP)
totalQuote	number	Ticket total quote
payout	number	Ticket payout
numOfMarkets	number	Number of markets on the ticket
expiry	number	Ticket expiry timestamp (90 days from creation)
isResolved	boolean	Is ticket resolved (exercised): true or false.
isPaused	boolean	Is ticket paused: true or false.
isCancelled	boolean	Is ticket cancelled (all markets on the ticket are cancelled): true or false.
isLost	boolean	Is ticket lost (by user): true or false.
isUserTheWinner	boolean	Is user the winner: true or false.
isExercisable	boolean	Is ticket exercisable (all markets are resolved): true or false.
isClaimable	boolean	Is ticket claimable (by user - user is the winner and not resolved): true or false.
isOpen	boolean	Is ticket open: true or false.
finalPayout	number	Final payout (set only for resolved tickets, otherwise is 0)
isLive	boolean	Is live ticket (ticket with live market): true or false.
sportMarkets	TicketMarket[]	Selected markets on the ticket

TicketMarket

Name	Type	Description
gameId	string	Game ID
sport	string	Game sport. See Overtime V2 sports.
leagueId	number	Game league ID. See Overtime V2 sports.
leagueName	string	Game league name. See Overtime V2 sports.
subLeagueId	number	Game subleague ID. It is used for some sports (tennis and UFC) to separate different levels and rounds of tournaments. (needed on the contract side, not used on UI).
typeId	number	Type ID of the market. 0 for parent market (moneyline/winner). For other types see Overtime V2 market types.
type	string	Type of the market. See Overtime V2 market types.
line	number	Market line (if available).
maturity	number	Game start timestamp
maturityDate	date	Game start date and time
homeTeam	string	The name of the home team
awayTeam	string	The name of the away team
isOpen	boolean	Is market open: true or false.
isResolved	boolean	Is market resolved: true or false.
isCancelled	boolean	Is market cancelled: true or false.
isWinning	boolean	Is winning market for the user: true or false.
isOneSideMarket	boolean	Is one-side market (motosport, golf winner...): true or false.
isPlayerPropsMarket	boolean	Is player props market: true or false.
isOneSidePlayerPropsMarket	boolean	Is one-side player props market (who will score first/last touchdown...): true or false.
isYesNoPlayerPropsMarket	boolean	Is YES/NO player props market (double-double, triple-double...): true or false.
playerProps	PlayerProps	Player info (if player props market)
selectedCombinedPositions	CombinedPosition[]	Selected combined positions if the market is that type (half-time/full-time, winner+total...)
position	number	Selected position on the market
odd	Odds	Market odds
gameStatus	string	Current game status
isGameFinished	boolean	Is game finished: true or false.
homeScore	number | string	Home team score or player score if the market is player props market
awayScore	number | string	Away team score or 0 if the market is player props market
homeScoreByPeriod	number[]	Home team score by period
awayScoreByPeriod	number[]	Away team score by period

PlayerProps

Name	Type	Description
playerId	number	Player ID
playerName	string	The name of the player
playerScore	number | string	Player score

CombinedPosition

Name	Type	Description
typeId	number	The type ID of single market
position	number	The position on the single market
line	number	Single market line

Odds

Name	Type	Description
american	number	American format of the odds
decimal	number	Decimal format of the odds
normalizedImplied	number	Normalized Implied format of the odds