🎉 Unified iGaming API v2.8 Live — 260+ Providers, Instant Seamless Wallet & Sub-45ms Turnaround! Explore API Docs →
Back to Articles / iGaming Insights
iGaming Insights

Integrating Aviator Game API — Complete Technical Guide (2026)

By NoviSoft Tech Team • 5 min read • Published October 01, 2024
Integrating Aviator Game API — Complete Technical Guide (2026)

Integrating the Aviator Game API — The Fast Path

Aviator by Spribe is the most-played crash game in the world. Instead of signing a direct contract with Spribe (KYC, minimum GGR, integration weeks), operators can launch Aviator in under 24 hours through the NoviSoft unified casino API.

Why Use an Aggregator for Aviator

  • One API key → Aviator + 6,000 other games (JILI, PG Soft, Pragmatic Play, Evolution).
  • No direct Spribe contract — we handle licensing and revenue-share.
  • Single wallet callback — no per-provider wallet integration.
  • Certified RTP 97% identical to the direct Spribe build.

Endpoint Reference

1. Launch Aviator

POST https://api.novisoft.us/functions/v1/game-api
Content-Type: application/json

{
  "method": "launchGame",
  "operator_code": "YOUR_OP_CODE",
  "sign": "<md5(operator_code + secret_key + timestamp)>",
  "timestamp": 1734567890,
  "member_account": "player001",
  "game_uid": "SPRIBE_AVIATOR",
  "currency_code": "USD",
  "language": "en"
}

Response returns { "code": 0, "payload": { "game_launch_url": "https://..." } }. Redirect the player to game_launch_url in an iframe or new tab.

2. Wallet Callback (getBalance / bet / win)

Your endpoint receives every Aviator round in real time:

{
  "method": "bet",
  "member_account": "player001",
  "amount": 5.00,
  "currency": "USD",
  "game_uid": "SPRIBE_AVIATOR",
  "round_id": "AV-9827364",
  "transaction_id": "tx-abc123"
}

Return { "code": 0, "balance": 145.50 } within 1500 ms or the bet is rolled back.

Aviator-Specific Rules

  1. Player account must be a–z / 0–9 only — no dashes or underscores (Spribe restriction).
  2. Currency lock — once a player places their first Aviator bet in USD, all future rounds must be USD for that account.
  3. Cash-out events arrive as a win callback with multiplier field (e.g. 2.34x).
  4. Free bets / free rounds use the promo_win method — credit without deducting a corresponding bet.

Go-Live Checklist

  • Whitelist your callback URL in the NoviSoft operator panel
  • Set your wallet endpoint to respond in < 1500 ms
  • Sanitize member_account (alphanumeric lowercase only)
  • Handle refund method (network timeouts trigger it)
  • Enable USD or your target Aviator currency in Operator → Currencies
  • Run 10 test rounds via Admin → Game Testing → SPRIBE_AVIATOR

Common Errors

Code Meaning Fix
8 Player account invalid Strip non-alphanumeric chars
15 Currency not supported Enable currency for operator
22 Insufficient balance Fund operator GGR wallet (min ₹100)
40 Duplicate transaction Return cached response, idempotent

Revenue

Spribe Aviator runs a provider-defined GGR provider fee inside the NoviSoft aggregator — you keep the remaining GGR minus your reseller commission. No monthly minimums.

Next Step

Open the NoviSoft operator panel → API Docs → Aviator and copy the ready-made cURL snippet. Full sandbox available at test.novisoft.us with sandbox test bets (capped at ₹20 per round for safety).

Integration time from signup to first live Aviator round: 4 hours on our reference PHP + Node.js implementations.

NoviSoft pricing explained

NoviSoft is a paid B2B service. The full API package costs $350 USD as a one-time payment. This package payment is separate from the ongoing revenue share of 10% of positive GGR. GGR means settled real-money bets minus settled real-money wins for the settlement period.

For an illustrative example, if settled bets are $10,000 and settled wins are $8,000, positive GGR is $2,000. The 10% NoviSoft revenue share would therefore be $200. This is a calculation example, not a revenue forecast. Hosting, licensing, payment processing, marketing, taxes and jurisdiction-specific compliance are separate operator responsibilities.

The live catalogue currently contains 141 active providers. Catalogue availability can change as studios or markets are added, paused or updated.