Skip to main content
GET
/
user
/
getBetByWagerRequestID
Get bet by wager request ID
curl --request GET \
  --url https://api.4casters.io/user/getBetByWagerRequestID \
  --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 single wagerRequestID. A wagerRequestID is server-generated for each order in a place request — use it to tie together every fill and resting offer that resulted from a single submitted order. The response separates results into three buckets:
  • unmatched — open offers from the request that are still resting on the book. Always empty for this endpoint — use Get bet by user reference instead if you need open offers in the response.
  • matched — matched (ungraded) bets from the request.
  • graded — graded (settled) bets from the request, including risk, win, fee, and result.

​
Request

GET /user/getBetByWagerRequestID
​
wagerRequestID
string
required
The wagerRequestID returned by /session/v3/place (in either the matched[].wagerRequestID or unmatched.wagerRequestID field).
curl "https://api.4casters.io/user/getBetByWagerRequestID?wagerRequestID=65f69afec4c141f5ecc5dc0b" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
data.unmatched
array
Empty array.
​
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
400wagerRequestID is missing or unknown.

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

​
wagerRequestID
string
required

The wagerRequestID returned by /session/v3/place.

Response

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

​
data
object