Guides

These guides cover the concepts and conventions you'll encounter while working with the Odditt B2B API. If you're looking for a hands-on walkthrough with code examples, start with the Getting Started tutorial in the API Reference section. New to the vocabulary? The Glossary defines every term these docs use, in plain English.

Integration Essentials

• Rate Limiting - request limits per minute, hour, and day, and how to handle 429 responses.
• Pagination - navigating paginated results with page and page_size.
• Filtering & Query Parameters - entity filters, flow types, thresholds, operators, and date ranges.
• Response Format & Error Handling - JSON response conventions, HTTP status codes, and common error scenarios.

Discovery & Content

• League Coverage - the sports and leagues currently active in the API.
• Segmentation & Tags - discover the tag registry and filter flows by content and metadata tags.
• Affiliate API - the cart, offers, link inventory, and reporting endpoints behind the widget's affiliate mode.

Data Conventions

• Glossary - every term these docs use, defined in plain English.
• Localization - get trend narratives in Spanish (Latin America), Italian, or Brazilian Portuguese.
• Caching - how server-side caching works and its effect on polling.
• Versioning - API version stability and deprecation policies.

The Widget

The embeddable widget has its own section of guides. Start with the Widget Overview for flow types and layouts, then:

• Widget Modes - what a tap does: operator handoff or affiliate cart.
• Product Modes - sportsbook, DFS, or prediction-market rendering.
• Playground and Presets - design a theme with a live preview, then deploy it as a preset.
• Iframe Parameters - every parameter an embed accepts.
• Widget Events - the postMessage events your page can listen for.
• Live Scores & Realtime - streaming odds updates and in-play game state.
• Integration Recipes - production wiring: theme/language sync, empty and error handling.
• Testing & Simulation - induce every error and empty state on demand to verify your handlers before launch.
• Mobile SDKs - Flutter, React Native, iOS, and Android wrappers.

The widget section also carries per-card anatomy references (fact flow, fun flow, and parlay variants) that map every visual element on a card to its API field.

Security & Access

• Advanced Authentication - JWT tokens, OAuth2 client credentials, and refresh flows.
• Account Management - credentials, secrets, and usage stats.

Client Libraries

Official open-source API clients in eleven languages (TypeScript, Python, Go, Java, Kotlin, Swift, Dart, Ruby, PHP, Rust, Elixir) live on github.com/Odditt-Betflow - see Getting Started. Building a mobile app around the hosted widget instead? That's the Mobile SDKs.