---
title: "Admin Economics"
method: GET
path: "/v1/admin/economics"
---

# Admin Economics

`GET /v1/admin/economics`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/admin/economics`
- Auth: none declared

Returns platform-wide cost vs revenue for the trailing window.

``totals`` reports ACTUALS ONLY (2026-07-16 revenue-accuracy fix —
modeled numbers must never masquerade as actuals):

  Cost    = sum(render_jobs.cost_micros) for completed jobs in window
  Revenue = settled ``embedder_revenue_events`` rollup (money that
            actually credited an embedder balance) + settled x402
            receipts (``x402_payments``), both on the same window
  Margin  = Revenue - Cost

``plays.ad_revenue_micros`` is deliberately NOT read here: the
column has no writer anywhere, so summing it always yields $0 —
real ad / affiliate money lands in ``embedder_revenue_events``.

The modeled Plus-ARPU projection (plus_listens × the $0.05
``plus_subscriber`` benchmark) lives under
``assumptions.modeled.plus_arpu_usd`` and is EXCLUDED from
``totals.total_revenue_usd`` / ``totals.margin_usd``. Field names
are kept for FE compatibility; only the semantics were corrected
(pre-fix responses summed the modeled term into both totals and
read ad revenue from the always-zero plays column).

Per-publisher breakdown shows cost-per-publisher so the operator
can see which publishers cost the most to render. Forward-looking
projections use ``app.economics.REVENUE_DEFAULTS_MICROS_PER_LISTEN``
as the unit value and live under ``assumptions``.

## Query parameters

- `days` integer

## Headers

- `x-storyflo-email-token` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)