For AI agents / Machine access

Data your agent can call.

Fixtures, live scores, grades and a market-implied consensus probability for MLB, NBA, NFL, college football, NHL, the English Premier League, the Bundesliga, LaLiga and the Champions League. Over REST with an API key, as tools over MCP, or paid per request in USDC with x402.

01 / No key

Try the sample.

The free sample answers without a key: one league, delayed, 10 fixtures.

Shell / no key

curl 'https://odds.halfpoint.tech/sample/odds?league=nba'
curl 'https://fixtures.halfpoint.tech/sample/fixtures?league=nba'

02 / Describe

Give your agent the spec.

Both API hosts serve an OpenAPI 3.0 description of every route, its parameters and errors, without a key.

https://odds.halfpoint.tech/openapi.json
https://docs.halfpoint.tech/llms.txt lists every documentation page as Markdown.

03 / Key

Get an API key.

A key works on both API hosts and gets what its plan includes. Subscribe with a card: Consensus USD 49, Realtime USD 249 or Risk USD 799 a month. Consensus and Realtime start with a 7-day trial. The key is shown once after checkout; save it. Send it as the X-Api-Key header.

To rotate the key or manage billing, log in at https://account.halfpoint.tech/login with a link sent to your email.

Get an API keyCompare the plans

04 / MCP

Connect over MCP.

An MCP server (streamable HTTP) at https://mcp.halfpoint.tech/ offers the same data as tools. Without a key, only get_sample and get_pass_options answer.

Tool	Returns	Key
`get_sample`	The free sample: odds or fixtures for one league	No
`get_pass_options`	The plans and their checkout links	No
`list_leagues`	The leagues served	Yes
`list_fixtures`	A league’s schedule on a date	Yes
`get_live`	Score, period and clock of the games being played	Yes
`get_consensus`	The consensus, of a league or one fixture	Yes
`get_bet_stop_status`	The bet-stop and widened state per market	Yes, Risk plan

MCP client config / JSON

{
  "mcpServers": {
    "halfpoint": {
      "type": "http",
      "url": "https://mcp.halfpoint.tech/",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Full setup and the errors to handle: agent documentation.

05 / No account

Pay per request with x402.

An agent with a wallet can pay in USDC with x402, without an account or key. Payments settle on Base (eip155:8453).

A request without a key to /odds, /fixtures, /live or /grades answers 402 with the payment requirements in the PAYMENT-REQUIRED header. Retry with PAYMENT-SIGNATURE (x402 version 2); the answer comes once the payment is settled. An x402 client library does this for you.

Route	Price per request (USD)
`/odds`	0.01, or 0.03 with ?plan=x402.risk
`/fixtures, /live, /grades`	0.002

For many calls or the stream, buy a pass: a plan for a period, with a key that is shown once and works until the period ends. A pass has no email login, so store its key.

Shell / buy a pass with an x402 client

POST https://account.halfpoint.tech/x402/pass?plan=realtime&period=24h

Plan	Period	Price (USD)
`realtime`	`24h`	15
`risk`	`24h`	49
`realtime`	`7d`	69

Paying for a request means accepting the terms of service. Details and errors: x402 documentation.

Your next reference point

Access the feed.

Get an API key Talk to us

Consensus and Risk for the sharp side of the market.