Integrating Aviator Game API — Complete Technical Guide (2026)
Step-by-step technical guide to integrating the Spribe Aviator crash game via the AchaGaming unified casino API — endpoints, callbacks, RTP, and go-live checklist.
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 AchaGaming 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
```http POST https://api.achagaming.cloud/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:
```json { "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 AchaGaming 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 AchaGaming aggregator — you keep the remaining GGR minus your reseller commission. No monthly minimums.
Next Step
Open the **AchaGaming operator panel → API Docs → Aviator** and copy the ready-made cURL snippet. Full sandbox available at `test.achagaming.cloud` 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.
AchaGaming pricing explained
AchaGaming 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% AchaGaming 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.