Operator API Endpoints
Overview
API endpoints that operators can call to Phoenix Games
The Operator Gateway provides a secure API for operators to interact with the Phoenix Games platform. All protected endpoints require authentication via operator ID and signature verification.
Base URL
The Operator API base URL depends on your assigned region (given at registration). Each region is data-isolated - calling another region's host will not find your operator or bets.
| Region | Production | Staging |
|---|---|---|
| EU (default) | https://operators.phoenixbet.io | https://operators.staging.phoenixbet.io |
South Africa (af-south) | https://sa.operators.phoenixbet.io | https://sa.operators.staging.phoenixbet.io |
Use the host for the region Phoenix assigned to your operator, and staging for development/testing before production.
API Version
Current version: v0.2
Authentication
All protected endpoints require the following headers:
| Header | Type | Required | Description |
|---|---|---|---|
X-Operator-Id | string | Yes | Unique identifier for the operator |
X-Signature | string | Yes | Base64 URL-safe encoded RSA signature |
Signature Verification
- The data to sign varies by endpoint (see individual endpoint documentation)
- The value is signed using RSA-SHA256 with the operator's private key
- The signature is Base64 URL-safe encoded (no padding)
- The server verifies the signature using the operator's registered public key