Skip to main content
GET
/
user
/
getGradedWagers
Get graded wagers
curl --request GET \
  --url https://api.4casters.io/user/getGradedWagers \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "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
            }
          ]
        }
      }
    ],
    "summary": {
      "pnl": 123,
      "volume": 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.

Returns all of the caller’s graded (settled) wagers between two dates, plus a summary of P&L and volume. Dates correspond to the start time of the game the wager is on (so startDate=06-22-2022 returns wagers on games starting after 06-21-2022 00:00 GMT).

​
Request

GET /user/getGradedWagers
​
startDate
string
Start date (MM-DD-YYYY). Defaults to 10-21-2020.
​
endDate
string
End date (MM-DD-YYYY). Defaults to today.
curl "https://api.4casters.io/user/getGradedWagers?startDate=01-01-2024&endDate=02-01-2024" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
data.graded
array
Array of graded wagers, sorted descending by game start time.
​
data.summary
object
Aggregated totals over the returned wagers.

​
Example

{
  "data": {
    "graded": [
      {
        "id": "64c98e8c0745a206acf18ad7",
        "txID": "64c99640453fd2ad91206018",
        "ticketNumber": "5a5494406ef9e2c5988b30bf666ce55e",
        "type": "total",
        "outcome": "loser",
        "bet": 1,
        "odds": 101,
        "total": 8.5,
        "OU": "over",
        "matchedTime": "2023-08-01T23:33:20.273Z",
        "settledAt": "2023-08-02T02:26:16.152Z",
        "createdAt": "2023-08-01T23:33:20.273Z",
        "graded": true,
        "platform": "api",
        "risk": "1.01",
        "win": "1.00",
        "fee": "0.01",
        "result": "-1.01",
        "pinnacleLine": { "odds": -102, "total": 8.5, "OU": "over" },
        "game": {
          "id": "64c7fa454803b0ff0f7f5741",
          "league": "MLB",
          "sport": "baseball",
          "start": "2023-08-01T23:45:00.000Z",
          "ended": true,
          "participants": [/* ... */]
        }
      }
    ],
    "summary": { "pnl": -1, "volume": 1 }
  }
}

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

​
startDate
string

Start date (MM-DD-YYYY). Defaults to 10-21-2020.

Example:

"01-01-2024"

​
endDate
string

End date (MM-DD-YYYY). Defaults to today.

Example:

"02-01-2024"

Response

Graded wagers and summary

​
data
object