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.

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.

Data Conventions

• External Keys - slug-style identifiers (nfl, nba) as an alternative to numeric IDs.

• Caching - how server-side caching works and its effect on polling.

• Versioning - API version stability and deprecation policies.

Security & Access

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