Skip to main content
GET
/
user
/
getBetByUserReference
Get bet by user reference
curl --request GET \
  --url https://api.4casters.io/user/getBetByUserReference \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "unmatched": [
      {
        "id": "<string>",
        "txID": "<string>",
        "bet": 123,
        "odds": 123,
        "spread": 123,
        "total": 123,
        "participantID": "<string>",
        "otherParticipantID": "<string>",
        "expiry": "2023-11-07T05:31:56Z",
        "filled": 123,
        "offered": 123,
        "remaining": 123,
        "takenRatio": 123,
        "createdAt": "2023-11-07T05:31:56Z",
        "origin": "<string>",
        "graded": true,
        "closed": true,
        "adminRefund": true,
        "userReference": "<string>",
        "wagerRequestID": "<string>",
        "game": {
          "id": "<string>",
          "league": "<string>",
          "sport": "<string>",
          "start": "2023-11-07T05:31:56Z",
          "ended": true,
          "eventName": "<string>",
          "isFutures": true,
          "participants": [
            {
              "id": "<string>",
              "longName": "<string>",
              "shortName": "<string>",
              "mainPitcher": "<string>",
              "rotationNumber": "<string>",
              "futuresSide": "<string>",
              "score": 123
            }
          ]
        }
      }
    ],
    "matched": [
      {
        "id": "<string>",
        "txID": "<string>",
        "bet": 123,
        "odds": 123,
        "spread": 123,
        "total": 123,
        "participantID": "<string>",
        "market": "<string>",
        "side": "<string>",
        "userReference": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "matchedTime": "2023-11-07T05:31:56Z",
        "graded": true,
        "closed": true,
        "origin": "<string>",
        "adminRefund": true,
        "risk": "<string>",
        "win": "<string>",
        "fee": "<string>",
        "game": {
          "id": "<string>",
          "league": "<string>",
          "sport": "<string>",
          "start": "2023-11-07T05:31:56Z",
          "ended": true,
          "eventName": "<string>",
          "isFutures": true,
          "participants": [
            {
              "id": "<string>",
              "longName": "<string>",
              "shortName": "<string>",
              "mainPitcher": "<string>",
              "rotationNumber": "<string>",
              "futuresSide": "<string>",
              "score": 123
            }
          ]
        }
      }
    ],
    "graded": [
      {
        "id": "<string>",
        "txID": "<string>",
        "ticketNumber": "<string>",
        "bet": 123,
        "odds": 123,
        "spread": 123,
        "total": 123,
        "participantID": "<string>",
        "market": "<string>",
        "side": "<string>",
        "matchedTime": "2023-11-07T05:31:56Z",
        "settledAt": "2023-11-07T05:31:56Z",
        "createdAt": "2023-11-07T05:31:56Z",
        "graded": true,
        "closed": true,
        "cancelled": true,
        "adminRefund": true,
        "platform": "api",
        "fee": "<string>",
        "risk": "<string>",
        "win": "<string>",
        "result": "<string>",
        "pinnacleLine": {},
        "game": {
          "id": "<string>",
          "league": "<string>",
          "sport": "<string>",
          "start": "2023-11-07T05:31:56Z",
          "ended": true,
          "eventName": "<string>",
          "isFutures": true,
          "participants": [
            {
              "id": "<string>",
              "longName": "<string>",
              "shortName": "<string>",
              "mainPitcher": "<string>",
              "rotationNumber": "<string>",
              "futuresSide": "<string>",
              "score": 123
            }
          ]
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.4casters.io/llms.txt

Use this file to discover all available pages before exploring further.

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
​
userReference
string
required
Client-defined reference passed in at place time.
​
gameID
string
required
Scope the lookup to a single game.
curl "https://api.4casters.io/user/getBetByUserReference?userReference=my-order-1&gameID=67d1c942215edc7ee0c806ef" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

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

​
Errors

StatusMeaning
408userReference or gameID missing.

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