> ## Documentation Index
> Fetch the complete documentation index at: https://lifters.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Financial Reports

> GGR, NGR, Hold %, Bonus Cost, transaction breakdowns and revenue analytics on the Atlas platform.

Financial Reports cover the revenue layer of the Atlas Analytics module —
GGR, NGR, Hold %, Bonus Cost % and transaction-level breakdowns by brand,
sport, casino bucket and time window. Powered by Transaction, Sports and
Casino events, with Gold tables aggregated daily in ClickHouse.

## Available Reports

### Revenue (live)

* **GGR (Gross Gaming Revenue)** — Stake minus winnings, broken down by sport,
  casino game, provider or time period.
* **NGR (Net Gaming Revenue)** — GGR after bonuses (`real_ggr + bonus_ggr`).
  Available for casino in
  [`/v1/analytics/casino/overview`](/guides/analytics/casino-analytics#overview).
* **Hold %** — Revenue retention `(GGR / Stake) × 100` per product/period.
* **Bonus Cost %** — `(-bonus_ggr) / real_ggr × 100`. Indicates how much of the
  real GGR was spent funding bonuses. Available in `/casino/overview`.
* **Bonus Liability** — Outstanding bonus balance across all players (planned
  for `/v1/financial/bonus-liability`).
* **Revenue by Brand** — Consolidated view across all brands.

### Transaction Reports (live)

* **Deposit Volume** — Totals + averages, payment method breakdown.
* **Withdrawal Volume** — Total payouts, pending/completed/failed mix.
* **First Time Depositors (FTD)** — Acquisition-to-deposit conversion.
* **Deposit/Withdrawal Ratio** — Player liquidity indicator.

### Bonus & Promotion Reports

* **Bonus Cost %** — Live (see above).
* **Bonus Conversion Rate** — Planned: % of bonus bets converting to
  real-money deposits.
* **Promotion ROI** — Planned: revenue impact of specific promotions.

## Endpoints

| Module    | Path                                                                                                 | Coverage                                                               |
| --------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Casino    | [`/v1/analytics/casino/overview`](/guides/analytics/casino-analytics#overview)                       | GGR, NGR, Hold %, Bonus Cost %, Stake, Rounds, Average Ticket, Players |
| Casino    | [`/v1/analytics/casino/channel-composition`](/guides/analytics/casino-analytics#channel-composition) | GGR/Stake/Hold by bucket (slots/live/tables/outros)                    |
| Casino    | [`/v1/analytics/casino/ggr-ngr-accumulated`](/guides/analytics/casino-analytics#ggr-ngr-accumulated) | Cumulative GGR/NGR daily series + M-1 baseline                         |
| Sport     | `/v1/analytics/sport/ggr`                                                                            | GGR by sport, tournament, market                                       |
| Financial | `/v1/financial/overview`                                                                             | Cross-product NGR composition + KPIs                                   |

## Data Prerequisites

Financial reports are powered by Transaction and Bet events. Ensure you're sending:

* `deposit` and `withdraw` events → [Tracking Transactions](/guides/events/tracking-transactions)
* sports `open`, `win`, `lose`, and `cashout` events → [Tracking Sports](/guides/events/tracking-sports)
* casino `open`, `win`, and `lose` events → [Tracking Casino](/guides/events/tracking-casino)

For Bonus Cost % to be meaningful, casino events must populate
`bet_amount_bonus` and `win_amount_bonus`. Operators that do not yet track
bonus payments will see `bonus_cost_pct = 0` and `ngr ≈ ggr`.

The more complete your event data, the more accurate your financial reports.