Overview
Integrate Phoenix Prediction into an operator product
Developer docs are for the team connecting Phoenix Prediction to an operator product.
The supported player integration is the hosted iframe. Your site owns identity, cashier, wallet ledger, page placement, and launch-token minting. Phoenix owns the prediction UI inside the frame.
Recommended Path
1. Integration checklist
Collect environment details, confirm the wallet contract, and validate the sandbox launch.
2. Sandbox and production
What belongs to sandbox and to production, what to send Phoenix, and the hosts and paths you use.
3. Request signing
Sign backend-to-Phoenix requests with the operator Ed25519 key.
4. Launch tokens
Mint visitor and player JWTs: operator, environment, currency, language, lifetime.
5. Wallet integration
Implement reserve, release, capture, credit, balance, and transaction status operations.
6. Iframe integration
Embed the hosted player experience, connect parent-page events, and keep sessions alive.
7. Customization
Set your look in the back office, override it per page, and choose per-player buttons.
8. Go live
The wallet test and everything to confirm before real players arrive.
What Your Product Owns
| Area | Operator responsibility |
|---|---|
| Player account | Login, registration, KYC, profile, account settings |
| Cashier | Deposits, withdrawals, wallet history, balance display |
| Token minting | Server-side Ed25519 signing for visitor and player launches, and fresh tokens when a session needs one |
| Parent page | Iframe placement, parent navigation, analytics, layout |
| Wallet ledger | Financial source of truth when funds move through your wallet |
What Phoenix Provides
| Area | Phoenix responsibility |
|---|---|
| Hosted iframe | Event feed, event pages, order ticket, portfolio, leaderboard, activity, comments, in your players' languages |
| Operator environments | Sandbox and production, each with its own keys, wallet, sites and books |
| Trading system | Yes/No markets, orders, positions, settlement |
| Back office | Your events and results, curation, players, trades, finance, staff and settings |
| Wallet operations | Signed reserve, release, capture, credit, balance, and transaction status calls |