{ "openapi": "3.1.0", "info": { "title": "WOLF GAMING API Gateway", "version": "0.1.0", "description": "Quotation-derived standalone gateway foundation. Live providers and seamless-wallet transport await activation; no live game capabilities are claimed." }, "servers": [ { "url": "https://gateway.wolfgaming.online" } ], "security": [ { "ClientKey": [] } ], "paths": { "/v1/products": { "get": { "summary": "List quoted product schedule", "operationId": "get_v1_products", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Products" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/games": { "get": { "summary": "List enabled games (empty until adapters activate)", "operationId": "get_v1_games", "parameters": [ { "name": "product_code", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 1000000, "default": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Games" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/players": { "post": { "summary": "Map a client player", "operationId": "post_v1_players", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{8,128}$" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Player" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlayerRequest" } } } } } }, "/v1/sessions/launch": { "post": { "summary": "Launch game (activation required)", "operationId": "post_v1_sessions_launch", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Launch" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LaunchRequest" } } } }, "description": "Reserved activation contract; current deployment returns 503, not a successful response. Provider-specific fields require source validation." } }, "/v1/players/{playerId}/balance": { "get": { "summary": "Read client wallet (activation required)", "operationId": "get_v1_players_playerId_balance", "parameters": [ { "name": "playerId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Balance" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "description": "Reserved activation contract; current deployment returns 503, not a successful response. Provider-specific fields require source validation." } }, "/v1/transactions": { "get": { "summary": "Search client transactions", "operationId": "get_v1_transactions", "parameters": [ { "name": "player_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "product_code", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "round_id", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 1000000, "default": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Transactions" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/transactions/{transactionId}": { "get": { "summary": "Read transaction outcome", "operationId": "get_v1_transactions_transactionId", "parameters": [ { "name": "transactionId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Transaction" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/rounds/{roundId}": { "get": { "summary": "Read round transactions", "operationId": "get_v1_rounds_roundId", "parameters": [ { "name": "roundId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 1000000, "default": 0 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Transactions" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/health": { "get": { "summary": "Gateway health", "operationId": "get_v1_health", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Client request budget exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider or wallet capability not activated", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [] } } }, "components": { "securitySchemes": { "ClientKey": { "type": "http", "scheme": "bearer" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "correlation_id": { "type": "string" } }, "required": [ "code", "message", "correlation_id" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false }, "PlayerRequest": { "type": "object", "properties": { "player_reference": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{1,100}$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "player_reference", "currency" ], "additionalProperties": false }, "Player": { "type": "object", "properties": { "player_id": { "type": "string", "format": "uuid" }, "player_reference": { "type": "string" }, "currency": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "player_id", "player_reference", "currency", "created_at" ], "additionalProperties": false }, "Product": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "category": { "type": "string" }, "source": { "type": "string" }, "enabled": { "type": "boolean" }, "availability": { "type": "string", "enum": [ "activation_required" ] }, "currencies": { "type": "array", "items": { "type": "string" } }, "capabilities": { "type": "object", "properties": { "catalogue": { "type": "boolean" }, "launch": { "type": "boolean" }, "wallet": { "type": "boolean" } }, "required": [ "catalogue", "launch", "wallet" ], "additionalProperties": false }, "client_entitled": { "type": "boolean" } }, "required": [ "code", "name", "category", "source", "enabled", "availability", "currencies", "capabilities", "client_entitled" ], "additionalProperties": false }, "Products": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Product" } }, "total": { "type": "integer", "minimum": 0 } }, "required": [ "data", "total" ], "additionalProperties": false }, "Game": { "type": "object", "properties": { "game_id": { "type": "string" }, "product_code": { "type": "string" }, "name": { "type": "string" }, "category": { "type": "string" }, "currencies": { "type": "array", "items": { "type": "string" } } }, "required": [ "game_id", "product_code", "name", "category", "currencies" ], "additionalProperties": false }, "LaunchRequest": { "type": "object", "properties": { "player_id": { "type": "string", "format": "uuid" }, "product_code": { "type": "string" }, "game_id": { "type": "string" }, "locale": { "type": "string" } }, "required": [ "player_id", "product_code" ], "additionalProperties": false }, "Launch": { "type": "object", "properties": { "session_id": { "type": "string" }, "launch_url": { "type": "string", "format": "uri" }, "expires_at": { "type": "string", "format": "date-time" } }, "required": [ "session_id", "launch_url", "expires_at" ], "additionalProperties": false }, "Balance": { "type": "object", "properties": { "player_id": { "type": "string" }, "currency": { "type": "string" }, "balance": { "type": "string", "pattern": "^[0-9]{1,18}(\\.[0-9]{1,8})?$", "description": "Exact decimal string at the agreed currency precision." } }, "required": [ "player_id", "currency", "balance" ], "additionalProperties": false }, "Health": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ok" ] } }, "required": [ "status" ], "additionalProperties": false }, "Transaction": { "type": "object", "properties": { "id": { "type": "string" }, "player_id": { "type": "string" }, "product_code": { "type": "string" }, "game_id": { "type": [ "string", "null" ] }, "currency": { "type": "string" }, "amount": { "type": "string", "pattern": "^[0-9]{1,18}(\\.[0-9]{1,8})?$", "description": "Exact decimal string at the agreed currency precision." }, "event_type": { "type": "string", "enum": [ "bet", "win", "settlement", "rollback" ] }, "original_transaction_id": { "type": [ "string", "null" ] }, "round_id": { "type": "string" }, "correlation_id": { "type": "string" }, "status": { "type": "string", "enum": [ "pending", "successful", "rejected", "uncertain" ] }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "history": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string" }, "recorded_at": { "type": "string", "format": "date-time" } }, "required": [ "status", "recorded_at" ], "additionalProperties": false } } }, "required": [ "id", "player_id", "product_code", "game_id", "currency", "amount", "event_type", "original_transaction_id", "round_id", "correlation_id", "status", "created_at", "updated_at", "history" ], "additionalProperties": false }, "Games": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Game" } }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 }, "offset": { "type": "integer", "minimum": 0 } }, "required": [ "data", "total", "limit", "offset" ], "additionalProperties": false }, "Transactions": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Transaction" } }, "total": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 }, "offset": { "type": "integer", "minimum": 0 } }, "required": [ "data", "total", "limit", "offset" ], "additionalProperties": false }, "WalletEvent": { "type": "object", "properties": { "transaction_id": { "type": "string" }, "player_id": { "type": "string" }, "product_code": { "type": "string" }, "game_id": { "type": "string" }, "currency": { "type": "string" }, "amount": { "type": "string", "pattern": "^[0-9]{1,18}(\\.[0-9]{1,8})?$", "description": "Exact decimal string at the agreed currency precision." }, "event_type": { "type": "string", "enum": [ "bet", "win", "settlement", "rollback" ] }, "round_id": { "type": "string" }, "original_transaction_id": { "type": "string" } }, "required": [ "transaction_id", "player_id", "product_code", "game_id", "currency", "amount", "event_type", "round_id" ], "additionalProperties": false }, "WalletOutcome": { "type": "object", "properties": { "transaction_id": { "type": "string" }, "status": { "type": "string", "enum": [ "successful", "rejected" ] } }, "required": [ "transaction_id", "status" ], "additionalProperties": false } } } }