Docs/Developer API

NowG Developer API

The NowG API lets you stream player behaviour into the platform and receive model outputs — cohort scores, tilt alerts and affiliate-quality signals — back as webhooks. It is a JSON/HTTPS API; every request is scoped to a single tenant by its bearer token. Base URL: https://api.nowg.net/v1.

Authentication

All requests use a bearer token scoped to one tenant. Generate and rotate keys from the dashboard under Settings → API. Send it in the Authorization header: Authorization: Bearer $KEY. Keys are environment-scoped (test / live) and never expire until rotated.

Rate limits

Ingestion is rate-limited to 500 requests/second per tenant, burstable to 1,000. Batches count as one request. When throttled you receive 429 with a Retry-After header — back off and retry; ingestion is idempotent, so replays are safe.

Player events

POST/v1/players/events

Stream real-time behavioural events so the models can score volatility appetite, tilt risk and cohort quality. Events are deduplicated by event_id.

player_id

string · required

Your PAM identifier for the player.

event_id

string · required

Idempotency key; duplicate ids are ignored.

type

enum · required

deposit | wager | withdrawal | session | bonus_claim.

amount

number

Value in account currency, where applicable.

string · ISO-8601

Event timestamp in UTC.

Batch import

Backfill history by POSTing an array of up to 1,000 events to /v1/players/events/batch. The response returns per-item accepted and deduped counts. Order does not matter — events are timestamped by ts, not arrival.

Deduplication

Every event carries an event_id you control. NowG stores it for 30 days; a repeat within that window is silently ignored (counted under deduped). This makes retries, at-least-once queues and replays completely safe.

Webhook: cohort scores

When the model rescoring a player completes, NowG POSTs a cohort.scored event to your webhook URL with volatility, tilt-risk and affiliate-quality scores (0–1). Register the URL under Settings → Webhooks.

Webhook: tilt alerts

A tilt.alert event fires when a player crosses your configured tilt threshold, carrying the recommended intervention (cooldown, limit prompt, no-bonus). Every alert is logged for audit under Compliance Guardian.

Webhook: postback setup

To feed affiliate-quality signals back to your tracker, add its postback URL under Settings → Integrations with the {click_id} and {quality_score} macros. NowG fires it server-to-server whenever a cohort score changes materially.

Prefer step-by-step help?

Task guides live in the Help Center.

Help Center →