Sessions API

Sessions link a user wallet, chosen token, and your game. Use the user's JWT for creation. Providers can query session details with API key.

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

Create Session (JWT)

POST /v1/sessions
Authorization: Bearer <jwt>
{
  "token_id": "<UUID>",
  "game_id": "<UUID>"
}

Response 200:

{ "session_id": "<UUID>" }

GET /v1/providers/sessions/{session_id}
Authorization: Bearer <api_key>

Returns wallet, provider, game, and balance details (available, locked, on-chain) plus token metadata.