# HalfPoint API

> Fixtures, live scores, venue mappings, grades and a market-implied consensus probability for MLB, NBA, NFL, college football, NHL, the Premier League, the Bundesliga, LaLiga and the Champions League. JSON over HTTPS with an API key (header X-Api-Key); a delayed free sample works without one. Every page below is Markdown.

- Free sample, no key: https://odds.halfpoint.tech/sample/odds?league=nba and https://fixtures.halfpoint.tech/sample/fixtures?league=nba
- OpenAPI 3.0, no key: https://odds.halfpoint.tech/openapi.json (one document for both hosts)
- Get a key (a page to confirm, then Stripe): https://account.halfpoint.tech/checkout?plan=consensus (or realtime, risk); USD 49, 249, 799 a month; Consensus and Realtime with a 7-day trial
- Pay without a key, with x402 v2 (USDC on Base): per request on /odds (USD 0.01; 0.03 with ?plan=x402.risk), /fixtures, /live, /grades (USD 0.002), or a pass (POST) at https://account.halfpoint.tech/x402/pass?plan=realtime&period=24h (USD 15; also realtime 7d 69, risk 24h 49)
- MCP server (streamable HTTP): https://mcp.halfpoint.tech/ (key as header X-Api-Key; get_sample and get_pass_options work without one)

## Start

- [For agents](https://docs.halfpoint.tech/agents.md): the sample, the OpenAPI description, getting a key, the MCP server and its tools, the errors to handle
- [Overview](https://docs.halfpoint.tech/index.md): endpoints, base URLs, the key
- [Plans](https://docs.halfpoint.tech/plans.md): prices, trial, what each plan includes, and the status codes of a key
- [After you pay](https://docs.halfpoint.tech/after-you-pay.md): the key shown once, logging in, rotating, a lost x402 pass key, when access ends

## Endpoints

- [Sample](https://docs.halfpoint.tech/endpoints/sample.md): /sample/odds and /sample/fixtures, without a key
- [Fixtures](https://docs.halfpoint.tech/endpoints/fixtures.md): the schedule of a league and date
- [Live](https://docs.halfpoint.tech/endpoints/live.md): score, period and clock of the games being played
- [Mappings](https://docs.halfpoint.tech/endpoints/mappings.md): each game's ids at the sources and venues
- [Grades](https://docs.halfpoint.tech/endpoints/grades.md): win, lose or push per outcome, after the game
- [One fixture](https://docs.halfpoint.tech/endpoints/fixture.md): everything about one fixture
- [Leagues](https://docs.halfpoint.tech/endpoints/leagues.md): the leagues served
- [Odds](https://docs.halfpoint.tech/endpoints/odds.md): the consensus, a market-implied probability per outcome
- [Live stream](https://docs.halfpoint.tech/endpoints/live-stream.md): live scores, pushed as they change (SSE)
- [Odds stream](https://docs.halfpoint.tech/endpoints/odds-stream.md): the same, pushed as it changes (SSE)

## Reference

- [Concepts](https://docs.halfpoint.tech/concepts.md): fixture ids, dates, statuses, postponements
- [Polling](https://docs.halfpoint.tech/polling.md): ETags and how often data changes
- [Errors](https://docs.halfpoint.tech/errors.md): status codes and the error body