Skip to content

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.

Cookies

Cookies keep you signed in. Optional ones remember your settings. No ads or tracking. Cookie policy