Skip to main content
GET
Get bet by ID or txID
Look up a single bet (matched, graded, or open offer) belonging to the caller. Pass either id or txID, not both.

Request

GET /user/getBetByID
string
Bet id from a list endpoint such as /user/getMatchedBets.
string
Transaction id, e.g. the wagerRequestID or txID returned by /session/v3/place.
You must pass exactly one of id or txID.

Response

The shape of bet depends on the bet’s current state:
  • A graded bet returns the GradedWager shape, including risk, win, fee, and result.
  • A matched bet returns the MatchedBet shape.
  • An open offer returns the UnmatchedOrder shape.
Note that, unlike most endpoints, this one returns the bet at the top level (not under data).

Example

Errors

Authorizations

Authorization
string
header
required

Pass your auth token in the Authorization header. The Bearer prefix is optional; the server also accepts a signed auth cookie or a token field in the request body.

Query Parameters

id
string

Bet id from a list endpoint.

txID
string

Transaction id (e.g. wagerRequestID or txID returned from place).

Response

The bet, in matched, graded, or open form depending on its current state.

bet
object

A bet that has been matched but not yet graded.