Stats

Stats represent aggregated activity for an account over time. They help you understand revenue, transactions, disputes, members, referrals, and advertising performance across reporting periods like days, weeks, or months. Use the Stats API to list available metrics and their filterable properties, then retrieve time-series values for a date range.

Endpoints

Endpoint	Request
List Metrics	GET `/stats`
Retrieve Metric	GET `/stats/{metric}`

Metrics glossary

Every metric has a key that you pass as the {metric} path segment to Retrieve Metric. List Metrics returns the same catalog at runtime, with each metric’s unit and the properties you can filter or break down by. An unknown key returns a 404.

Units

Unit	How to read the value
`count`	An integer count.
`currency`	A decimal amount in the display currency (see `convert_to`), for example `4899.50`.
`percent`	A number where `1.6` means 1.6%, already scaled to percentage points rather than a `0`–`1` fraction.

Filtering and breaking down

Each property works two ways unless noted otherwise:

Filter — pass property=value to narrow the series to a single value, for example ?payment_method=card.
Break down — pass breakdown_by=property to split each point into one entry per value. For example, ?breakdown_by=currency returns an entry for usd, an entry for eur, and so on. One breakdown_by at a time.

Passing a property a metric does not list returns a 400.

Property	Values
`currency`	An ISO 4217 code, for example `usd` or `eur`. Reports the original transaction currency, not converted.
`payment_method`	`card` or `crypto`.
`card_network`	A card brand, for example `visa` or `mastercard`. A refinement of `payment_method=card` — only valid alongside it.
`dispute_reason`	A provider-normalized dispute reason such as `product_not_received`, `product_unacceptable`, `fraudulent`, or `credit_not_processed`. Use it on `snapshot_disputes`; clients can group remaining reason slugs into “Other” for display.
`product`	A product ID to scope the metric to a single product.
`fee_type`	A fee line type, for example `payment_processing_percentage_fee` (see the Ledger Activity fees glossary).
`status`	A membership status for New users, or an affiliate payment status for Partner metrics.
`access_level`	A member’s access level, for example `customer` (New users only).
`most_recent_action`	A member’s most recent lifecycle action (New users only).
`account_id`	A referred business ID (Partner metrics only).
`tier`	`first` or `second` (Partner metrics only).
`referred_user_id`	A referred user ID. Filter-only; it cannot be used with `breakdown_by` (Partner metrics only).
`event_name`	A tracked event name, for example `pixel.page` or `pixel.custom` (`events` only).
`custom_name`	The merchant-defined name of a custom event (`events` only). A refinement of `event_name=pixel.custom` — only valid alongside it, since no other event carries a custom name.

Query parameters

These apply to every metric on Retrieve Metric, independent of its properties:

Parameter	Description
`from`, `to`	Required. The date range (`YYYY-MM-DD`) to plot.
`interval`	Point width: `hour`, `day`, `week`, or `month`. Defaults to `day`.
`convert_to`	Display currency for money metrics — every amount is converted into this ISO currency at each period’s rate. Defaults to `usd`. Ignored when you filter or break down by `currency` (those report the original, unconverted currency).
`time_zone`	IANA time zone to bucket the series in, for example `America/New_York`. Defaults to `UTC`.
`breakdown_by`	Split each point out by one of the metric’s properties.
`snapshot_window`	Snapshot metrics only. Ordinary snapshots accept `30d` as their trailing activity window. Cohorted dispute metrics accept `7d` or `28d` as the sales-transaction pooling window; the attribution window is fixed in the metric name. Check the metric catalog’s `windows` array for the accepted values.

Revenue

Metric	Unit	Filters & breakdowns	Description
`net_revenue`	`currency`	—	Earnings kept after refunds, disputes, and all fees.
`gross_revenue`	`currency`	`payment_method`, `product`, `currency`	Gross earnings from sales and platform income, before refunds or fees.
`net_volume`	`currency`	—	Gross earnings minus Whop fees, before refunds and other deductions.
`gross_transaction_value`	`currency`	`currency`	Total value of completed sales (GMV), before refunds or fees.
`marketplace_revenue`	`currency`	`payment_method`, `product`, `currency`	Revenue from marketplace sales, excluding direct-to-consumer.
`churned_revenue`	`currency`	—	Recurring revenue lost from memberships whose MRR decreased over the period.
`total_refunded`	`currency`	`payment_method`, `product`, `currency`	Total amount refunded to buyers.
`monthly_recurring_revenue`	`currency`	`currency`	Monthly recurring revenue from active subscriptions.
`annual_recurring_revenue`	`currency`	`currency`	Annualized recurring revenue: MRR times twelve.
`average_revenue_per_user`	`currency`	`payment_method`, `product`, `currency`	Average revenue earned per paying user.
`average_revenue_per_subscription`	`currency`	`payment_method`, `product`, `currency`	Average revenue earned per active subscription.

Payments

Metric	Unit	Filters & breakdowns	Description
`successful_payments`	`count`	`payment_method`, `product`, `currency`	Successful payments received.

Fees

Every fee metric accepts a currency filter.

Metric	Unit	Filters & breakdowns	Description
`fees`	`currency`	`currency`, `fee_type`	All fees charged. Break down by `fee_type` to itemize them.
`payment_processing_fees`	`currency`	`currency`	Card, network, currency-conversion, billing, and payout fees.
`whop_processing_fees`	`currency`	`currency`	Whop’s processing fee on transactions.
`affiliate_fees`	`currency`	`currency`	Fees paid to affiliates on referred sales.
`marketplace_fees`	`currency`	`currency`	Affiliate fees on marketplace sales.
`dispute_fees`	`currency`	`currency`	Fees charged for disputes and dispute alerts.
`sales_tax_withheld`	`currency`	`currency`	Sales tax withheld and remitted.

Disputes & refunds

Metric	Unit	Filters & breakdowns	Description
`disputes`	`count`	—	Disputes opened against the account.
`dispute_alerts`	`count`	—	Early-warning dispute alerts received on the account’s payments.
`dispute_rate`	`percent`	`payment_method`	Share of paid receipts with a dispute.
`refund_rate`	`percent`	`payment_method`	Share of paid receipts refunded.

Authorizations

Metric	Unit	Filters & breakdowns	Description
`auth_rate`	`percent`	—	Share of decided card authorizations that were approved.

Members & users

Metric	Unit	Filters & breakdowns	Description
`new_users`	`count`	`status`, `access_level`, `most_recent_action`, `product`	Users who joined.
`users_growth`	`count`	—	Active members over time.
`paid_active_members`	`count`	—	Active paying members.
`churn_rate`	`percent`	—	Share of paying members who canceled.
`trial_conversion_rate`	`percent`	—	Share of trials that converted to paid.

Partners

Metric	Unit	Filters & breakdowns	Description
`partner_earnings`	`currency`	`status`, `account_id`, `tier`; `referred_user_id` is filter-only	Commissions earned from referred businesses across both partner tiers.
`partner_volume`	`currency`	`status`, `account_id`, `tier`; `referred_user_id` is filter-only	Sales volume generated by referred businesses across both partner tiers.

Advertising & traffic

Metric	Unit	Filters & breakdowns	Description
`ad_spend`	`currency`	—	Total advertising spend across the account’s ad campaigns.
`page_visits`	`count`	—	Store page views for the account.
`events`	`count`	`event_name`, `custom_name`	Tracked pixel events for the account, excluding crawler traffic. Break down by `event_name` for per-event counts.

Snapshot metrics

Snapshot metrics are captured once per day and preserve what was known at that time. They are day-only and UTC-only: interval must be day and time_zone is not accepted. You still pass from and to to choose the range of daily points. Use each metric’s windows catalog field to determine which snapshot_window values it accepts.

Metric	Unit	`snapshot_window`	Filters & breakdowns	Description
`snapshot_receipts`	`count`	`30d`	`card_network`, `payment_method`	Paid receipts in the trailing 30 days.
`snapshot_refunds`	`count`	`30d`	—	Refunds issued in the trailing 30 days.
`snapshot_refund_rate`	`percent`	`30d`	—	Share of trailing-30-day paid receipts refunded.
`snapshot_disputes`	`count`	`30d`	`card_network`, `payment_method`, `dispute_reason`	Non-RDR disputes filed in the trailing 30 days. Break down by normalized reason to build a dispute-composition chart.
`snapshot_dispute_rate`	`percent`	`30d`	`card_network`, `payment_method`	Disputes filed in the trailing 30 days divided by paid receipts in that window.
`snapshot_cohorted_dispute_rate_7d_attr`	`percent`	`7d`, `28d`	`card_network`, `payment_method`	Share of the latest mature sales cohort disputed within 7 days of purchase.
`snapshot_cohorted_dispute_rate_14d_attr`	`percent`	`7d`, `28d`	`card_network`, `payment_method`	Share of the latest mature sales cohort disputed within 14 days.
`snapshot_cohorted_dispute_rate_28d_attr`	`percent`	`7d`, `28d`	`card_network`, `payment_method`	Share of the latest mature sales cohort disputed within 28 days.
`snapshot_resolution_center_cases`	`count`	`30d`	—	Resolution center cases opened in the trailing 30 days.
`snapshot_resolution_center_case_rate`	`percent`	`30d`	—	Trailing-30-day resolution center cases divided by paid receipts.
`snapshot_approved_authorizations`	`count`	`30d`	—	Card authorizations approved in the trailing 30 days.
`snapshot_decided_authorizations`	`count`	`30d`	—	Card authorizations approved or declined in the trailing 30 days.
`snapshot_auth_rate`	`percent`	`30d`	—	Trailing-30-day approved authorizations divided by decided authorizations.

Cohorted dispute snapshots

Cohorted metrics attribute each dispute to the date of its original paid receipt. The attribution window in the metric name answers “how long after purchase can a dispute count?” The snapshot_window answers a separate question: “how many consecutive days of sales are pooled into this point?” Use 7d for a more reactive series or 28d for a smoother denominator. Each captured point uses the latest sales cohort whose complete attribution window has elapsed. For a snapshot captured on date D, its cohort ends on D - attribution days - 1 day; the extra day ensures the final attribution day is complete. To reproduce a cohort-end-date chart, plot each point on that inferred cohort end date. Comparing 7d, 14d, and 28d attribution values at the same raw API timestamp compares different mature cohorts; align them by cohort end date before expecting 7d ≤ 14d ≤ 28d.

Introduction

Reference

Core Resources

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Endpoints

Metrics glossary

Units

Filtering and breaking down

Query parameters

Revenue

Payments

Fees

Disputes & refunds

Authorizations

Members & users

Partners

Advertising & traffic

Snapshot metrics

Cohorted dispute snapshots

​Endpoints

​Metrics glossary

​Units

​Filtering and breaking down

​Query parameters

​Revenue

​Payments

​Fees

​Disputes & refunds

​Authorizations

​Members & users

​Partners

​Advertising & traffic

​Snapshot metrics

​Cohorted dispute snapshots

Endpoints

Metrics glossary

Units

Filtering and breaking down

Query parameters

Revenue

Payments

Fees

Disputes & refunds

Authorizations

Members & users

Partners

Advertising & traffic

Snapshot metrics

Cohorted dispute snapshots