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
metricquery parameter (e.g.ggr) - Dimensions — categorical fields available for filtering (e.g.
country,channel) - Metrics — numeric values included in each row (e.g.
ggr)
All financial datasets are served at annual resolution and include year in the
response data (integer). 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 |
| 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&country=United+Kingdom&limit=10"Reference datasets
FX rates
| Property | Value |
|---|---|
| metric | fx |
| 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 |
| 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&country=United+Kingdom&channel=Online&category=Betting"