{"openapi":"3.0.3","info":{"title":"SkillSpins Public API","version":"1.0.0","description":"Server-authoritative skill-game API. Virtual credits only. Real-money payment processing is not available. Send X-Api-Key. Wallet changes and game math run on the server."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}}},"security":[{"apiKey":[]}],"paths":{"/openapi.json":{"get":{"summary":"This document","security":[],"responses":{"200":{"description":"OpenAPI JSON"}}}},"/game/config":{"get":{"summary":"Effective paytable for the key owner's state","description":"Scope read:game. Returns RTP target, scale, and stake-scaled symbol pays.","responses":{"200":{"description":"Game config"}}}},"/leaderboard":{"get":{"summary":"Skill rating leaderboard","description":"Scope read:leaderboard.","responses":{"200":{"description":"Players"}}}},"/wallet":{"get":{"summary":"Key owner's virtual wallet","description":"Scope read:wallet.","responses":{"200":{"description":"Balance and ledger"}}}},"/rounds":{"get":{"summary":"Recent rounds for the key owner","description":"Scope read:game.","responses":{"200":{"description":"Rounds"}}}},"/game/spin":{"post":{"summary":"Deal a 5x5 round","description":"Scope write:game. Debits the stake. Body: { stake, idempotencyKey?, lat?, lng? }.","responses":{"200":{"description":"Pending round"}}}},"/game/resolve":{"post":{"summary":"Lock wild placement and fifth-tile symbol","description":"Scope write:game. Body: { roundId, wildIndex, skillSymbol }. Server scores and credits the wallet.","responses":{"200":{"description":"Resolved round"}}}},"/webhooks":{"get":{"summary":"List webhook endpoints","description":"Scope write:webhooks.","responses":{"200":{"description":"Endpoints"}}},"post":{"summary":"Create a webhook","description":"Scope write:webhooks. Body: { url, events }. Events: round.completed, bonus.completed. Signature header x-skillspins-signature is hex HMAC-SHA256 of the raw body.","responses":{"200":{"description":"Endpoint and secret"}}}}}}