Overview

Phoenix Prediction lets an operator offer prediction markets inside its own product without building the market UI, pricing, settlement, and admin tooling from scratch.

The fastest integration path is the hosted iframe. Your site launches the iframe with a short-lived token, and Phoenix handles market browsing, market details, charts, buy flow, positions, activity, comments, and settlement display.

What You Own

You keep control of the player relationship and account system:

• Player login, registration, KYC, profile, and account settings
• Cashier, deposits, withdrawals, and full wallet history
• Your wallet ledger and player balances
• The server-side signing key used to mint Phoenix Prediction launch tokens
• The wallet endpoints Phoenix calls when a player buys or settles a prediction

What Phoenix Owns

Phoenix provides the prediction-market surface:

• Hosted iframe UI
• Market catalog, topics, search, and market detail pages
• Market pricing, quotes, and trade placement
• Position and activity views
• Comments and leaderboard when enabled
• Admin configuration for embed experiences
• Signed wallet debit, credit, and rollback calls to your backend

Main Integration Flow

Player opens your page
  -> your backend mints a visitor or player JWT
  -> your page embeds the Phoenix Prediction iframe
  -> Phoenix validates the token and loads the configured experience
  -> player places a prediction
  -> Phoenix calls your debit endpoint
  -> market resolves
  -> Phoenix calls your credit endpoint for settlement

Documentation Map

Start with Getting Started for the full checklist.

• Embed Launch: how to place the iframe on your site
• Launch Tokens: visitor and player JWT claims
• Parent Bridge: login, deposit, resize, and token refresh events
• Wallet Callbacks: endpoints your backend must implement
• Security: signature verification and idempotency requirements
• Reconciliation: match wallet callbacks to your ledger
• Operator API: optional signed REST API for market operations
• Operator Guides: practical runbooks for market lifecycle, risk, resolution, and settlement