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
- Player account must be a–z / 0–9 only — no dashes or underscores (Spribe restriction).
- Currency lock — once a player places their first Aviator bet in USD, all future rounds must be USD for that account.
- Cash-out events arrive as a
wincallback withmultiplierfield (e.g.2.34x). - Free bets / free rounds use the
promo_winmethod — 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
refundmethod (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.
Related Guides & Insights
White Label Casino Games — How to Get a Full Slots Catalogue via One Contract
Launching an online casino requires a vast games library. Learn how white label casino games and API aggregation provide a full slots catalogue through a single contract, saving time and resources.
White Label Casino Reports: GGR, NGR & Player Analytics for MENA Operators
Unlock profitability in the MENA market with comprehensive white label casino reports. This guide breaks down GGR, NGR, and per-player analytics to help operators make data-driven decisions.
White Label Casino vs Turnkey Casino in Vietnam: Which Fits Your Budget?
Deciding between a White Label and a Turnkey casino model is critical for budget and control. This guide helps operators, especially in Vietnam, make the right choice for their iGaming venture.
Best White Label Casino Providers 2026: A Bangladesh Market Deep-Dive
Our expert B2B guide ranks the best white label casino providers for 2026. We analyse top vendors and provide a deep dive into launching a successful online casino in Bangladesh and other key markets.