Skip to main content
GET
Get bet by user reference
Look up every bet tied to a userReference. userReference is an optional client-defined string you can attach to an order at place time to track it on your side — this endpoint is the read counterpart. The response separates results into three buckets:
  • unmatched — open offers from this reference that are still resting on the book.
  • matched — matched (ungraded) bets from this reference.
  • graded — graded (settled) bets from this reference, including risk, win, fee, and result.

Request

GET /user/getBetByUserReference
string
required
Client-defined reference passed in at place time.
string
required
Scope the lookup to a single game.

Response

array
Open orders — same shape as Get unmatched orders.
array
Matched (ungraded) bets — same shape as Get matched bets.
array
Graded (settled) bets — same shape as Get graded wagers.

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

userReference
string
required

The client-defined reference passed in at place time.

gameID
string
required

A 4casters game id (ObjectID). Get game ids from GET /exchange/v2/getGames or GET /exchange/v2/getOrderbook.

Response

Three-bucket wager view: open (unmatched), filled-but-not-graded (matched), and settled (graded).

data
object