GhostPlay API

Run your live-service game economy through GhostPlay's economy verification runtime, inject economic stress tests, and receive a severity-rated economy findings report — all via REST.

GhostPlay runs 5,000 deterministic parametric personas through your game economy for 360 simulated days at 50× real-time speed. Agents operate via scripted Behavior Trees — fully deterministic, producing zero-variance results across identical seed runs. Three stress vectors inject at Day 180. At the end, every Systemic Asset Class is evaluated against a ≤5% MAPE accuracy gate. The result is a severity-rated findings report — a per-class economy-health read — delivered as a PDF.

The API is JSON over HTTPS. Authentication is via a per-customer API key passed as a request header. All audit jobs are scoped to the key that created them — customer data is fully isolated.

Authentication

Protected endpoints require an X-API-Key header. API keys are issued per customer by the GhostPlay team — there is no self-serve key generation. Keys follow the format sk_prod_<customer>_<random>.

# Include with every authenticated request
curl https://api.ghostplay.tech/api/v1/audits \
  -H "X-API-Key: sk_prod_acme_xxxxxxxxxxxx"

Quickstart

Submit an audit, poll for completion, and download the report in three steps.

curl -X POST https://api.ghostplay.tech/api/v1/audits \
  -H "X-API-Key: sk_prod_acme_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"game_name":"MyGame v2.1"}'

# Response
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "sla_hours": 48,
  "next_check": "/api/v1/audits/550e8400-..."
}

curl https://api.ghostplay.tech/api/v1/audits/550e8400-... \
  -H "X-API-Key: sk_prod_acme_xxxx"

# Response when complete
{
  "job_id": "550e8400-...",
  "status": "completed",
  "created_at": "2026-05-29T10:00:00Z",
  "completed_at": "2026-05-29T20:14:00Z"
}

curl https://api.ghostplay.tech/api/v1/audits/550e8400-.../report \
  -H "X-API-Key: sk_prod_acme_xxxx"

# Response
{
  "job_id": "550e8400-...",
  "report_url": "https://storage.ghostplay.tech/reports/...",
  "expires_at": "2026-06-28T20:14:00Z"
}

Endpoints

{
  "status": "ok"
}

{
  "job_id": "uuid",
  "status": "queued",
  "sla_hours": 48,
  "next_check": "/api/v1/audits/{job_id}"
}

{
  "customer_id": "your_studio",
  "total_audits": 3,
  "audits": [
    {
      "job_id": "uuid",
      "status": "completed",
      "created_at": "2026-05-29T10:00:00Z",
      "completed_at": "2026-05-29T20:14:00Z"
    }
  ]
}

{
  "job_id": "uuid",
  "status": "queued" | "running" | "completed" | "failed",
  "created_at": "ISO 8601",
  "started_at": "ISO 8601 or null",
  "completed_at": "ISO 8601 or null",
  "error_message": "string or null",
  "economy_mbr": "float or null" // Mint-to-Burn Ratio (baseline),
  "economy_health": "healthy" | "collapse_risk" or null
}

{
  "job_id": "uuid",
  "report_url": "https://...",
  "expires_at": "ISO 8601"
}

Job lifecycle

Audit jobs move through four states. Poll GET /api/v1/audits/{job_id} to track progress. We recommend polling every 30 minutes — the simulation runs for up to 48 hours.

Error codes

How verification works

GhostPlay uses a headless Unreal Engine 5 runtime to run your game economy through a deterministic verification process — the same engine your game runs on, no approximations or proxies.

Stress vectors

Three deterministic shocks inject at Day 180 — the Major Expansion window used by all major live-service titles. They model the three highest-consequence economic failure modes in the industry.

MAPE accuracy gate

GhostPlay validates your economy model's predictive accuracy using Mean Absolute Percentage Error (MAPE). The gate is ≤5% per Systemic Asset Class — independently. There is no averaging across classes and no fallback.

MAPE is computed against the Control Baseline: the frozen telemetry from Days 1–180 pre-shock. Post-shock telemetry (Days 180–360) is evaluated against model predictions. A MAPE above 5% means your economy model cannot predict its own behaviour under stress — a reliable predictor of post-launch instability.

The 5% gate is immutable. It cannot be relaxed for a specific audit or client. This ensures the findings report carries genuine analytical weight with publishers, investors, and acquirers.

Systemic Asset Classes

GhostPlay validates four Systemic Asset Classes — the four dimensions along which live-service economies structurally fail. Each must independently pass the ≤5% MAPE gate.

FAQ

Get an API key

GhostPlay is in private beta. API keys are issued to studios with a signed pilot agreement. To get started:

1. Email alexander@ghostplay.tech with your studio name and the title you want to validate
2. We'll schedule a 30-minute scoping call
3. Sign the pilot agreement and schedule your integration call
4. Receive your API key and integration guide within 24 hours