Data models

This page details the technical specifications for the Gamgem dataset, including data models, file formats, and distribution mechanisms. The dataset uses a structured schema approach to organize gambling platform information for seamless integration with banking systems.

The Gamgem dataset organizes gambling platform data into several entities that represent different payment destinations:

Platform

Gambling websites and applications with identifying information like platform name, services offered (casino, betting), and primary website URL. These serve as the parent entities that tie together all payment methods for a specific gambling operator.

Merchant

Card payment processing details for platforms, including merchant data that appear in authorization requests and show up on card statements. This data enables blocking of card transactions to known gambling processors.

BankAccount

Bank transfer details for platforms, including account numbers (local and IBANs), bank codes (BICs, UK sort codes, ABA routing numbers, etc.), and account holder information. This data enables blocking of direct bank transfers and open banking payments to gambling-controlled accounts.

CryptoWallet

Cryptocurrency payment details for platforms, including wallet addresses across various blockchain networks. This data enables blocking of cryptocurrency transactions to gambling-controlled wallets.

Each Merchant, BankAccount, and CryptoWallet entity references its associated Platform entity, allowing you to understand the complete payment destination landscape for any gambling operator.

Common structure

All entities in the Gamgem dataset follow a consistent structure with common metadata fields and entity-specific attributes.

{
  "id": "01931b08-efc8-49bf-85d1-b80da3bed482",
  "schema": "ENTITY_TYPE",
  "createdDate": "2025-01-19T13:51:56.793Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    // Entity-specific attributes
  }
}

string

required

Unique UUID identifier for the entity

schema

enum<string>

required

Entity type identifier: PLATFORM, MERCHANT, BANK_ACCOUNT, or CRYPTO_WALLET

createdDate

timestamp

required

ISO 8601 timestamp when the entity was first identified

updatedDate

timestamp

required

ISO 8601 timestamp of the most recent update to this entity

state

enum<string>

required

Current operational status: ACTIVE or OBSOLETE

attributes

object

required

Entity-specific data, varies by schema type (detailed below)

Entity-specific attributes

The attributes object contains different fields depending on the entity type:

Represents gambling platforms and their core attributes.

{
  "id": "5c3ecbde-2fcc-4175-b0c2-5a95ca020a23",
  "schema": "PLATFORM",
  "createdDate": "2025-01-19T13:51:56.793Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    "name": "Mystake Casino",
    "services": ["CASINO"],
    "url": "https://mystake.com"
  }
}

attributes.name

string

required

Display name of the gambling platform

attributes.services

enum<string>[]

required

Types of gambling services offered. Possible values: CASINO, BETTING, POKER, LOTTERY, BINGO

attributes.url

string

required

Primary website URL for the gambling platform

Represents gambling platforms and their core attributes.

{
  "id": "5c3ecbde-2fcc-4175-b0c2-5a95ca020a23",
  "schema": "PLATFORM",
  "createdDate": "2025-01-19T13:51:56.793Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    "name": "Mystake Casino",
    "services": ["CASINO"],
    "url": "https://mystake.com"
  }
}

attributes.name

string

required

Display name of the gambling platform

attributes.services

enum<string>[]

required

Types of gambling services offered. Possible values: CASINO, BETTING, POKER, LOTTERY, BINGO

attributes.url

string

required

Primary website URL for the gambling platform

Represents card payment processing details for platforms.

{
  "id": "7d4f8e2a-1b3c-4d5e-6f7g-8h9i0j1k2l3m",
  "schema": "MERCHANT",
  "createdDate": "2025-02-01T10:15:30.000Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    "platformId": "5c3ecbde-2fcc-4175-b0c2-5a95ca020a23",
    "type": "NFT_PLATFORM",
    "mid": "123456789012345",
    "name": "finnart.io",
    "mcc": "6051",
  }
}

attributes.platformId

string

required

UUID reference to the associated Platform entity

attributes.type

enum<string>

required

Merchant processing category used to obfuscate gambling transactions:

EWALLET: Electronic wallet services
CRYPTO_ON_RAMP: Cryptocurrency on-ramp services
DIGITAL_GOODS: Generic digital goods merchants
NFT_PLATFORM: NFT platform merchants
UNKNOWN: Unclassified merchant

attributes.mid

string

required

Merchant ID also known as Card Acceptor Identificaiton (DE042 of an ISO 8583 authorization request)

attributes.name

string

required

Merchant name also known as Card Acceptor Name (DE043 of an ISO 8583 authorization request)

attributes.mcc

string

required

Merchant category code also known as Merchant Type (DE018 of an ISO 8583 authorization request)

Represents bank transfer details for platforms.

{
  "id": "9a8b7c6d-5e4f-3g2h-1i0j-9k8l7m6n5o4p",
  "schema": "BANK_ACCOUNT",
  "createdDate": "2025-02-15T14:20:45.000Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    "platformId": "5c3ecbde-2fcc-4175-b0c2-5a95ca020a23",
    "bankId": "009956",
    "bankIdType": "GBDSC",
    "accountId": "78073383",
    "accountIdType": "ACCOUNT_NUMBER",
    "accountHolderName": "Santeda International Limited"
  }
}

attributes.platformId

string

required

UUID reference to the associated Platform entity

attributes.bankId

string

Bank routing identifier (optional for some account types)

attributes.bankIdType

enum<string>

Format of the bank identifier:

BIC: Bank Identifier Code (SWIFT)
GBDSC: UK Sort Code (6 digits)
USABA: US ABA Routing Number (9 digits)

attributes.accountId

string

required

Bank account identifier

attributes.accountIdType

enum<string>

required

Types of the account identifier:

IBAN: International bank account number
ACCOUNT_NUMBER: Local account number

Represents cryptocurrency payment details for platforms.

{
  "id": "2f3g4h5i-6j7k-8l9m-0n1o-2p3q4r5s6t7u",
  "schema": "CRYPTO_WALLET",
  "createdDate": "2025-02-20T16:45:12.000Z",
  "updatedDate": "2025-03-06T21:33:04.559Z",
  "state": "ACTIVE",
  "attributes": {
    "platformId": "5c3ecbde-2fcc-4175-b0c2-5a95ca020a23",
    "network": "BITCOIN",
    "address": "1L6c1aVMGQJtuuTFpLCTKteUm73XASLMYj"
  }
}

attributes.platformId

string

required

UUID reference to the associated Platform entity

attributes.network

enum<string>

required

Possible values: [BITCOIN,RIPPLE, BITCOINCASH, LITECOIN, ETHEREUM, DOGECOIN, CARDANO, STELLAR, POLKADOT, SOLANA, AVALANCHE, EOS, TEZOS, DASH, ALGORAND, CELO, SMARTCHAIN, POLYGON, FANTOM, OPTIMISM, COSMOS, KUSAMA, ETHEREUMCLASSIC, ETHEREUMPOW, HEDERAHASHGRAPH, TRON, KAVA, NEAR, SONGBIRD, FLARE, CELESTIA, BASE]

attributes.address

string

required

Cryptocurrency wallet address in the network’s native format

Get Started

Payment Preparation

Beneficiary Hub

Gamgem

Webhooks

Platform

Merchant

BankAccount

CryptoWallet

Common structure

Entity-specific attributes

Get Started

Payment Preparation

Beneficiary Hub

Gamgem

Webhooks

Platform

Merchant

BankAccount

CryptoWallet

​Common structure

​Entity-specific attributes

Common structure

Entity-specific attributes