Kobow Lotto/ API
API · v0.9 · April 2026
All systems operational · uptime 99.98%

One JSON surface. Every Kobow Lotto product.

GAIN draws, Intelligence regulatory scans, Insights cohort models, Studio asset generation and Engine promotional orchestration — all exposed as a single OAuth 2.0 + mTLS JSON API. Reference implementations available for OLG, BCLC, WCLC, Loto-Québec and ALC data standards.

PT: Uma única superfície JSON para todos os produtos Kobow Lotto — sorteios GAIN, escaneamentos regulatórios Intelligence, modelos de coorte Insights, geração de ativos Studio e orquestração promocional Engine. OAuth 2.0 + mTLS. Implementações de referência para padrões de dados OLG, BCLC, WCLC, Loto-Québec e ALC.

# Fetch a GAIN-shuffled pool for a weekly draw, n=7, range 1-49 POST https://api.kobowlotto.com/v0/gain/shuffle Authorization: Bearer $KOBOW_API_KEY Content-Type: application/json { "pool": { "min": 1, "max": 49 }, "draw": { "n": 7, "unique": true }, "seed": { "mode": "nist-beacon+crown-salt", "jurisdiction": "ca-on" } } → 200 OK { "draw_id": "gain_2026_04_17_on_1142", "numbers": [4, 11, 18, 27, 33, 41, 47], "entropy_bits": 512, "audit_hash": "sha256:8f2e…d41a", "gli_certified": true, "regulator_trail": "agco/ca-on/2026-04-17T18:11:03Z" }
API surface

Five products. One base URL.

Each product ships as a versioned module under api.kobowlotto.com/v0/. Auth, rate limiting and audit trail are shared. Schemas published in OpenAPI 3.1 and signed with cosign.

GAIN · draws & RNG

Certified random number generation.

Certified RNG shuffle with NIST beacon salt, per-jurisdiction entropy policy and GLI-19 / GLI-33 audit trail. Reference integrations with WCLC Lotto 6/49, OLG LOTTO MAX and BCLC PlayNow draws.

POST/v0/gain/shuffle
GET/v0/gain/draw/:draw_id/audit
Intelligence · regulatory

Twelve+ regulator feed scans, reconciled.

Live scans of AGCO, AGLC, BCLC, iGO, WCLC consortium, Loto-Québec RACJ and Atlantic ALC regulators with diff-detection, legal-copy compression analysis and bilingual parity scoring.

GET/v0/intel/regulators
GET/v0/intel/diff?since=2026-04-01
Insights · cohort models

LTV, churn, bonus-abuse, and migration.

Cohort-decomposed LTV, churn and bonus-abuse models trained on anonymised Crown lottery & iGaming panels. Migration models for iCasino cannibalisation projections (e.g., the Ontario iGO thesis).

POST/v0/insights/ltv
POST/v0/insights/migration
Studio · assets

Regulated-copy creative pipeline.

Generate EN/FR bilingual creative respecting the 60–72% French compression rule, with jurisdiction-specific legal copy auto-attached, and output to print-ready paper, POSD, digital and terminal formats.

POST/v0/studio/render
GET/v0/studio/formats
Engine · orchestration

Promotional orchestration, compliance-first.

Schedule and orchestrate cross-product promotions with compliance pre-flight, rate limits per jurisdiction and automatic bilingual split. 48-hour creative cycle, not 2–3 weeks.

POST/v0/engine/campaign
GET/v0/engine/campaign/:id/status
Meta · ops

Status, audit, billing.

Operational endpoints: per-endpoint health, monthly audit export (SOC 2 / ISO 27001 compatible), billing usage summaries. Status page at /health.

GET/health
GET/v0/audit/export?month=2026-04
Auth & rate limits

OAuth 2.0 + mTLS. Per-jurisdiction rate ceilings.

Every Kobow Lotto API client authenticates with OAuth 2.0 client-credentials, mutual TLS for production draw endpoints, and HMAC-signed request bodies on all POST endpoints. Rate limits are applied per-jurisdiction, so a UKGC surge doesn't starve your OLG flow.

EnvironmentBase URLAuthRate ceiling
Sandboxapi.kobowlotto.com/sandbox/v0OAuth 2.060 rpm
Stagingapi.kobowlotto.com/staging/v0OAuth 2.0 + HMAC300 rpm
Production (non-draw)api.kobowlotto.com/v0OAuth 2.0 + mTLSPer contract
Production (draws)api.kobowlotto.com/v0/gainOAuth + mTLS + HSM sigPer Crown policy
SDKs

Language bindings.

Node / TS

@kobowlotto/sdk

npm i @kobowlotto/sdk

Python

kobowlotto

pip install kobowlotto

Go

kobowlotto-go

go get github.com/kobowlotto/sdk-go

Java · JVM

com.kobowlotto:sdk

Maven / Gradle