Overview

KINGSTONE is a B2B partner API that provides a pre-computed deterministic gaming engine. Every game outcome is calculated ahead of time from licensed PAR (Probability Accounting Report) sheets. There is zero randomness at play-time, which means every outcome is fully auditable and reproducible.

How the B2B Model Works

KINGSTONE operates as a backend math engine. Partners build their own player-facing applications (web, mobile, or native), and KINGSTONE handles all of the outcome math, audit trails, and compliance reporting behind the scenes.

What Partners Provide

• Game visuals — Your frontend renders the slot machine, reel animations, and win celebrations. KINGSTONE gives you the data (symbol combinations, animation hints), and you bring it to life however you want.
• Player accounts — You manage your own player database. KINGSTONE maps your player IDs to internal accounts automatically on the first spin.
• Payment processing — You handle deposits, withdrawals, and real-money transactions with your own payment provider. KINGSTONE tracks balances in USD but does not move money.
• Regulatory licensing — You hold the operating license for your jurisdiction. KINGSTONE provides the mathematical compliance data you need for regulators.

What KINGSTONE Provides

• Patented math engine — Outcomes are pre-computed using a stride-based interleaving algorithm from licensed PAR sheets. No RNG at play-time.
• Pre-computed outcome queues — Thousands of outcomes are generated in advance and sealed with SHA-256 integrity hashes. When a player spins, the next outcome in the queue is served instantly.
• Presentation selection — For each outcome, KINGSTONE selects a visual symbol combination weighted by the PAR sheet. This is the only random element, and it has zero effect on payouts.
• Audit trails — Every spin creates a SHA-256 hash-chained audit record. You can verify the entire chain at any time through the API.
• Settlement reports — Daily reconciliation reports are generated automatically at 02:00 UTC. You compare against your own records, then acknowledge or dispute.
• RTP compliance — Track certified vs. actual Return-to-Player percentages per game, with downloadable compliance certificates.

The Spin Flow

When a player taps "Spin" in your app, this is what happens:

1. Your server sends a POST /api/partner/v1/spin request with the game ID, your player ID, and the wager amount in USD.
2. KINGSTONE looks up the next pre-computed outcome from the queue, selects a visual presentation, records the session in the audit log, and returns the result.
3. Your server receives the response containing the prize tier, payout amount in USD, reel symbols, and animation hints.
4. Your frontend uses the response data to animate the reels and show the result.

The entire flow is synchronous. The spin response includes the payout amount, so your server knows immediately whether (and how much) to credit the player.

Key Concepts

Concept	Description
PAR Sheet	A probability accounting report defining all symbol combinations, their probabilities, and payouts for a game. You upload these through the API.
Game Configuration	A registered game linked to a PAR sheet, with partner-specific wager limits (min, max, increment).
Outcome Queue	A pre-computed sequence of outcomes generated from a PAR sheet. Each position has a fixed prize tier and payout multiplier.
SPP (Sequence Position Pointer)	The pointer that tracks which outcome comes next. Advances by exactly 1 per spin.
Prize Tier	A classification of outcome value: T0 (no win) through T6 (jackpot). Each tier has a fixed payout multiplier.
Settlement Report	A daily reconciliation document showing total spins, wagers, payouts, and net position per game.

Next Steps

1. Set up authentication with your API key
2. Explore the sandbox for risk-free testing
3. Follow the quick start to execute your first spin