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)
Granularities — supported time granularities (annual or monthly)
Dimensions — categorical fields available for filtering (e.g. country, channel)
Metrics — numeric values included in each row (e.g. ggr, turnover)

Annual datasets include year in the response data (integer). Monthly datasets include month_beginning (date string, e.g. 2024-01-01). To filter by date range, use the period query parameter (e.g. period=2024-01-01:2024-12-31).

Financial datasets

GGR (Gross Gaming Revenue)

Property	Value
metric	`ggr`
Granularities	`annual`, `monthly`
Metrics	`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://api.beta.h2gc.com/v1/financials?metric=ggr&granularity=annual&country=United+Kingdom&limit=10"

Turnover

Property	Value
metric	`turnover`
Granularities	`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://api.beta.h2gc.com/v1/financials?metric=turnover&granularity=annual&region=Europe&limit=10"

Property	Value
metric	`market_share`
Granularities	`annual`, `monthly`
Metrics	`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://api.beta.h2gc.com/v1/financials?metric=market_share&granularity=monthly&country=United+Kingdom&limit=10"

Reference datasets

FX rates

Property	Value
metric	`fx`
Granularities	`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://api.beta.h2gc.com/v1/financials?metric=fx&country=Japan&limit=10"

Country statistics

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

Dimensions: region, country, state, 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://api.beta.h2gc.com/v1/financials?metric=country&country=United+Kingdom&limit=10"

Reference endpoints

Reference datasets contain no time dimension or numeric metrics. They are served via the dedicated /v1/reference endpoint instead of /v1/financials.

Country reference

Property	Value
dataset	`country_reference`
Columns	`region`, `country`, `country_type`

A lookup table mapping countries to their respective regions and country types (e.g. Tracked, Amalgamated). Returns flat rows — no dimensions/values split.

curl -H "x-api-key: sk_live_your_key" \
  "https://api.beta.h2gc.com/v1/reference?dataset=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://api.beta.h2gc.com/v1/financials?metric=ggr&granularity=annual&country=United+Kingdom&channel=Online&category=Betting"

On this page