155.io API
Endpoints provided by 155.io for game integration
These are the endpoints we provide for you to integrate our games.
Available Endpoints
/game/games
Fetch available games for your catalogue
/game/game/url
Get a game URL for a specific player
/game/round
Look up round details, outcome, and race clip
/game/bets
Look up a player's bet history
/game/free-bets/rewards
Grant promotional free bets to a player
/game/free-bets/rewards/cancel
Cancel unused free bets for a reward
Round Lookup Page
Shareable web page for round details, race clips, and bet info
Base URLs
| Environment | Base URL |
|---|---|
| Production | https://api.marbles.xyz |
| Staging | https://api.stagingmarbles.io |
Every endpoint lives under the /game base path — the paths shown on the cards above are the full paths after the base URL. Note the launch endpoint is /game/game/url: the doubled /game is correct (base path + the endpoint's own /game/url).
Rate limits
POST /game/round and POST /game/bets share a combined limit of 60 requests per minute per source IP. Over the limit you receive HTTP 429 with {"error": "Too many requests", "details": "Please try again later"} — back off and retry after a minute. The other endpoints have no fixed per-minute limit.
Authentication
These endpoints are authenticated by IP whitelist — your server's outbound IP must match the address you registered at onboarding. The X-Marbles-Signature header is not verified on these requests. See Security for the full picture (and the signature flow that applies to our outbound callbacks).