Bet Placement and Settlement API

This section is intended for partners who accept sports bets in their own system, submit coupons to the SportAPI Coupon Settlement System, and receive their settlement results.

For a compact, single-file integration guide, see the Quick Integration Guide. It covers the main integration flow and all critical rules, while the remaining pages explain individual topics in detail.

Overview

• Documentation overview
• Quick integration

Getting started

• API overview
• Quick start
• Authentication
• Common API conventions

Bet placement

• Bet pointer
• Coupon placement
• Singles, accumulators, and multi
• Odds changes

Settlement

• Settlement lifecycle
• Statuses and payouts
• Result callbacks
• Callback signature
• Retries and idempotency
• Polling fallback

Coupons

• Retrieving a coupon
• Querying coupon results
• Active and settled coupons
• Coupon and bet model
• Cashout

Guides

• Single-bet integration
• Accumulator integration
• Missed callback recovery

Reference

• Endpoint reference
• API response format
• Error codes
• Migrating from the legacy API
• Compatible legacy routes
• Glossary
• Changelog

Examples

• Examples overview
• cURL
• JavaScript for Node.js
• PHP
• Python
• Callback and HMAC verification
• Full JSON responses

How this documentation is organized

• The main integration flow uses the recommended /api/partner/** endpoints.
• Legacy endpoints are mentioned next to their replacements only in brief notes and are not mixed into the main integration flow.
• Everything required to update an existing integration is collected in the standalone Migrating from the old API guide.
• Each API method includes its purpose, request format, field descriptions, successful response, errors, and handling recommendations.
• All identifiers, statuses, and fields must match the current OpenAPI contract.
• Unconfirmed information is not presented as guaranteed behavior.

Current sources

• Client API OpenAPI specification, version 1.2.0.
• Materials from docs/info.
• Legacy integration guide old_api_calc.txt.

Editorial working notes are stored in _work and are not part of the public documentation.