Available datasets

The API provides access to multiple datasets covering the global gambling industry. The catalog endpoint returns the full list of available datasets programmatically; this page offers a guided overview.

Dataset structure

Each dataset comprises the following properties:

A name — the value passed as the metric query parameter (e.g. ggr_annual)
A granularity — either annual or monthly, determining the time dimension
Dimensions — categorical fields available for filtering (e.g. country, channel)
Metrics — numeric values included in each row (e.g. ggr, turnover)

Annual datasets include a year dimension (integer). Monthly datasets include a month_beginning dimension (date string, e.g. 2024-01-01).

Financial datasets

GGR (Gross Gaming Revenue)

Property	Annual	Monthly
metric	`ggr_annual`	`ggr`
Granularity	`annual`	`monthly`
Metrics	`ggr`	`ggr`

Dimensions: region, country, state, category, product, channel, sub_channel, fx, temporal, calculation

Gross Gaming Revenue represents the amount retained by operators after paying out winnings and is the primary measure of gambling industry revenue. The data covers global markets, broken down by betting/gaming category, product type, and distribution channel.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=ggr_annual&country=United+Kingdom&limit=10"

Turnover

Property	Value
metric	`turnover_annual`
Granularity	`annual`
Metrics	`turnover`

Dimensions: region, country, state, category, product, channel, sub_channel, fx, temporal, calculation

Total betting and gaming turnover (stakes and wagers) before operator deductions.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=turnover_annual&region=Europe&limit=10"

Property	Annual	Monthly
metric	`annual_market_share`	`monthly_market_share`
Granularity	`annual`	`monthly`
Metrics	`value`	`value`

Dimensions: region, country, state, channel, sub_channel, operator

Operator-level market share percentages, indicating how revenue is distributed across companies within each market.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=monthly_market_share&country=United+Kingdom&limit=10"

Reference datasets

FX rates

Property	Value
metric	`fx`
Granularity	`annual`
Metrics	`fx_constant_usd`, `fx_current_eur`, `fx_constant_eur`, `fx_current_usd`

Dimensions: region, country, state, fx_local_currency, temporal, calculation

Foreign exchange rates applied across H2GC datasets, available in both constant and current terms for USD and EUR.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=fx&country=Japan&limit=10"

Country statistics

Property	Value
metric	`country`
Granularity	`annual`
Metrics	`gdp_local_currency`, `gdp_usd`, `adult_population`, `inflation`

Dimensions: region, country, state, kpi, temporal, calculation

Country-level economic indicators including GDP, adult population, and inflation. These data points are useful for normalising gambling revenue against broader economic context.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=country&country=United+Kingdom&limit=10"

Country reference

Property	Value
metric	`country_reference`
Granularity	`snapshot`
Metrics	(none)

Dimensions: region, country, country_type

A reference table mapping countries to their respective regions and country types. This dataset contains no time dimension or numeric metrics — it returns dimension-only rows.

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=country_reference&limit=10"

Filtering dimensions

Each dataset documents its available dimensions in the catalog response. The table below lists the most common dimensions:

Dimension	Description	Example values
`region`	Geographic region	`Europe`, `Asia Pacific`, `Africa`
`country`	Country name	`United Kingdom`, `Japan`, `Brazil`
`state`	State/province (where applicable)	Empty string if not applicable
`category`	Gambling category	`Betting`, `Gaming`
`product`	Product type	`Sports Betting`, `Casino`, `Poker`
`channel`	Distribution channel	`Online`, `Land-Based`
`sub_channel`	Sub-channel classification	`Onshore`, `Offshore`
`fx`	Currency code	`USD`, `GBP`, `EUR`
`temporal`	Time classification	`Current`, `Constant`
`calculation`	Calculation method	`Reported`, `Estimated`

Any dimension may be used as a query parameter to filter the result set:

curl -H "x-api-key: sk_live_your_key" \
  "https://portal.h2gc.com/api/v1/financials?metric=ggr_annual&country=United+Kingdom&channel=Online&category=Betting"

On this page