Fathomytics API
Stats, ratings, weather and simulations for seven leagues over a JSON API. The API is private: access is by an API key issued by the Fathomytics team. Website accounts, free or Pro, don't include API access. To request a key, contact us with what you'd like to build.
Authentication
Send your key on every request: Authorization: Bearer fk_live_…. Keys are stored only as a hash; if one leaks, we rotate it.
Scopes
stats:read for stats and games; analytics:read for ratings, lineup impact, simulation results and season odds; simulations:run to start simulations.
Rate limits
Per key, per minute and per UTC day (default 120/min, 50,000/day), in X-RateLimit-* headers. A 429 includes Retry-After.
Quick start
curl https://<api-host>/api/v1/leagues/nfl/standings -H "Authorization: Bearer fk_live_…"
TypeScript SDK (@fathom/sdk)
import { FathomClient } from "@fathom/sdk";
const fathom = new FathomClient({ apiKey: process.env.FATHOM_API_KEY, baseUrl: "https://<api-host>" });
const { data, rateLimit } = await fathom.standings("nfl");
const run = await fathom.simulate({ gameId: "nfl-g2026_08_TEN_CIN", iterations: 10_000 });Every response is { data, meta, errors }; lists page with meta.next_cursor. The reference below has request samples in curl, JavaScript and Python for each endpoint. Raw spec: openapi.json. For information and entertainment only, not betting or financial advice.