Developers
Racing OS Pro API
A structured, predictable API for deterministic race analytics. All endpoints return JSON. All requests are authenticated via Bearer token.
API Modules
| Module | Method | Path | Description |
|---|---|---|---|
| Auth | POST | /api/racing-os-pro/auth/wallet | Wallet and guest session authentication. |
| Engine | POST | /api/racing-os-pro/engine/all | Run all four analytical engines in a single call. |
| Formcard | POST | /api/racing-os-pro/formcard/jumps | Assemble a canonical jumps formcard. |
| Ledger | GET | /api/racing-os-pro/ledger/balance | Read current SWTT balance and plan. |
| Subscription | GET | /api/racing-os-pro/subscription/check | Check full subscription state. |
| Billing | GET | /api/racing-os-pro/billing/cycle | Read billing cycle data and manage plans. |
| SWTT | GET | /api/racing-os-pro/swtt/balance | Read-only on-chain SWTT state. |
| TAP | GET | /api/racing-os-pro/tap/session/:id | Session lookup and verification. |
| Diagnostics | GET | /api/racing-os-pro/diagnostics/wallet-session | Full session state for authenticated wallet. |
Authentication
All API requests (except the auth endpoints themselves) require a Bearer token in the Authorization header.
// Wallet authentication
POST /api/racing-os-pro/auth/wallet
// Guest session
POST /api/racing-os-pro/auth/guest
// Use the returned token
Authorization: Bearer <token>
Wallet sessions are linked to your real client account, plan, and SWTT balance. Guest sessions are tied to a fixed demo client and are suitable for exploration only.
Rate Limits
| Endpoint | Limit |
|---|---|
| SWTT Balance | 30 req/min per IP |
| SWTT Events | 20 req/min per IP |
| SWTT Info | 30 req/min per IP |
| SWTT Supply | 60 req/min per IP |
| All other endpoints | No hard limit (plan-gated by SWTT balance) |
Detailed documentation for specific modules: