Phoenix Prediction Docs

Overview

When to use the signed Operator API

Most operators can run Phoenix Prediction through the hosted iframe and admin dashboard. The Operator API is available when your backend needs direct, signed access to operator-scoped market data and actions.

The base path is:

https://prediction.phoenixverse.io/operator/api

Every request is scoped to the authenticated operator. You cannot read or mutate another operator's data through this API.

Available Areas

AreaEndpoints
StatsRead operator summary statistics
SettingsRead and update tenant-scoped settings such as the fee schedule
CategoriesRead active categories for the authenticated operator environment

OpenAPI is available from:

https://prediction.phoenixverse.io/openapi.json

The Redoc UI is available from:

https://prediction.phoenixverse.io/docs

Authentication

The Operator API uses Ed25519 request signatures. It does not use shared secrets.

Required headers:

X-Operator-Code: acme
X-Operator-Environment: sandbox
X-Signature-Timestamp: 1779100000
X-Signature: base64url-ed25519-signature

See Request Signing for the canonical payload.