by Unity Nodes
Partner docsapi reference › admin › get revenue density percentiles admin only

NEAR AI Cloud: Get revenue density percentiles (Admin only)

Updated 13-11-2026

View on Partner docs

GET /v1/admin/platform/revenue-density Get revenue density percentiles (Admin only) Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Buckets usage into 1-minute windows, computes revenue/second per bucket, then returns P50/P95/P99/peak over active buckets — platform-wide and per model. Use the annualized figures to estimate potential revenue if a given demand rate were sustained continuously.

Reads raw usage at minute grain over the exact requested range, under a 120 s statement budget.

Admin permissions: admin session, read_write token, or read_only token. Approved read across organizations; does not mutate business state.

Parameters:

  • start (query, string): Start of time range (ISO 8601). Defaults to 30 days ago. Window may not exceed 90 days.
  • end (query, string): End of time range (ISO 8601). Defaults to now. Window may not exceed 90 days.
  • provider_type (query, string): Filter by provider type (vllm, external, chutes, or tinfoil).

Responses: 200: Revenue density retrieved successfully

  • active_minutes (integer, int64, required): Buckets with any revenue > 0.
  • by_model (array of object, required): Per-model breakdown, sorted by total consumed cost DESC.
    • active_minutes (integer, int64, required): Number of 1-minute buckets with revenue > 0 in the period.
    • model_name (string, required)
    • p50_usd_per_min (number, double, required): P50 revenue rate during active minutes, USD/min.
    • p95_usd_per_min (number, double, required): P95 revenue rate during active minutes, USD/min.
    • p99_annualized_usd (number, double, required): Annualized revenue if p99 rate were constant: p99 × 60 × 24 × 365, USD.
    • p99_usd_per_min (number, double, required): P99 revenue rate during active minutes, USD/min.
    • peak_annualized_usd (number, double, required): Annualized revenue if peak rate were constant: peak × 60 × 24 × 365, USD.
    • peak_usd_per_min (number, double, required): Maximum observed revenue rate, USD/min.
  • p50_usd_per_min (number, double, required)
  • p95_usd_per_min (number, double, required)
  • p99_annualized_usd (number, double, required)
  • p99_usd_per_min (number, double, required)
  • peak_annualized_usd (number, double, required)
  • peak_usd_per_min (number, double, required)
  • period_end (string, date-time, required)
  • period_start (string, date-time, required)
  • sampled_minutes (integer, int64, required): Total 1-minute buckets sampled in the period. 400: Invalid request 401: Unauthorized 403: Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 500: Internal server error 504: Analytics statement budget exceeded
Back to Documentation