Knowledge · Integration
Sportsbook API integration guide — feeds, bet placement, settlement
This guide explains how to integrate the AS Tech sportsbook: ingesting pre-match fixtures, subscribing to in-play odds, placing and settling bets, handling voids, cash-out and bet-builder.
Updated January 2025 · AS Tech iGaming editorial
Step 1 — Authenticate
Use the same HMAC-SHA256 signing as the casino API. REST calls sign per request; the WebSocket sends a single auth frame on connect.
Step 2 — Ingest pre-match
GET /v1/sportsbook/fixtures— paginated, by sport.GET /v1/sportsbook/markets?fixture_id=…— markets and odds.- Refresh every 1–5 minutes for pre-match.
Step 3 — Subscribe to in-play
Open one WebSocket per operator. Subscribe to fixture.{id} channels as players open them. Apply diff updates to your in-memory market book.
Step 4 — Place bets
Call POST /v1/sportsbook/bets with selections, stake, currency and price-tolerance policy. The sportsbook validates current odds and either accepts (returning bet_id and locked price) or rejects with a reason code.
Step 5 — Handle settlement
The sportsbook calls your POST /sportsbook/settle callback with bet ids, outcomes (win/lose/void/partial) and payouts. Credit winners, refund voids, and acknowledge.
Step 6 — Cash-out and bet-builder
Cash-out: poll GET /v1/sportsbook/bets/{id}/cashout for current offer, then POST to accept. Bet-builder: build the selection client-side, validate via POST /v1/sportsbook/builder/price before placing.
Frequently asked questions
Pre-match feed format?+
Pre-match fixtures and markets are delivered via paginated REST, refreshed every few minutes, with full snapshot and incremental diff endpoints.
Is the in-play feed WebSocket?+
Yes. In-play odds are pushed over a single authenticated WebSocket per operator, with sub-second updates for active markets.
What happens to bets when odds move?+
Each bet placement re-validates the current price; the operator can configure 'accept any price', 'accept better only', or 'reject on change' per market.
Are voided bets refunded automatically?+
Yes. When a market is voided by the trading desk, settlement returns 'void' and the operator refunds the original stake by transaction id.
Are cash-out and bet-builder supported?+
Cash-out is supported on most popular markets. Bet-builder (same-game multi) is supported on football, cricket and basketball.