The hosted base URL is https://api.oddswire.io. REST endpoints are versioned under /v1. Use the developer docs for the current contract.
Authenticate safely
Load your own account-owned key from private secret configuration and send exactly one X-API-Key header. Do not put keys in URLs or browser code. Do not combine a data key with a workspace session token.
Check access first
Call GET /v1/account/entitlements. This is free. Use only namespaces and features returned for your account; empty scope is normal for a new workspace. Check Usage for any required allocation.
Discover, then request odds
Use fixture discovery in an approved namespace, then preserve the returned fixture ID for the odds request in that same namespace. Canonical odds requires a fixture or competition filter. Bookmaker filters use source/region IDs, not guessed brand slugs.
Read data, every missing[] entry and meta together. Preserve decimal strings and original timestamps. Canonical successful data pages cost one credit, including empty pages; control reads are free.
Use the cURL, Python or TypeScript quick start. Make retries and pagination explicit, particularly after uncertain delivery.