Skip to main content
GET
/
user
/
getGameLiability
Get game liability
curl --request GET \
  --url https://api.4casters.io/user/getGameLiability \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "liability": -125.5
  }
}

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.

Calculate the caller’s worst-case financial liability for a single game, taking into account every bet on every market in the game. The value is always <= 0 — even a fully hedged book can incur loss from rainouts, suspensions, or disqualifications.

​
Request

GET /user/getGameLiability
​
gameID
string
required
The game id to compute liability for.
curl "https://api.4casters.io/user/getGameLiability?gameID=657f8ea1ea0ce6f62c1fe37d" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
data.liability
number
The worst-case loss in account currency. Always <= 0. Returns 0 when the caller has no bets on the game.

​
Example

{
  "data": { "liability": -125.50 }
}

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

​
gameID
string
required

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

Response

Liability for the requested game (always <= 0).

​
data
object