Skip to main content

Multiplayer Match API

JWT endpoints are used by players; Provider endpoints control match lifecycle.

Base URL (staging): https://mcap-api-564778804231.us-east4.run.app

Create Match (JWT)​

POST /v1/user/multiplayer-bets/matches
Authorization: Bearer <jwt>
{
  "creator_id": "<wallet UUID>",
  "max_players": 2,
  "wager": "1000000000000000000",
  "game_type": "chess",
  "session_id": "<UUID>"
}

Join Match (JWT)​

POST /v1/user/multiplayer-bets/matches/{match_id}/join
Authorization: Bearer <jwt>
{
  "player_id": "<wallet UUID>",
  "session_id": "<UUID>"
}

Start Match (Provider)​

POST /v1/providers/multiplayer-bets/matches/{match_id}/start
Authorization: Bearer <api_key>
{}

Settle Match (Provider)​

POST /v1/providers/multiplayer-bets/matches/{match_id}/settle
Authorization: Bearer <api_key>
{
  "payouts": [ { "player_id": "<UUID>", "amount": "..." } ]
}

Cancel Match (Provider)​

POST /v1/providers/multiplayer-bets/matches/{match_id}/cancel
Authorization: Bearer <api_key>
{
  "reason": "..."
}