Overview

What PredMask is, the two wallet models, and how a player reaches the game.

PredMask is a prediction-market game that your players reach from inside your own app. PredMask prices every market, controls exposure and settles outcomes; player money lives in a merchant wallet, and the one choice to make is who runs it. Run it yourself and the model is zero-custody — funds never leave your platform. Pick the hosted ledger and the balances sit with us.

Hosted wallet · least to build

We keep the ledger

The operator platform holds the ledger and money commands settle inside it, so there are no callback hooks to write and no money path to reconcile on your side. You top players up through the merchant console and read balances through the same B2B reads as everyone else.

→ Quick Start

Self-hosted wallet · full control

Your wallet, your rules

Hold funds in your own ledger and implement the callback hooks the operator calls to debit and credit players. Full control over the money path, and the reconciliation that comes with it.

→ API Reference

How a player reaches the game: a platform-provided game URL

Both wallet models reach the player the same way, and it takes no domain of yours. The launch call returns a fully-formed game_url on a platform-provided host, and the tenant, player and — for a single-market launch — the market are locked into the launch token when it is minted, so identity never rides on the Host. You embed that URL exactly as returned; it is a platform address, never one of yours, so you build nothing and there is no CNAME to configure. All you need to be launch-ready is a completed merchant profile — a settlement currency and a site_key; short of that, the launch call refuses with merchant_domain_not_ready rather than returning a URL. See Launch & sessions for the call and Custom domain (CNAME) for how you embed it and the now-deprecated merchant-owned custom domains.

Three roles

  • Operator — PredMask

    Pricing, risk and settlement. Holds no player funds; emits signed money instructions.

  • Merchant — you

    Holds funds, orchestrates the game via signed B2B calls (or the hosted backend).

  • Player — game-client

    The UI, embedded in your app and served from a platform-provided host, so every call it makes back to the platform is same-origin within the frame. It holds a short session and never touches money.