H2GC API

The H2GC Data API provides programmatic access to H2 Gambling Capital's industry datasets — GGR, turnover, market share, FX rates, and country-level economic indicators across global gambling markets.

It is a read-only JSON REST API with a single query pattern that works across all datasets. No SDK is required — any HTTP client is sufficient.

API Capabilities

The H2GC API gives you the ability to:

  • Query financial metrics — GGR, turnover, market share, and more across global markets
  • Filter by dimensions — region, country, channel, category, product, operator, and others
  • Choose granularity — annual or monthly views depending on the dataset
  • Paginate large result sets — cursor-based pagination for efficient data retrieval
  • Discover available data — the catalog endpoint lists all queryable datasets with their dimensions and metrics

Quick example

curl -H "x-api-key: sk_live_your_key_here" \
  "https://portal.h2gc.com/api/v1/financials?metric=ggr_annual&country=United+Kingdom&limit=5"
{
  "meta": {
    "dataset": "ggr_annual",
    "metric": "ggr_annual",
    "granularity": "annual",
    "filters_applied": { "country": ["United Kingdom"] },
    "row_count": 5
  },
  "data": [
    {
      "dimensions": {
        "region": "Europe",
        "country": "United Kingdom",
        "state": "",
        "category": "Betting",
        "product": "Sports Betting",
        "channel": "Online",
        "sub_channel": "Onshore",
        "fx": "GBP",
        "temporal": "Current",
        "calculation": "Reported",
        "year": 2020
      },
      "values": { "ggr": 3200000000 }
    }
  ],
  "pagination": {
    "cursor": "eyJvIjo1fQ",
    "has_more": true
  }
}

Getting started

On this page