Bet
Register a player bet
Called when a player places a bet. You must deduct the bet amount from the player's balance.
POST /bet HTTP/1.1
Host: your.game.api
X-Marbles-Signature: <signature>
Content-Type: application/json
{
"requestId": "8df0475e-5069-483a-8205-f6089997abc9",
"transactionId": "ea0240f5-483d-434b-a8d4-04dabf61cde3",
"clientSessionId": "0k3cz83bb3h2vn53ocnc7pxw9",
"clientPlayerId": "02mnrpyv2qd9jbwhoniyimxsy",
"roundId": "17cc81fd-df13-4ca4-857d-de0f766dc372",
"gameId": "f1c0b104-f29d-44a9-ae93-e8afcbe3feb9",
"amount": 1000000,
"currency": "USD",
"meta": {
"betType": "PickWinner",
"selection": [
"40e5e0eb-cc5a-4a81-a157-7a4b641c05df",
"17fcb2c6-f0ac-4855-98ef-9e7e3fd738bd",
"bb65a881-a4fe-4b65-aae5-e085a9f96cd3"
]
}
}
| Field | Type | Description |
|---|
requestId | string | Unique request identifier (UUID) |
transactionId | string | Unique transaction identifier for this bet |
clientSessionId | string | The player's session identifier |
clientPlayerId | string | The player's unique identifier |
roundId | string | The game round identifier |
gameId | string | The game identifier |
amount | integer | Bet amount with 5-digit precision |
currency | string | ISO 4217 currency code |
meta | object | Additional bet metadata |
meta.betType | string | Type of bet placed |
meta.selection | array | Selected items for the bet |
HTTP/1.1 200 OK
X-Marbles-Signature: <signature>
Content-Type: application/json
{
"status": "SUCCESS",
"requestId": "8df0475e-5069-483a-8205-f6089997abc9",
"clientPlayerId": "02mnrpyv2qd9jbwhoniyimxsy",
"currency": "USD",
"balance": 1000000
}
| Field | Type | Description |
|---|
status | string | "SUCCESS" |
requestId | string | Echo back the request ID |
clientPlayerId | string | Echo back the player ID |
currency | string | ISO 4217 currency code |
balance | integer | New balance after bet (5-digit precision) |
HTTP/1.1 200 OK
X-Marbles-Signature: <signature>
Content-Type: application/json
{
"status": "INSUFFICIENT_BALANCE_ERROR",
"requestId": "8df0475e-5069-483a-8205-f6089997abc9",
"clientPlayerId": "02mnrpyv2qd9jbwhoniyimxsy"
}
| Status | Description |
|---|
INSUFFICIENT_BALANCE_ERROR | Player does not have enough balance |
DUPLICATE_TRANSACTION_ERROR | Transaction ID already exists with different payload |
BONUS_ERROR | Bet does not pass bonus rules |
BET_LIMIT_REACHED_ERROR | Player has reached their betting limit |
UNKNOWN_ERROR | Bet could not be registered |
