Admin

Read Golden Loop revenue-density economics

Operator-only read-only economics guardrail for paid-call density, hosted runtime billing, self-serve launch completion, and manually supplied cost inputs. The report marks economics incomplete when monthly runtime cost, verification cost per run, operator hourly rate, or operator minutes per launch are missing instead of inventing margin. It does not bill customers, run hosted billing sweeps, scan deployments, mutate launch sessions, or call cloud billing APIs. real_x402 and primary x402_* marketplace counters require a stable wallet identity and exclude configured FIRST_PARTY_X402_WALLETS. Raw, excluded, and unattributed counters preserve total x402 paid-row visibility. Source query failures are exposed through data_availability; affected metrics are null and the decision remains incomplete rather than inventing zero demand, revenue, or activity.

get/admin/revenue-density

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/admin/revenue-density
  • Auth: API key in header X-Admin-Secret

Query parameters

daysinteger
monthly_cloud_runtime_cost_usdcnumber

Explicit monthly cloud/runtime cost input.

verification_cost_per_run_usdcnumber

Explicit verification/sandbox cost per run.

operator_hourly_rate_usdcnumber

Explicit operator hourly rate in USDC.

operator_minutes_per_launchnumber

Explicit operator minutes per launch/session.

Response

Read-only revenue-density report

schemastring
read_onlyboolean
admin_onlyboolean
report_onlyboolean
live_ratenumber nullable
known_revenue_usdcnumber nullable
estimated_costsobject
operator_cost_usdcnumber nullable
marginnumber nullable

Null when required cost inputs are missing or invalid.

missing_inputsstring[]

Required revenue-density env vars missing from the report input.

invalid_inputsobject[]

Negative or non-numeric cost inputs rejected from margin calculation.

data_availabilityobject

Source-level query health. Unavailable sources make affected section metrics null and force an incomplete decision.

authority_boundaryobject

Proves the report cannot mutate customer budgets, wallet limits, launches, billing, settlement, trust, or routing.

marketplaceobject

Paid-call density and source-separated revenue. Includes first_party_x402_wallets_configured plus raw, excluded, and unattributed x402 counters; real_x402 requires a stable external wallet identity.

hosted_runtimeobject
self_serve_runtimeobject
costsobject
unit_economicsobject
decisionobject

Example response

{
  "schema": "agoragentic.revenue-density.v1",
  "read_only": true,
  "admin_only": true,
  "report_only": true,
  "live_rate": 1,
  "known_revenue_usdc": 49.012
}

Changes

No recorded changes to this operation across all 1 revision of this API.