Skip to content

Getting started

Introduction

The Orrery direct-integration API: sessions, wallet, free bets, limits and public fairness checks.

Draft v0.1

This API belongs to our game server for direct operator integrations. It runs as a working demo; lab certification, supplier licensing and the seamless wallet are still open. Flip Flap on Engine does not use it: Engine runs the game through its own RGS.

Conventions#

Every endpoint returns an Ack: { "ok": true, "data": … } on success, { "ok": false, "code": "…", "message": "…" } on failure. The HTTP status mirrors the error code, so curl -f fails when the call fails.

Money is always an integer in minor units (amountMinor). Multipliers are integers times 100 (fields ending in X100). Ids are UUIDs.

Base URL#

Base URL
https://<api-host>/api

Integration in three calls#

  1. 1Create a player session with your operator key. You get a signed token.
  2. 2Fund the player’s game balance with a transfer (the seamless wallet is planned).
  3. 3Open the game with the token. The launch URL format is TBD until the URL builder ships.